Agent runs API

Inspect durable agent runs. Run state is managed by the agent service.

Use API authentication for protected requests. Examples use your own resource IDs and a temporary token; saved response examples are synthetic.

Method	Path	Operation
`GET`	`/v1/agent_run`	List agent runs
`GET`	`/v1/agent_run/{id}`	Get agent run

List agent runs

GET /v1/agent_run

Returns a paginated list of AgentRun

Authentication: bearer token and the team header shown below.

Parameters

Name	Location	Required	Description
`X-Tenant-ID`	header	yes	Active team ID. Must match the tenant bound to a diagnostic token.
`page`	query	no	Page number
`per_page`	query	no	Items per page

Request example

Set ADIOS_API_URL=https://api.adios.dev. For protected requests, set ADIOS_ACCESS_TOKEN and ADIOS_TEAM_ID as in the quickstart. Set any additional ADIOS_* variables from your own resource results.

curl --fail-with-body --request GET "$ADIOS_API_URL/v1/agent_run" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Response: HTTP 200

List of AgentRun

Response fields

Field	Type	Description
`data`	array
`data[].action_digest`	string
`data[].agent_binding_id`	string
`data[].agent_binding_revision_id`	string
`data[].agent_definition_id`	string
`data[].agent_draft_id`	string
`data[].agent_draft_revision`	integer
`data[].agent_kit_content_digest`	string
`data[].agent_kit_entrypoint`	string
`data[].agent_kit_function`	string
`data[].agent_kit_version_id`	string
`data[].agent_run_id`	string
`data[].agent_session_id`	string
`data[].agent_suite_id`	string
`data[].agent_suite_version_id`	string
`data[].agent_version_digest`	string
`data[].agent_version_id`	string
`data[].agent_work_cycle_id`	string
`data[].approval_id`	string
`data[].base_sha`	string
`data[].branch`	string
`data[].budget_cost_micros`	integer
`data[].budget_tokens`	integer
`data[].cached_tokens`	integer
`data[].company_project_id`	string
`data[].completed_at`	integer	(Unix timestamp)
`data[].created_at`	integer	(Unix timestamp)
`data[].deleted_at`	integer	(Unix timestamp)
`data[].effective_policy`	object
`data[].effective_policy_digest`	string
`data[].environment_checkpoint_id`	string
`data[].error`	object
`data[].estimated_cost_micros`	integer
`data[].execution_id`	string
`data[].execution_task_id`	string
`data[].head_sha`	string
`data[].idempotency_key`	string
`data[].input_tokens`	integer
`data[].last_activity_at`	integer	(Unix timestamp)
`data[].lead_agent_run_id`	string
`data[].metadata`	object
`data[].mode`	string	Allowed: build, debug, ops, review, chat, background.
`data[].model`	string
`data[].output_tokens`	integer
`data[].owner_id`	string
`data[].parent_agent_run_id`	string
`data[].preset`	string	Allowed: security_review, code_review, verify_changes, engineering_review, finding_fix.
`data[].provider`	string
`data[].read_only`	boolean
`data[].retention_class`	string	Allowed: ephemeral, standard, extended, compliance.
`data[].role_key`	string
`data[].source`	string	Allowed: app, slack, cli, workflow, event, schedule, system.
`data[].source_snapshot_digest`	string
`data[].specialist_role`	string	Allowed: lead, security, code_quality, test_verification.
`data[].started_at`	integer	(Unix timestamp)
`data[].status`	string	Allowed: pending, running, blocked, cancelling, complete, failed, cancelled.
`data[].step_count`	integer
`data[].structured_outcome`	object
`data[].suite_node_key`	string
`data[].suite_profile`	string
`data[].summary`	object
`data[].target_kind`	string	Allowed: standalone, browser, workspace, workload, project, company_project, repository, pull_request, finding, custom.
`data[].target_ref`	string
`data[].team_id`	string
`data[].tool_call_count`	integer
`data[].tool_scope`	object
`data[].trace_id`	string
`data[].trigger_principal_id`	string
`data[].trigger_ref`	string
`data[].trigger_type`	string	Allowed: manual, draft_test, pre_merge, schedule, event, workflow, compatibility, approval.
`data[].updated_at`	integer	(Unix timestamp)
`pagination`	object
`pagination.page`	integer	Current page number
`pagination.per_page`	integer	Number of items per page
`pagination.total`	integer	Total number of items

The schema-derived collection illustration is omitted here because it does not satisfy the published response schema. Use the field contract above.

Get agent run

GET /v1/agent_run/{id}

Returns a single AgentRun

Set agent_run_id using IDs from your own API responses.