Skip to main content
GET
Retrieve a session

Authorizations

Authorization
string
header
required

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

orgId
string
required

Organization id or slug. Resolve it with GET /v3/self.

sessionId
string
required

The session id.

Response

The session.

session_id
string
status
enum<string>

running, exit (completed), error, or suspended (cancelled/quota).

Available options:
running,
exit,
error,
suspended
url
string

Web URL to watch the session.

created_at
string<date-time>
started_at
string<date-time> | null
finished_at
string<date-time> | null
title
string | null
prompt
string | null
tags
string[]
repo
string | null
provider
enum<string> | null

Source-control provider for the session repository.

Available options:
github,
gitlab
model
string | null

Concrete model selected for this session, or null when inherited.

reasoning_effort
string | null
branch
string | null
pr_url
string | null
pr_title
string | null
result_summary
string | null
duration_ms
integer | null
cost_usd
number | null

Total model spend in USD across the session's turns. Null when usage was never reported.

usage
object

Token usage totals for the session. Fields are null for runs that predate usage persistence.

context
object

Live context occupancy after the latest turn (not billing throughput).

is_archived
boolean
parent_session_id
string | null

Always null (no session hierarchy).

child_session_ids
string[]

Always empty (no session hierarchy).

is_advanced
boolean

Always false.