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.
A session the token can’t read returns
404. See session access rules.Authorizations
Headers
The API version to use for this request. The latest version is 2026-03-11.
Available options:
2026-03-11