Skip to main content
GET
List runs

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Query Parameters

limit
integer
default:100

Maximum number of runs to return.

Response

Successful Response

id
string
required

Unique ID for this run record.

correlation_id
string
required

ID shared with the live run, used for polling while it runs.

owner_id
string
required

Keycloak username of the user who started the run.

status
enum<string>
required

State of the run: pending, running, completed, or failed.

Available options:
pending,
running,
completed,
failed
created_at
string
required

Creation time of the run. Represented as an ISO 8601 timestamp.

crew_type
string | null

Preset crew type, or null for a custom crew.

crew_config
CrewConfig · object | null

The crew definition that ran. Null if parsing failed.

task_input
Task Input · object | null

This run's task input.

result
string | null

The crew's output, present only on a successful run.

error
string | null

The failure reason, present only on a failed run.

started_at
string | null

Time the run started executing. Represented as an ISO 8601 timestamp. Null before it starts.

completed_at
string | null

Time the run finished. Represented as an ISO 8601 timestamp. Null while it still runs.

parent_run_id
string | null

The run this one restarted, when run_trigger is replay. Null otherwise.

replayed_from_task
integer | null

The task index a replay started at. Null for other runs.

schedule_id
string | null

The crew schedule that started this run. Null for a run started directly.

run_trigger
string | null

What started the run: api, chat, schedule (a cron slot) or run_now. Null for runs from before this was recorded.

template_id
string | null

The crew template the run came from, if any.

resolved_pins
Resolved Pins · object | null

Registry artifact id to the exact version that ran.

template_name
string | null

The crew template's name, if it came from one that still exists.

run_as
string | null

Who the run acted as, when that isn't owner_id: a service identity's service account.

run_as_kind
string | null

identity for a service identity; null for the owner.