latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-136188852.7 MB

9cd7291d4228

simulation_runs

List simulation runs

Live operational data — always revalidate; do not rely on a client-side cache. Follow next_cursor to page; cursors stay valid across concurrent writes.

get/v1/simulation/runs

Query parameters

status'pending' | 'running' | 'completed' | 'failed' | 'cancelled' | 'budget_exceeded'
agent_idstring uuid nullable
channel'text' | 'voice'

Filter by run modality (text or voice).

qstring nullable

Case-insensitive substring match on the agent, persona and scenario names, plus the run id (exact UUID, or an 8+ character id prefix). Names are matched against the current persona/scenario/agent records, while each row displays the names frozen at dispatch time, so a renamed entity is found by its new name.

Case-insensitive substring match on the agent, persona and scenario names, plus the run id (exact UUID, or an 8+ character id prefix). Names are matched against the current persona/scenario/agent records, while each row displays the names frozen at dispatch time, so a renamed entity is found by its new name.

limitinteger
cursorstring nullable

Response

Successful Response

next_cursorstring nullable
has_moreboolean required