v1

latestOpenAPI 3.0.32026-07-222111928.0 KB
Runs

List Runs

List runs for the current team. Supports filtering by agent, user, queue, status, etc. Messages, evaluation data, and queue metadata are included where available.

get/v2/teams/{teamId}/runs

Path parameters

teamIdstring required

Query parameters

limitnumber

Number of runs per page (1-100, default 20)

offsetnumber

Number of runs to skip

sort_by'created_at'

Field to sort by (default created_at)

sort_order'asc' | 'desc'

Sort direction (default desc)

status'not_started' | 'pending' | 'starting' | 'running' | 'waiting' | 'completed' | 'failed' | 'interrupted' | 'stopped' | 'needs_attention'

Filter to runs with this status

agent_idstring uuid

Filter to runs for this agent

user_idstring uuid

Filter to runs owned by this user; non-superadmin callers are scoped to themselves regardless of this value

case_queue_idstring uuid

Filter to runs associated with this queue

sourcestring

Filter to runs created from this source (e.g. api, schedule)

searchstring

Full-text search across run titles and case titles

has_issues'true' | 'false'

If true, only return runs that have evaluation issues

issue_severity'critical' | 'medium' | 'low'

If set, only return runs whose latest successful evaluation has at least one failing rubric with this severity (critical | medium | low). Implies has_issues; legacy evaluations without severity companion fields do not match this filter.

sincestring date-time
digest_idstring uuid

Response

Default Response

totalnumber required