Sirius DocsInternal
API Reference
Agent Runs

Get an agent run

GET
/v1/agent/runs/{run_id}

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

Authorization

bearerAuth
AuthorizationBearer <token>

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

In: header

Path Parameters

run_id*string

Identifier of the agent run.

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v1/agent/runs/run_01j9x6q8ftq"
{  "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"}
{  "error": {    "code": "invalid_request",    "message": "string"  }}
{  "error": {    "code": "invalid_request",    "message": "string"  }}

Create an agent run POST

Starts a new run of the Hermes Managed Agent. A run is asynchronous: the response returns immediately with status `queued`. Poll [Get an agent run](#operation/getAgentRun) until the run reaches a terminal state (`succeeded`, `failed` or `canceled`).

List agent runs GET

Returns your agent runs, most recent first.