Get session thread
Returns one thread from the session’s tree. The thread must belong to the tree rooted at the session in the path; anything else is a 404 rather than a cross-tree read.
Authorizations
A Recursion API key, created in the console under API keys.
Headers
Optional tenant consistency check. When present, it must name the tenant bound to the API key, including when x-organization-id is default.
1Organization in which to act. Required for a tenant-scoped API key. Optional for an organization-scoped key, where it must name that same organization. The value may be an organization id or default.
1Path Parameters
Any session id (UUID) in the tree; the read resolves to its root session.
Thread id as returned by managedAgentsListSessionThreads. Threads the runtime creates carry the sub-session's UUID; an imported transcript may carry the source system's own thread id.
1Response
One context-isolated execution stream inside a multi-agent session tree, as registered in the thread registry. Returned when listing a session's threads or reading a whole session tree.
One context-isolated execution stream inside a multi-agent session tree, as registered in the thread registry. Returned when listing a session's threads or reading a whole session tree.
Agent this thread runs (UUID).
RFC 3339 timestamp of when this record was created. Server-assigned.
What the thread exists to do within the tree, for example subagent, grader, or advisor. Not a chat message role.
Root session of the multi-agent tree this thread belongs to (UUID). Equal to session_id for a root session.
Session this thread belongs to (UUID).
Slash-joined ancestry of session ids from the tree root down to the session whose events this thread's events are stored under, for example "/root-id/child-id".
Thread lifecycle: running (executing now), idle (awaiting more input), or terminated (finished; see stop_reason).
Identifier for this thread within its session tree (UUID). Server-assigned. For a subagent thread it is the child session id, so the thread and the session carrying its events resolve each other directly.
Slash-joined ancestry of this thread within the tree, used to order threads for display. Defaults to session_path when the thread has no deeper nesting of its own.
RFC 3339 timestamp of the last change to this record. Server-assigned.
Agent version this thread runs (UUID). Absent when the thread was not pinned to a specific version.
RFC 3339 timestamp of when this thread was archived and stopped appearing as an active stream. Absent while the thread is not archived.
Human-readable label for this thread, supplied when it was spawned. Optional and never interpreted by the service.
Session the spawning thread belongs to (UUID). Absent on the tree's top-level thread.
Thread that spawned this one (UUID). Absent on the tree's top-level thread.
Structured reason the thread last stopped, forwarded from the agent loop, for example {"type": "end_turn"} or {"type": "error", "message": ...}. Absent while the thread has not stopped.