Skip to main content
POST
Create a Dojo sim session and begin the runner ("Begin Sim").

Authorizations

Authorization
string
header
required

Supabase JWT token in Authorization: Bearer header

Body

application/json
agent_id
string
required

Prod agent id to spar (the runner resolves its compute key server-side).

scenario_id
string
required

dojo_scenarios.id (e.g. 'db-shepherd').

mode
enum<string>
default:auto
Available options:
auto,
manual
max_turns
integer
Required range: x >= 1
reviewer_kind
enum<string>
default:builtin_opus

The review policy for this run's Safe House review-holds (Wave 4 §13). 'builtin_opus' (default) resolves synchronously; 'human' routes a hold to the human-tier resolve endpoint. Assigns the sim agent to the corresponding STANDING, non-weakenable team-scope review-policy team before the run starts — this is owner-authoritative policy, never a per-agent card upsert the agent could weaken.

Available options:
builtin_opus,
human
capture_payloads
boolean
default:false

Mnemom-staff only: arm raw-payload capture for the debug export BEFORE the run starts, so payloads are captured from turn 1 (MNE-923). Honored only when the caller is a platform admin (capture is staff-only); ignored otherwise.

Response

Session created and runner started.

session_id
string<uuid>
required
agent_id
string
required
scenario_id
string
required
mode
enum<string>
required
Available options:
auto,
manual
state
string
required