Claude Platform Docs

Threads

List Session Threads
client.beta.sessions.threads.list(sessionID, params?, options?): PageCursor<BetaManagedAgentsSessionThread>
GET/v1/sessions/{session_id}/threads
Get Session Thread
client.beta.sessions.threads.retrieve(threadID, params, options?): BetaManagedAgentsSessionThread
GET/v1/sessions/{session_id}/threads/{thread_id}
Archive Session Thread
client.beta.sessions.threads.archive(threadID, params, options?): BetaManagedAgentsSessionThread
POST/v1/sessions/{session_id}/threads/{thread_id}/archive
Models
interface BetaManagedAgentsInlineAgent { type: "inline"; description; mcp_servers; /* 5 more */ }

An agent that has no Agent resource, and so no id or version. It is defined inline, in a workflow run's plan or when a session thread is spawned, and is not saved.

interface BetaManagedAgentsSessionThread { type: "session_thread"; id; agent; /* 9 more */ }

An execution thread within a session. Each session has one primary thread plus zero or more child threads.

interface BetaManagedAgentsSessionThreadStats { active_seconds; duration_seconds; startup_seconds }

Timing statistics for a session thread.

active_seconds?: number

Cumulative time in seconds the thread spent actively running. Excludes idle time.

formatdouble
duration_seconds?: number

Elapsed time since thread creation in seconds. For archived threads, frozen at the final update.

formatdouble
startup_seconds?: number

Time in seconds for the thread to begin running. Zero for child threads, which start immediately.

formatdouble
type BetaManagedAgentsSessionThreadStatus = "running" | "idle" | "rescheduling" | "terminated"
One of the following:
"running"
"idle"
"rescheduling"
"terminated"
interface BetaManagedAgentsSessionThreadUsage { active_seconds; cache_creation; cache_read_input_tokens; /* 4 more */ }

Cumulative token usage for a session thread across all turns.

type BetaManagedAgentsStreamSessionThreadEvents = BetaManagedAgentsUserMessageEvent | BetaManagedAgentsUserInterruptEvent | BetaManagedAgentsUserToolConfirmationEvent | 41 more

Server-sent event in a single thread's stream.

One of the following:

ThreadsEvents

List Session Thread Events
client.beta.sessions.threads.events.list(threadID, params, options?): PageCursor<BetaManagedAgentsSessionEvent>
GET/v1/sessions/{session_id}/threads/{thread_id}/events
Stream Session Thread Events
client.beta.sessions.threads.events.stream(threadID, params, options?): BetaManagedAgentsStreamSessionThreadEvents | Stream<BetaManagedAgentsStreamSessionThreadEvents>
GET/v1/sessions/{session_id}/threads/{thread_id}/stream