Sessions

Create Session

$ ant beta:sessions create

POST/v1/sessions

Get Session

$ ant beta:sessions retrieve

GET/v1/sessions/{session_id}

Update Session

$ ant beta:sessions update

POST/v1/sessions/{session_id}

Delete Session

$ ant beta:sessions delete

DELETE/v1/sessions/{session_id}

Archive Session

$ ant beta:sessions archive

POST/v1/sessions/{session_id}/archive

Models

beta_managed_agents_advisor_params: object{ model, type }

Platform advisor roster entry: a model the session's primary thread may consult mid-turn. At most one per roster; the entry occupies the roster name anthropic.advisor.

model: string

A Claude model id. The model must be permitted as an advisor for this agent's model — see the sessions/threads/advisor spec.

minLength1

maxLength256

type: "advisor"

beta_managed_agents_agent_message_preview: object{ id, type }

id: string

The id the buffered agent.message will carry if it is emitted. Matches the event_id on this preview's event_delta events.

type: "agent.message"

beta_managed_agents_agent_params: object{ id, type, version }

Specification for an Agent. Provide a specific version or use the short-form agent="agent_id" for the most recent version

id: string

The agent ID.

minLength1

maxLength128

type: "agent"

version: optional number

The specific agent version to use. Omit to use the latest version. Must be at least 1 if specified.

formatint32

beta_managed_agents_agent_thinking_preview: object{ id, type }

id: string

The id the buffered agent.thinking will carry if it is emitted. Start-only — no event_delta events follow.

type: "agent.thinking"

beta_managed_agents_agent_with_overrides_params: object{ id, type, mcp_servers, 5 more }

Reference to an agent plus optional configuration overrides. Each provided field replaces the agent's value for the caller's use; the agent resource is unchanged.

beta_managed_agents_branch_checkout: object{ name, type }

name: string

Branch name to check out.

minLength1

maxLength255

type: "branch"

beta_managed_agents_budget_limit: object{ max_list_cost, type }

A hard spend ceiling. The session stops issuing new model requests once the tracked list cost reaches max_list_cost.

max_list_cost: object{ amount, currency }

A monetary amount in a specific currency.

amount: string

Amount in minor units of the currency, as an integer decimal string with no leading zeros: "2500" is $25.00 and "50" is fifty cents. A string rather than a number so no float rounding is ever applied.

currency: "USD"

Uppercase ISO-4217 currency code. USD is the only currency currently supported; the accepted set is closed and grows only when a new currency is priced.

type: "limit"

beta_managed_agents_cache_creation_usage: object{ ephemeral_1h_input_tokens, ephemeral_5m_input_tokens }

Prompt-cache creation token usage broken down by cache lifetime.

ephemeral_1h_input_tokens: optional number

Tokens used to create 1-hour ephemeral cache entries.

formatint32

ephemeral_5m_input_tokens: optional number

Tokens used to create 5-minute ephemeral cache entries.

formatint32

beta_managed_agents_commit_checkout: object{ sha, type }

sha: string

Full commit SHA to check out.

minLength7

maxLength64

type: "commit"

beta_managed_agents_deleted_session: object{ id, type }

Confirmation that a session has been permanently deleted.

id: string

type: "session_deleted"

beta_managed_agents_delta_content: object{ content, type, index }

content: object{ text, type }

Regular text content.

text: string

The text content.

minLength1

type: "text"

type: "content_delta"

index: optional number

Which entry in the previewed event's content array this fragment lands in. Insert content as that entry when the index is new; append to the existing entry otherwise.

formatuint32

beta_managed_agents_delta_event: object{ delta, event_id, type }

An incremental update to an event that is still being streamed. Deltas are best-effort and may stop early; when the buffered event with id == event_id is produced it carries the complete content. A model request that ends early (an error or interrupt) produces no buffered event — its terminal span.model_request_end closes the preview. Only sent on stream connections that opt in via event_deltas; never appears in event history.

beta_managed_agents_delta_type: "agent.message" or "agent.thinking"

EventDeltaType enum

"agent.message"

"agent.thinking"

beta_managed_agents_file_resource_params: object{ file_id, type, mount_path }

Mount a file uploaded via the Files API into the session.

file_id: string

ID of a previously uploaded file.

minLength1

maxLength128

type: "file"

mount_path: optional string

Mount path in the container. Defaults to /mnt/session/uploads/<file_id>.

minLength1

maxLength4096

beta_managed_agents_github_repository_resource_params: object{ authorization_token, type, url, 2 more }

Mount a GitHub repository into the session's container.

beta_managed_agents_memory_store_resource_param: object{ memory_store_id, type, access, instructions }

Parameters for attaching a memory store to an agent session.

memory_store_id: string

The memory store ID (memstore_...). Must belong to the caller's organization and workspace.

type: "memory_store"

access: optional "read_write" or "read_only"

Access mode for an attached memory store.

One of the following:

"read_write"

"read_only"

instructions: optional string

Per-attachment guidance for the agent on how to use this store. Rendered into the memory section of the system prompt. Max 4096 chars.

maxLength4096

beta_managed_agents_multiagent: object{ agents, type }

Resolved coordinator topology with a concrete agent roster.

beta_managed_agents_multiagent_params: object{ agents, type }

A coordinator topology: the session's primary thread orchestrates work by spawning session threads, each running an agent drawn from the agents roster.

