Skip to main content
GET
Get root session tree and timeline

Authorizations

Authorization
string
header
required

A Recursion API key, created in the console under API keys.

Headers

x-tenant-id
string

Optional tenant consistency check. When present, it must name the tenant bound to the API key, including when x-organization-id is default.

Minimum string length: 1
x-organization-id
string

Organization 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.

Minimum string length: 1

Path Parameters

sessionId
string<uuid>
required

Any session id (UUID) in the tree; the read resolves to its root session.

Query Parameters

hydrate
enum<string>

Opt-in compatibility mode. images rehydrates private image refs under strict response caps; omitted by default.

Available options:
images
image_urls
enum<string>

Set to signed to add a short-lived url (and url_expires_at) to stored image blocks within the per-read signing budget. Omitted when signing is unavailable or the budget is exhausted; the authenticated managedAgentsGetSessionImage endpoint always works.

Available options:
signed
payloads
enum<string>

External event payloads hydrate by default. Set refs to return bounded stubs and private reference metadata only.

Available options:
refs

Response

A whole multi-agent session tree: every session and thread in it, plus a bounded page of the merged chronological event log. Returned when reading the tree containing a given session.

A whole multi-agent session tree: every session and thread in it, plus a bounded page of the merged chronological event log. Returned when reading the tree containing a given session.

events
object[] | null
required

One page of the tree's events merged into a single chronological log across all sessions. Bounded by response size, so the page length is not a fixed count.

root_session_id
string
required

Root session of the multi-agent tree this result covers (UUID). Equal to session_id for a root session.

sessions
object[] | null
required

Every session in the tree, root and subagents alike. Always complete; only the event log is paged.

threads
object[] | null
required

Thread registry rows for the tree's context-isolated execution streams. Imported RL children appear when their import supplied thread names; older imports without names use session-derived fallback rows.

next_event_id
string

Cursor to pass as the starting point of the next event page. Present only when more events remain; absent on the last page.