Retrieve a session
sessions:readAuthorizations
Your ara_ API key from Settings > Ara API. Keys are capability-scoped: run, plugins:read, secrets:read, secrets:write, sessions:read, knowledge:read, repos:read, repos:write, reviews:read, reviews:write, analytics:read, org:read, org:write, attachments:read, attachments:write, plugins:write, guardrails:read, guardrails:write.
Path Parameters
Organization id or slug. Resolve it with GET /v3/self.
The session id.
Response
The session.
running, exit (completed), error, or suspended (cancelled/quota).
running, exit, error, suspended Web URL to watch the session.
Source-control provider for the session repository.
github, gitlab Concrete model selected for this session, or null when inherited.
Total model spend in USD across the session's turns. Null when usage was never reported.
Token usage totals for the session. Fields are null for runs that predate usage persistence.
Live context occupancy after the latest turn (not billing throughput).
Always null (no session hierarchy).
Always empty (no session hierarchy).
Always false.