beta_managed_agents_multiagent_roster_entry_params: string or BetaManagedAgentsAgentParams { id, type, version } or BetaManagedAgentsMultiagentSelfParams { type } or BetaManagedAgentsAdvisorParams { model, type }

An entry in a multiagent roster: an agent ID string, a versioned agent reference, or self.

beta_managed_agents_outcome_evaluation_resource: object{ completed_at, description, explanation, 4 more }

Evaluation state for a single outcome defined via a define_outcome event.

completed_at: string

A timestamp in RFC 3339 format

formatdate-time

description: string

What the agent should produce.

explanation: string

Grader's verdict text from the most recent evaluation. For satisfied, explains why criteria are met; for needs_revision (intermediate), what's missing; for failed, why unrecoverable.

iteration: number

0-indexed revision cycle the outcome is currently on.

formatint32

outcome_id: string

Server-generated outc_ ID for this outcome.

result: string

Current evaluation state. pending before the agent begins work; running while producing or revising; evaluating while the grader scores; satisfied/max_iterations_reached/failed/interrupted are terminal.

type: "outcome_evaluation"

beta_managed_agents_server_tool_usage: object{ web_fetch_requests, web_search_requests }

Cumulative count of server-executed tool invocations, broken down by tool.

web_fetch_requests: optional number

Number of server-executed web fetch requests.

formatint32

web_search_requests: optional number

Number of server-executed web search requests.

formatint32

beta_managed_agents_session: object{ id, agent, archived_at, 14 more }

A Managed Agents session.

beta_managed_agents_session_agent: object{ id, description, mcp_servers, 8 more }

Resolved agent definition for a session. Snapshot of the agent at session creation time.

beta_managed_agents_session_agent_update: object{ mcp_servers, tools }

Mid-session agent configuration update. Only tools and mcp_servers are updatable. Full replacement: the provided array becomes the new value. To preserve existing entries, GET the session, modify the array, and POST it back.

beta_managed_agents_session_multiagent_coordinator: object{ agents, type }

Resolved coordinator topology with full agent definitions for each roster member.

beta_managed_agents_session_stats: object{ active_seconds, duration_seconds }

Timing statistics for a session.

active_seconds: optional number

Cumulative time in seconds the session spent in running status. Excludes idle time.

formatdouble

duration_seconds: optional number

Elapsed time since session creation in seconds. For terminated sessions, frozen at the final update.

formatdouble

beta_managed_agents_session_updated_event: object{ id, processed_at, type, 4 more }

Emitted when an UpdateSession request changed at least one field. Carries only the fields that changed; absent fields were not part of the update. The new configuration applies from the next turn.

beta_managed_agents_session_usage: object{ active_seconds, cache_creation, cache_read_input_tokens, 4 more }

Cumulative token usage for a session across all turns.

beta_managed_agents_session_usage_event: object{ id, processed_at, type, 2 more }

Periodic snapshot of the session's cumulative usage and tracked list cost.

beta_managed_agents_start_event: object{ event, type }

Opens a preview of a buffered event. Carries the previewed event's type and id only. Followed by zero or more event_delta events with the same event id, normally concluded by the buffered event carrying that id. If the producing model request ends without that event (an error or interrupt mid-stream), its terminal span.model_request_end closes the preview. Only sent on stream connections that opt in via event_deltas; never appears in event history.

beta_managed_agents_start_event_preview: BetaManagedAgentsAgentMessagePreview { id, type } or BetaManagedAgentsAgentThinkingPreview { id, type }

beta_managed_agents_agent_message_preview: object{ id, type }

id: string

The id the buffered agent.message will carry if it is emitted. Matches the event_id on this preview's event_delta events.

type: "agent.message"

beta_managed_agents_agent_thinking_preview: object{ id, type }

id: string

The id the buffered agent.thinking will carry if it is emitted. Start-only — no event_delta events follow.

type: "agent.thinking"

beta_managed_agents_system_content_block: object{ text, type }

Regular text content.

text: string

The text content.

minLength1

type: "text"

beta_managed_agents_system_message_event: object{ id, content, type, processed_at }

A mid-conversation system message event. Carries system-role content that is appended to the session as a role: "system" turn.

id: string

Unique identifier for this event.

content: array of BetaManagedAgentsSystemContentBlock { text, type }

System content blocks. Text-only.

text: string

The text content.

minLength1

type: "text"

type: "system.message"

processed_at: optional string

A timestamp in RFC 3339 format

formatdate-time

beta_managed_agents_user_tool_result_event: object{ id, tool_use_id, type, 4 more }

Event sent by the client providing the result of an agent-toolset tool execution. Only valid on self_hosted environments, where sandbox-routed tools are executed by the client rather than the server.

SessionsResources

SessionsThreadsEvents

List Session Thread Events

$ ant beta:sessions:threads:events list

GET/v1/sessions/{session_id}/threads/{thread_id}/events

Stream Session Thread Events

$ ant beta:sessions:threads:events stream

GET/v1/sessions/{session_id}/threads/{thread_id}/stream

Sessions

Create Session

List Sessions

Get Session

Update Session

Delete Session

Archive Session

Models

SessionsEvents

List Events

Send Events

Stream Events

SessionsResources

Add Session Resource

List Session Resources

Get Session Resource

Update Session Resource

Delete Session Resource

SessionsThreads

List Session Threads

Get Session Thread

Archive Session Thread

SessionsThreadsEvents

List Session Thread Events

Stream Session Thread Events