Skip to main content
POST
Dispatch a simulation suite run (fan-out per item)

Authorizations

x-api-key
string
header
required

Path Parameters

suite_id
string<uuid>
required

Body

application/json

Request body for POST /v1/sim-suites/{suite_id}/runs.

suite_id is taken from the path. The orchestrator fans the suite out into one SimulationRun per item, all pinned to the same agent/revision.

agent_id
string<uuid>
required
agent_revision_id
string<uuid> | null
channel
enum<string>
default:voice
Available options:
text,
voice
tool_overrides
Tool Overrides · object | null
budget_usd
Required range: x >= 0
idempotency_key
string | null
Required string length: 1 - 128

Response

Successful Response

id
string<uuid>
required
organization_id
string<uuid>
required
suite_id
string<uuid>
required
agent_id
string<uuid>
required
agent_revision_id
string<uuid> | null
required
created_by
string | null
required
created_at
string<date-time>
required
status
string
required
idempotency_key
string | null
runs
SimulationRunResponse · object[]
release_eval_status
string | null
release_eval_verdict
ReleaseVerdict · object | null
release_eval_completed_at
string<date-time> | null
release_eval_error
string | null