Claude Platform Docs

Threads

List Session Threads
ThreadListPage beta().sessions().threads().list(params = ThreadListParams.none(), requestOptions = RequestOptions.none())
GET/v1/sessions/{session_id}/threads
Get Session Thread
BetaManagedAgentsSessionThread beta().sessions().threads().retrieve(params, requestOptions = RequestOptions.none())
GET/v1/sessions/{session_id}/threads/{thread_id}
Archive Session Thread
BetaManagedAgentsSessionThread beta().sessions().threads().archive(params, requestOptions = RequestOptions.none())
POST/v1/sessions/{session_id}/threads/{thread_id}/archive
Models
class BetaManagedAgentsInlineAgent { type = "inline"; description; executionIdentity; /* 6 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.

class BetaManagedAgentsSessionThread { type; id; agent; /* 9 more */ }

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

class BetaManagedAgentsSessionThreadStats { activeSeconds; durationSeconds; startupSeconds; }

Timing statistics for a session thread.

Optional<Double> activeSeconds

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

formatdouble
Optional<Double> durationSeconds

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

formatdouble
Optional<Double> startupSeconds

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

formatdouble
enum BetaManagedAgentsSessionThreadStatus
RUNNING("running")
IDLE("idle")
RESCHEDULING("rescheduling")
TERMINATED("terminated")
class BetaManagedAgentsSessionThreadUsage { activeSeconds; cacheCreation; cacheReadInputTokens; /* 4 more */ }

Cumulative token usage for a session thread across all turns.

class BetaManagedAgentsStreamSessionThreadEvents: union

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

ThreadsEvents

List Session Thread Events
EventListPage beta().sessions().threads().events().list(params, requestOptions = RequestOptions.none())
GET/v1/sessions/{session_id}/threads/{thread_id}/events
Stream Session Thread Events
StreamResponse<BetaManagedAgentsStreamSessionThreadEvents> beta().sessions().threads().events().streamStreaming(params, requestOptions = RequestOptions.none())
GET/v1/sessions/{session_id}/threads/{thread_id}/stream