Skip to main content
POST
Generate session insights

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 generated insight.

A generated summary of a session and its headline metrics. When status is not_generated, only session_id and status are populated.

session_id
string
status
enum<string>
Available options:
generated,
not_generated
summary
string

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

category
string

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

outcome
string

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

message_count
integer

Number of messages exchanged during the session.

size
enum<string>

Relative size of the change.

Available options:
small,
medium,
large
initial_user_message
string | null

The first instruction that started the session.

pr_url
string | null
cost_usd
number | null
input_tokens
integer | null
output_tokens
integer | null
generated_at
string<date-time> | null