API ReferenceSessions

Get session insights

Returns the generated insight for a session: a summary, category, outcome, and headline metrics. If no insight has been generated yet, status is not_generated and the detail fields are absent.

Scope: sessions:read

Authentication

AuthorizationBearer

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

orgIdstringRequired

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

sessionIdstringRequired
The session id.

Response

The session insight, or a not_generated placeholder.

session_idstring
statusenum
summarystring

A short natural-language summary of what the session did.

categorystring

The inferred category of the work, e.g. bug_fix or feature.

outcomestring

The outcome of the session, e.g. pr_opened.

message_countinteger
Number of messages exchanged during the session.
sizeenum
Relative size of the change.
initial_user_messagestring or null
The first instruction that started the session.
pr_urlstring or null
cost_usddouble or null
input_tokensinteger or null
output_tokensinteger or null
generated_atdatetime or null

Errors

404
Not Found Error