Sirius Docs
API Reference
Agent Runs

List agent runs

GET
/v1/agent/runs

Returns your agent runs, most recent first.

Authorization

bearerAuth
AuthorizationBearer <token>

Pass your API key in the Authorization header: Authorization: Bearer sirius_sk_....

In: header

Query Parameters

status?string

Only return runs with this status.

Value in

  • "queued"
  • "running"
  • "awaiting_approval"
  • "succeeded"
  • "failed"
  • "canceled"
limit?integer

Maximum number of runs to return.

Range1 <= value <= 100
Default20
cursor?string

Pagination cursor from a previous response.

Response Body

application/json

application/json

curl -X GET "https://example.com/v1/agent/runs"
{  "data": [    {      "id": "run_01j9x6q8ftq",      "status": "queued",      "input": "string",      "output": "string",      "error": "string",      "pending_approvals": [        {          "id": "apr_01j9x7v2m3",          "action": "Send email to 1,204 recipients",          "status": "pending",          "requested_at": "2019-08-24T14:15:22Z",          "resolved_at": "2019-08-24T14:15:22Z"        }      ],      "metadata": {        "property1": "string",        "property2": "string"      },      "created_at": "2019-08-24T14:15:22Z",      "completed_at": "2019-08-24T14:15:22Z"    }  ],  "next_cursor": "string"}
{  "error": {    "code": "invalid_request",    "message": "string"  }}

Get an agent run GET

Returns the current state of a run, including its output once the run has finished and any approval currently blocking it.

Resolve an approval POST

Approves or denies a pending approval request. Runs that perform sensitive actions pause with status `awaiting_approval` until every pending approval is resolved.