roasOS
API referenceAgent

Get agent run status

The light poll: the run id, its status, and when it last changed.

GET
/v1/agent-runs/{id}/status

The light poll: the run id, its status, and when it last changed.

Authorization

bearerAuth
AuthorizationBearer <token>

API key authentication. Use your API key as the bearer token: Authorization: Bearer roasos_sk_...

In: header

Path Parameters

id*string
Formatuuid

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/agent-runs/497f6eca-6276-4993-bfeb-53cbbbba6f08/status"
{  "data": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "status": "quoted",    "updated_at": "2019-08-24T14:15:22Z"  }}

Get an agent run

Read one run: what started it, its caps, the approvals it is waiting on, and — once it is terminal — what it cost. Every brain run is read here: an ask, a skill run, a routine run.

Get an agent run result

What the agent answered, the thread it wrote it in, and what the run cost. A run that is not terminal answers 409 run_not_completed.