Skip to main content
GET
List session threads

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

session_id
string<uuid>
required

Session id (UUID) as returned by managedAgentsStartSession or managedAgentsListSessions.

Response

Response body of GET /managed-agents/v1/sessions/{session_id}/threads. The path id may name any session in a multi-agent tree; the registry returned is always the whole tree's, resolved through that session's root, so a subagent id and its root id return the same set.

Response body of GET /managed-agents/v1/sessions/{session_id}/threads. The path id may name any session in a multi-agent tree; the registry returned is always the whole tree's, resolved through that session's root, so a subagent id and its root id return the same set.

threads
object[] | null
required

Threads belonging to the session tree the path session is part of. May be null or an empty array; both mean the tree has no registered threads. Threads on sessions the caller may not read are dropped.