Skip to main content
GET
Retrieve a session
Retrieves a session: the original request, current status, and latest_answer. It is the cursor-independent way to read a finished run’s result. Auth is optional, so public shares work. To check only whether a session finished, poll the lighter status endpoint. Returns the session object.

Path parameters

string
required
The session ID returned when the session was created.

Response

The session object, also returned by create.
string
Session UUID, used by every follow-up call.
object
The create body, with agent resolved to its full spec even if you passed a catalog id.
object
Live state: status, error, error_code, outcome, steps, usage_per_model, and subagent_session_ids. Field details: Get session status.
string | null
The session’s Agent View page, for live viewing and replay.
string | object | null
The agent’s latest final answer: text, or an object matching the agent’s answer_format. Mirrors the answer from changes. null until the agent first answers.
string
ISO 8601 creation time.
string | null
When the agent started. null until then.
string | null
When the session reached a terminal state. null until then.

Examples

Response

Errors