TypeScript SDK
Agents
Retrieve a session
Retrieve the status, metadata, and required actions for a session.
GET
TypeScript SDK
The response carries the session’s status and metadata, including any actions waiting on you. To read a session’s messages and agent thinking, use Query session events.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
The API version to use for this request. The latest version is 2026-03-11.
Available options:
2026-03-11 Path Parameters
The ID of the session to retrieve.
Response
Always session
Allowed value:
"session"One of: queued, in_progress, requires_action, completed, failed, canceled, terminated
Available options:
queued, in_progress, requires_action, completed, failed, canceled, terminated - Option 1
- Option 2
Required range:
x >= 0Required range:
x >= 0Required range:
x >= 0