Api / Requests

GET/v1/requests/:id

Auth: tenant — Status: stable

Fetch one orchestrate run's status. Tenant-scoped: a leaked id never surfaces another tenant's row.

Request

curl -H "Authorization: Bearer atr_…" \
     http://arbiter.example.com/v1/requests/a1b2c3d4e5f60718

Response

200 OK

{
  "request": {
    "request_id": "a1b2c3d4e5f60718",
    "agent_id": "research",
    "conversation_id": 7,
    "state": "running",
    "started_at": 1746810000,
    "completed_at": 0,
    "error_message": "",
    "last_seq": 38
  }
}

last_seq is useful as the since_seq argument to GET/v1/requests/:id/events when reconnecting.

Failure modes

StatusWhen
401Missing / invalid bearer.
404Request not found for this tenant.

See also