5a5597ebb2d6

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-126178842.7 MB
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