One read of Claude Developer Platformapi-20260814T043121Z
565 pages moved out of 565 read.
Pages moved
565
significant first
Pages read
565
in this capture
Captured
04:31 UTC
Corpus hash
764ab7e8e96e
full baseline · corpus-hash
What this read moved
276-300 of 565, page 12 of 23This capture is too large to show at once. Changes 276-300 of 565 are below, significant first; the rest are on the following screens.
api/beta/sessions/events/send First recorded · 953 lines, first recorded
## Send Events ### Path Parameters ### Header Parameters ### Body Parameters ### Returns ### Example #### Response
The first capture of this source. The page was already there, and this is what it said.
---
title: Send Events
url: https://platform.claude.com/docs/en/api/beta/sessions/events/send
---
## Send Events
**post** `/v1/sessions/{session_id}/events`
Send Events
### Path Parameters
- `session_id: string`
### Header Parameters
- `"anthropic-beta": optional array of AnthropicBeta`
Optional header to specify the beta version(s) you want to use.
- `string`
- `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
- `"message-batches-2024-09-24"`
- `"prompt-caching-2024-07-31"`
- `"computer-use-2024-10-22"`
- `"computer-use-2025-01-24"`
- `"pdfs-2024-09-25"`
- `"token-counting-2024-11-01"`
- `"token-efficient-tools-2025-02-19"`
- `"output-128k-2025-02-19"`
- `"files-api-2025-04-14"`
- `"mcp-client-2025-04-04"`
- `"mcp-client-2025-11-20"`
- `"dev-full-thinking-2025-05-14"`
- `"interleaved-thinking-2025-05-14"`
- `"code-execution-2025-05-22"`
- `"extended-cache-ttl-2025-04-11"`
- `"context-1m-2025-08-07"`
- `"context-management-2025-06-27"`
- `"model-context-window-exceeded-2025-08-26"`
- `"skills-2025-10-02"`
- `"fast-mode-2026-02-01"`
- `"output-300k-2026-03-24"`
- `"user-profiles-2026-03-24"`
- `"advisor-tool-2026-03-01"`
- `"managed-agents-2026-04-01"`
- `"cache-diagnosis-2026-04-07"`
- `"dreaming-2026-04-21"`
- `"thinking-token-count-2026-05-13"`
- `"server-side-fallback-2026-06-01"`
- `"server-side-fallback-2026-07-01"`
- `"fallback-credit-2026-06-01"`
- `"fallback-credit-2026-07-01"`
- `"agent-memory-2026-07-22"`
- `"mid-conversation-tool-changes-2026-07-01"`
### Body Parameters
- `events: array of BetaManagedAgentsEventParams`
Events to send to the `session`.
- `BetaManagedAgentsUserMessageEventParams object { content, type }`
Parameters for sending a user message to the session.
- `content: array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsRedactedBlock`
Array of content blocks for the user message.
- `BetaManagedAgentsTextBlock object { text, type }`
Regular text content.
- `text: string`
The text content.
- `type: "text"`
- `"text"`
- `BetaManagedAgentsImageBlock object { source, type }`
Image content specified directly as base64 data or as a reference via a URL.
- `source: BetaManagedAgentsBase64ImageSource or BetaManagedAgentsURLImageSource or BetaManagedAgentsFileImageSource`
Union type for image source variants.
- `BetaManagedAgentsBase64ImageSource object { data, media_type, type }`
Base64-encoded image data.
- `data: string`
Base64-encoded image data.
- `media_type: string`
MIME type of the image (e.g., "image/png", "image/jpeg", "image/gif", "image/webp").
- `type: "base64"`
- `"base64"`
- `BetaManagedAgentsURLImageSource object { type, url }`
Image referenced by URL.
- `type: "url"`
- `"url"`
- `url: string`
URL of the image to fetch.
- `BetaManagedAgentsFileImageSource object { file_id, type }`
Image referenced by file ID.
- `file_id: string`
ID of a previously uploaded file.
- `type: "file"`
- `"file"`
- `type: "image"`
- `"image"`
- `BetaManagedAgentsDocumentBlock object { source, type, context, title }`
Document content, either specified directly as base64 data, as text, or as a reference via a URL.
- `source: BetaManagedAgentsBase64DocumentSource or BetaManagedAgentsPlainTextDocumentSource or BetaManagedAgentsURLDocumentSource or BetaManagedAgentsFileDocumentSource`
Union type for document source variants.
- `BetaManagedAgentsBase64DocumentSource object { data, media_type, type }`
Base64-encoded document data.
- `data: string`
Base64-encoded document data.
- `media_type: string`
MIME type of the document (e.g., "application/pdf").
- `type: "base64"`
- `"base64"`
- `BetaManagedAgentsPlainTextDocumentSource object { data, media_type, type }`
Plain text document content.
- `data: string`
The plain text content.
- `media_type: "text/plain"`
MIME type of the text content. Must be "text/plain".
- `"text/plain"`
- `type: "text"`
- `"text"`
- `BetaManagedAgentsURLDocumentSource object { type, url }`
Document referenced by URL.
- `type: "url"`
- `"url"`
- `url: string`
URL of the document to fetch.
- `BetaManagedAgentsFileDocumentSource object { file_id, type }`
Document referenced by file ID.
- `file_id: string`
ID of a previously uploaded file.
- `type: "file"`
- `"file"`
- `type: "document"`
- `"document"`
- `context: optional string or null`
Additional context about the document for the model.
- `title: optional string or null`
The title of the document.
- `BetaManagedAgentsRedactedBlock object { type }`
Placeholder for content withheld by Anthropic model policy.
- `type: "redacted"`
- `"redacted"`
- `type: "user.message"`
- `"user.message"`
- `BetaManagedAgentsUserInterruptEventParams object { type, session_thread_id }`
Parameters for sending an interrupt to pause the agent.
- `type: "user.interrupt"`
- `"user.interrupt"`
- `session_thread_id: optional string or null`
If absent, interrupts every non-archived thread in a multiagent session (or the primary alone in a single-agent session). If present, interrupts only the named thread.
- `BetaManagedAgentsUserToolConfirmationEventParams object { result, tool_use_id, type, deny_message }`
Parameters for confirming or denying a tool execution request.
- `result: "allow" or "deny"`
UserToolConfirmationResult enum
- `"allow"`
- `"deny"`
- `tool_use_id: string`
The id of the `agent.tool_use` or `agent.mcp_tool_use` event this result corresponds to, which can be found in the last `session.status_idle` [event's](https://platform.claude.com/docs/en/api/beta/sessions/events/list#beta_managed_agents_session_requires_action.event_ids) `stop_reason.event_ids` field.
- `type: "user.tool_confirmation"`
- `"user.tool_confirmation"`
- `deny_message: optional string or null`
Optional message providing context for a 'deny' decision. Only allowed when result is 'deny'.
- `BetaManagedAgentsUserCustomToolResultEventParams object { custom_tool_use_id, type, content, is_error }`
Parameters for providing the result of a custom tool execution.
- `custom_tool_use_id: string`
Cut at 300 lines. The page has the rest.
api/beta/sessions/events/stream First recorded · 2167 lines, first recorded
## Stream Events ### Path Parameters ### Query Parameters ### Header Parameters ### Returns ### Example #### Response
The first capture of this source. The page was already there, and this is what it said.
---
title: Stream Events
url: https://platform.claude.com/docs/en/api/beta/sessions/events/stream
---
## Stream Events
**get** `/v1/sessions/{session_id}/events/stream`
Stream Events
### Path Parameters
- `session_id: string`
### Query Parameters
- `event_deltas: optional array of BetaManagedAgentsDeltaType`
When set, this connection also receives streaming deltas (`event_start`, `event_delta`) while an event is being produced, before the event itself arrives. Deltas are best-effort; when the final event is produced it carries the complete content. A model request that ends early (an error or interrupt) produces no final event — its terminal `span.model_request_end` closes the preview. Accepts one or more event types to preview and may be repeated: `agent.message` streams `content_delta` fragments; `agent.thinking` is start-only — a signal that the agent has begun extended thinking, concluded by the `agent.thinking` event itself. Only previews of the requested event types are sent.
- `"agent.message"`
- `"agent.thinking"`
### Header Parameters
- `"anthropic-beta": optional array of AnthropicBeta`
Optional header to specify the beta version(s) you want to use.
- `string`
- `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
- `"message-batches-2024-09-24"`
- `"prompt-caching-2024-07-31"`
- `"computer-use-2024-10-22"`
- `"computer-use-2025-01-24"`
- `"pdfs-2024-09-25"`
- `"token-counting-2024-11-01"`
- `"token-efficient-tools-2025-02-19"`
- `"output-128k-2025-02-19"`
- `"files-api-2025-04-14"`
- `"mcp-client-2025-04-04"`
- `"mcp-client-2025-11-20"`
- `"dev-full-thinking-2025-05-14"`
- `"interleaved-thinking-2025-05-14"`
- `"code-execution-2025-05-22"`
- `"extended-cache-ttl-2025-04-11"`
- `"context-1m-2025-08-07"`
- `"context-management-2025-06-27"`
- `"model-context-window-exceeded-2025-08-26"`
- `"skills-2025-10-02"`
- `"fast-mode-2026-02-01"`
- `"output-300k-2026-03-24"`
- `"user-profiles-2026-03-24"`
- `"advisor-tool-2026-03-01"`
- `"managed-agents-2026-04-01"`
- `"cache-diagnosis-2026-04-07"`
- `"dreaming-2026-04-21"`
- `"thinking-token-count-2026-05-13"`
- `"server-side-fallback-2026-06-01"`
- `"server-side-fallback-2026-07-01"`
- `"fallback-credit-2026-06-01"`
- `"fallback-credit-2026-07-01"`
- `"agent-memory-2026-07-22"`
- `"mid-conversation-tool-changes-2026-07-01"`
### Returns
- `BetaManagedAgentsStreamSessionEvents = BetaManagedAgentsUserMessageEvent or BetaManagedAgentsUserInterruptEvent or BetaManagedAgentsUserToolConfirmationEvent or 34 more`
Server-sent event in the session stream.
- `BetaManagedAgentsUserMessageEvent object { id, content, type, processed_at }`
A user message event in the session conversation.
- `id: string`
Unique identifier for this event.
- `content: array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsRedactedBlock`
Array of content blocks comprising the user message.
- `BetaManagedAgentsTextBlock object { text, type }`
Regular text content.
- `text: string`
The text content.
- `type: "text"`
- `"text"`
- `BetaManagedAgentsImageBlock object { source, type }`
Image content specified directly as base64 data or as a reference via a URL.
- `source: BetaManagedAgentsBase64ImageSource or BetaManagedAgentsURLImageSource or BetaManagedAgentsFileImageSource`
Union type for image source variants.
- `BetaManagedAgentsBase64ImageSource object { data, media_type, type }`
Base64-encoded image data.
- `data: string`
Base64-encoded image data.
- `media_type: string`
MIME type of the image (e.g., "image/png", "image/jpeg", "image/gif", "image/webp").
- `type: "base64"`
- `"base64"`
- `BetaManagedAgentsURLImageSource object { type, url }`
Image referenced by URL.
- `type: "url"`
- `"url"`
- `url: string`
URL of the image to fetch.
- `BetaManagedAgentsFileImageSource object { file_id, type }`
Image referenced by file ID.
- `file_id: string`
ID of a previously uploaded file.
- `type: "file"`
- `"file"`
- `type: "image"`
- `"image"`
- `BetaManagedAgentsDocumentBlock object { source, type, context, title }`
Document content, either specified directly as base64 data, as text, or as a reference via a URL.
- `source: BetaManagedAgentsBase64DocumentSource or BetaManagedAgentsPlainTextDocumentSource or BetaManagedAgentsURLDocumentSource or BetaManagedAgentsFileDocumentSource`
Union type for document source variants.
- `BetaManagedAgentsBase64DocumentSource object { data, media_type, type }`
Base64-encoded document data.
- `data: string`
Base64-encoded document data.
- `media_type: string`
MIME type of the document (e.g., "application/pdf").
- `type: "base64"`
- `"base64"`
- `BetaManagedAgentsPlainTextDocumentSource object { data, media_type, type }`
Plain text document content.
- `data: string`
The plain text content.
- `media_type: "text/plain"`
MIME type of the text content. Must be "text/plain".
- `"text/plain"`
- `type: "text"`
- `"text"`
- `BetaManagedAgentsURLDocumentSource object { type, url }`
Document referenced by URL.
- `type: "url"`
- `"url"`
- `url: string`
URL of the document to fetch.
- `BetaManagedAgentsFileDocumentSource object { file_id, type }`
Document referenced by file ID.
- `file_id: string`
ID of a previously uploaded file.
- `type: "file"`
- `"file"`
- `type: "document"`
- `"document"`
- `context: optional string or null`
Additional context about the document for the model.
- `title: optional string or null`
The title of the document.
- `BetaManagedAgentsRedactedBlock object { type }`
Placeholder for content withheld by Anthropic model policy.
- `type: "redacted"`
- `"redacted"`
- `type: "user.message"`
- `"user.message"`
- `processed_at: optional string or null`
A timestamp in RFC 3339 format
- `BetaManagedAgentsUserInterruptEvent object { id, type, processed_at, session_thread_id }`
An interrupt event that pauses agent execution and returns control to the user.
- `id: string`
Unique identifier for this event.
- `type: "user.interrupt"`
- `"user.interrupt"`
- `processed_at: optional string or null`
A timestamp in RFC 3339 format
- `session_thread_id: optional string or null`
If absent, interrupts every non-archived thread in a multiagent session (or the primary alone in a single-agent session). If present, interrupts only the named thread.
- `BetaManagedAgentsUserToolConfirmationEvent object { id, result, tool_use_id, 4 more }`
A tool confirmation event that approves or denies a pending tool execution.
Cut at 300 lines. The page has the rest.
api/beta/sessions/list First recorded · 1023 lines, first recorded
## List Sessions ### Query Parameters ### Header Parameters ### Returns ### Example #### Response
The first capture of this source. The page was already there, and this is what it said.
---
title: List Sessions
url: https://platform.claude.com/docs/en/api/beta/sessions/list
---
## List Sessions
**get** `/v1/sessions`
List Sessions
### Query Parameters
- `agent_id: optional string`
Filter sessions created with this agent ID.
- `agent_version: optional number`
Filter by agent version. Only applies when agent_id is also set.
- `"created_at[gt]": optional string`
Return sessions created after this time (exclusive).
- `"created_at[gte]": optional string`
Return sessions created at or after this time (inclusive).
- `"created_at[lt]": optional string`
Return sessions created before this time (exclusive).
- `"created_at[lte]": optional string`
Return sessions created at or before this time (inclusive).
- `deployment_id: optional string`
Filter sessions created by this deployment ID.
- `include_archived: optional boolean`
When true, includes archived sessions. Default: false (exclude archived).
- `limit: optional number`
Maximum number of results to return.
- `memory_store_id: optional string`
Filter sessions whose resources contain a memory_store with this memory store ID.
- `order: optional "asc" or "desc"`
Sort direction for results, ordered by created_at. Defaults to desc (newest first).
- `"asc"`
- `"desc"`
- `page: optional string`
Opaque pagination cursor from a previous response.
- `statuses: optional array of "rescheduling" or "running" or "idle" or "terminated"`
Filter by session status. Repeat the parameter to match any of multiple statuses.
- `"rescheduling"`
- `"running"`
- `"idle"`
- `"terminated"`
### Header Parameters
- `"anthropic-beta": optional array of AnthropicBeta`
Optional header to specify the beta version(s) you want to use.
- `string`
- `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
- `"message-batches-2024-09-24"`
- `"prompt-caching-2024-07-31"`
- `"computer-use-2024-10-22"`
- `"computer-use-2025-01-24"`
- `"pdfs-2024-09-25"`
- `"token-counting-2024-11-01"`
- `"token-efficient-tools-2025-02-19"`
- `"output-128k-2025-02-19"`
- `"files-api-2025-04-14"`
- `"mcp-client-2025-04-04"`
- `"mcp-client-2025-11-20"`
- `"dev-full-thinking-2025-05-14"`
- `"interleaved-thinking-2025-05-14"`
- `"code-execution-2025-05-22"`
- `"extended-cache-ttl-2025-04-11"`
- `"context-1m-2025-08-07"`
- `"context-management-2025-06-27"`
- `"model-context-window-exceeded-2025-08-26"`
- `"skills-2025-10-02"`
- `"fast-mode-2026-02-01"`
- `"output-300k-2026-03-24"`
- `"user-profiles-2026-03-24"`
- `"advisor-tool-2026-03-01"`
- `"managed-agents-2026-04-01"`
- `"cache-diagnosis-2026-04-07"`
- `"dreaming-2026-04-21"`
- `"thinking-token-count-2026-05-13"`
- `"server-side-fallback-2026-06-01"`
- `"server-side-fallback-2026-07-01"`
- `"fallback-credit-2026-06-01"`
- `"fallback-credit-2026-07-01"`
- `"agent-memory-2026-07-22"`
- `"mid-conversation-tool-changes-2026-07-01"`
### Returns
- `data: optional array of BetaManagedAgentsSession`
List of sessions.
- `id: string`
- `agent: BetaManagedAgentsSessionAgent`
Resolved `agent` definition for a `session`. Snapshot of the `agent` at `session` creation time.
- `id: string`
- `description: string or null`
- `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
- `name: string`
- `type: "url"`
- `"url"`
- `url: string`
- `model: BetaManagedAgentsModelConfig`
Model identifier and configuration.
- `id: BetaManagedAgentsModel`
The model that will power your agent.
See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
- `"claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more`
The model that will power your agent.
See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
- `"claude-sonnet-5"`
High-performance model for coding and agents
- `"claude-fable-5"`
Next generation of intelligence for the hardest knowledge work and coding problems
- `"claude-opus-5"`
Powerful intelligence for long-running agents and coding
- `"claude-opus-4-8"`
Powerful intelligence for long-running agents and coding
- `"claude-opus-4-7"`
Powerful intelligence for long-running agents and coding
- `"claude-opus-4-6"`
Powerful intelligence for long-running agents and coding
- `"claude-sonnet-4-6"`
Best combination of speed and intelligence
- `"claude-haiku-4-5"`
Fastest model with near-frontier intelligence
- `"claude-haiku-4-5-20251001"`
Fastest model with near-frontier intelligence
- `"claude-opus-4-5"`
Powerful intelligence for long-running agents and coding
- `"claude-opus-4-5-20251101"`
Powerful intelligence for long-running agents and coding
- `"claude-sonnet-4-5"`
High-performance model for agents and coding
- `"claude-sonnet-4-5-20250929"`
High-performance model for agents and coding
- `string`
- `effort: optional BetaManagedAgentsEffortLow or BetaManagedAgentsEffortMedium or BetaManagedAgentsEffortHigh or 2 more`
How hard Claude works on each turn. Sets `output_config.effort` on every Messages call the session makes.
- `BetaManagedAgentsEffortLow object { type }`
Low effort. Favors latency over reasoning depth.
- `type: "low"`
- `"low"`
- `BetaManagedAgentsEffortMedium object { type }`
Medium effort. Balances latency and reasoning depth.
- `type: "medium"`
- `"medium"`
- `BetaManagedAgentsEffortHigh object { type }`
High effort. Favors reasoning depth.
- `type: "high"`
- `"high"`
- `BetaManagedAgentsEffortXhigh object { type }`
Extra-high effort. Not all models accept this level.
- `type: "xhigh"`
- `"xhigh"`
- `BetaManagedAgentsEffortMax object { type }`
Maximum effort. Favors reasoning depth over latency.
- `type: "max"`
- `"max"`
- `inference_geo: optional string`
Geographic region for model inference. When unset, requests fall through to the workspace's default_inference_geo.
- `speed: optional "standard" or "fast"`
Inference speed mode. `fast` provides significantly faster output token generation at premium pricing. Not all models support `fast`; invalid combinations are rejected at create time.
Cut at 300 lines. The page has the rest.
api/beta/sessions/resources First recorded · 1386 lines, first recorded
# Resources ## Add Session Resource ### Path Parameters ### Header Parameters ### Body Parameters ### Returns ### Example #### Response ## List Session Resources ### Path Parameters ### Query Parameters ### Header Parameters ### Returns ### Example #### Response ## Get Session Resource ### Path Parameters ### Header Parameters ### Returns ### Example #### Response ## Update Session Resource ### Path Parameters ### Header Parameters ### Body Parameters ### Returns ### Example #### Response ## Delete Session Resource ### Path Parameters ### Header Parameters ### Returns ### Example #### Response ## Domain Types ### Beta Managed Agents Delete Session Resource ### Beta Managed Agents File Resource ### Beta Managed Agents GitHub Repository Resource ### Beta Managed Agents Memory Store Resource ### Beta Managed Agents Session Resource ### Resource Retrieve Response ### Resource Update Response
The first capture of this source. The page was already there, and this is what it said.
---
title: Resources
url: https://platform.claude.com/docs/en/api/beta/sessions/resources
---
# Resources
## Add Session Resource
**post** `/v1/sessions/{session_id}/resources`
Add Session Resource
### Path Parameters
- `session_id: string`
### Header Parameters
- `"anthropic-beta": optional array of AnthropicBeta`
Optional header to specify the beta version(s) you want to use.
- `string`
- `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
- `"message-batches-2024-09-24"`
- `"prompt-caching-2024-07-31"`
- `"computer-use-2024-10-22"`
- `"computer-use-2025-01-24"`
- `"pdfs-2024-09-25"`
- `"token-counting-2024-11-01"`
- `"token-efficient-tools-2025-02-19"`
- `"output-128k-2025-02-19"`
- `"files-api-2025-04-14"`
- `"mcp-client-2025-04-04"`
- `"mcp-client-2025-11-20"`
- `"dev-full-thinking-2025-05-14"`
- `"interleaved-thinking-2025-05-14"`
- `"code-execution-2025-05-22"`
- `"extended-cache-ttl-2025-04-11"`
- `"context-1m-2025-08-07"`
- `"context-management-2025-06-27"`
- `"model-context-window-exceeded-2025-08-26"`
- `"skills-2025-10-02"`
- `"fast-mode-2026-02-01"`
- `"output-300k-2026-03-24"`
- `"user-profiles-2026-03-24"`
- `"advisor-tool-2026-03-01"`
- `"managed-agents-2026-04-01"`
- `"cache-diagnosis-2026-04-07"`
- `"dreaming-2026-04-21"`
- `"thinking-token-count-2026-05-13"`
- `"server-side-fallback-2026-06-01"`
- `"server-side-fallback-2026-07-01"`
- `"fallback-credit-2026-06-01"`
- `"fallback-credit-2026-07-01"`
- `"agent-memory-2026-07-22"`
- `"mid-conversation-tool-changes-2026-07-01"`
### Body Parameters
- `file_id: string`
ID of a previously uploaded file.
- `type: "file"`
- `"file"`
- `mount_path: optional string or null`
Mount path in the container. Defaults to `/mnt/session/uploads/<file_id>`.
### Returns
- `BetaManagedAgentsFileResource object { id, created_at, file_id, 3 more }`
- `id: string`
- `created_at: string`
A timestamp in RFC 3339 format
- `file_id: string`
- `mount_path: string`
- `type: "file"`
- `"file"`
- `updated_at: string`
A timestamp in RFC 3339 format
### Example
```http
curl https://api.anthropic.com/v1/sessions/$SESSION_ID/resources \
-H 'Content-Type: application/json' \
-H 'anthropic-version: 2023-06-01' \
-H 'anthropic-beta: managed-agents-2026-04-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY" \
-d '{
"file_id": "file_011CNha8iCJcU1wXNR6q4V8w",
"type": "file",
"mount_path": "/uploads/receipt.pdf"
}'
```
#### Response
```json
{
"id": "sesrsc_011CZkZBJq5dWxk9fVLNcPht",
"created_at": "2026-03-15T10:00:00Z",
"file_id": "file_011CNha8iCJcU1wXNR6q4V8w",
"mount_path": "/uploads/receipt.pdf",
"type": "file",
"updated_at": "2026-03-15T10:00:00Z"
}
```
## List Session Resources
**get** `/v1/sessions/{session_id}/resources`
List Session Resources
### Path Parameters
- `session_id: string`
### Query Parameters
- `limit: optional number`
Maximum number of resources to return per page (max 1000). If omitted, returns all resources.
- `page: optional string`
Opaque cursor from a previous response's next_page field.
### Header Parameters
- `"anthropic-beta": optional array of AnthropicBeta`
Optional header to specify the beta version(s) you want to use.
- `string`
- `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
- `"message-batches-2024-09-24"`
- `"prompt-caching-2024-07-31"`
- `"computer-use-2024-10-22"`
- `"computer-use-2025-01-24"`
- `"pdfs-2024-09-25"`
- `"token-counting-2024-11-01"`
- `"token-efficient-tools-2025-02-19"`
- `"output-128k-2025-02-19"`
- `"files-api-2025-04-14"`
- `"mcp-client-2025-04-04"`
- `"mcp-client-2025-11-20"`
- `"dev-full-thinking-2025-05-14"`
- `"interleaved-thinking-2025-05-14"`
- `"code-execution-2025-05-22"`
- `"extended-cache-ttl-2025-04-11"`
- `"context-1m-2025-08-07"`
- `"context-management-2025-06-27"`
- `"model-context-window-exceeded-2025-08-26"`
- `"skills-2025-10-02"`
- `"fast-mode-2026-02-01"`
- `"output-300k-2026-03-24"`
- `"user-profiles-2026-03-24"`
- `"advisor-tool-2026-03-01"`
- `"managed-agents-2026-04-01"`
- `"cache-diagnosis-2026-04-07"`
- `"dreaming-2026-04-21"`
- `"thinking-token-count-2026-05-13"`
- `"server-side-fallback-2026-06-01"`
- `"server-side-fallback-2026-07-01"`
- `"fallback-credit-2026-06-01"`
- `"fallback-credit-2026-07-01"`
- `"agent-memory-2026-07-22"`
- `"mid-conversation-tool-changes-2026-07-01"`
### Returns
- `data: array of BetaManagedAgentsSessionResource`
Resources for the session, ordered by `created_at`.
- `BetaManagedAgentsGitHubRepositoryResource object { id, created_at, mount_path, 4 more }`
- `id: string`
- `created_at: string`
A timestamp in RFC 3339 format
- `mount_path: string`
- `type: "github_repository"`
- `"github_repository"`
- `updated_at: string`
A timestamp in RFC 3339 format
- `url: string`
- `checkout: optional BetaManagedAgentsBranchCheckout or BetaManagedAgentsCommitCheckout or null`
- `BetaManagedAgentsBranchCheckout object { name, type }`
- `name: string`
Branch name to check out.
- `type: "branch"`
- `"branch"`
- `BetaManagedAgentsCommitCheckout object { sha, type }`
- `sha: string`
Full commit SHA to check out.
- `type: "commit"`
- `"commit"`
Cut at 300 lines. The page has the rest.
api/beta/sessions/resources/add First recorded · 154 lines, first recorded
## Add Session Resource ### Path Parameters ### Header Parameters ### Body Parameters ### Returns ### Example #### Response
The first capture of this source. The page was already there, and this is what it said.
---
title: Add Session Resource
url: https://platform.claude.com/docs/en/api/beta/sessions/resources/add
---
## Add Session Resource
**post** `/v1/sessions/{session_id}/resources`
Add Session Resource
### Path Parameters
- `session_id: string`
### Header Parameters
- `"anthropic-beta": optional array of AnthropicBeta`
Optional header to specify the beta version(s) you want to use.
- `string`
- `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
- `"message-batches-2024-09-24"`
- `"prompt-caching-2024-07-31"`
- `"computer-use-2024-10-22"`
- `"computer-use-2025-01-24"`
- `"pdfs-2024-09-25"`
- `"token-counting-2024-11-01"`
- `"token-efficient-tools-2025-02-19"`
- `"output-128k-2025-02-19"`
- `"files-api-2025-04-14"`
- `"mcp-client-2025-04-04"`
- `"mcp-client-2025-11-20"`
- `"dev-full-thinking-2025-05-14"`
- `"interleaved-thinking-2025-05-14"`
- `"code-execution-2025-05-22"`
- `"extended-cache-ttl-2025-04-11"`
- `"context-1m-2025-08-07"`
- `"context-management-2025-06-27"`
- `"model-context-window-exceeded-2025-08-26"`
- `"skills-2025-10-02"`
- `"fast-mode-2026-02-01"`
- `"output-300k-2026-03-24"`
- `"user-profiles-2026-03-24"`
- `"advisor-tool-2026-03-01"`
- `"managed-agents-2026-04-01"`
- `"cache-diagnosis-2026-04-07"`
- `"dreaming-2026-04-21"`
- `"thinking-token-count-2026-05-13"`
- `"server-side-fallback-2026-06-01"`
- `"server-side-fallback-2026-07-01"`
- `"fallback-credit-2026-06-01"`
- `"fallback-credit-2026-07-01"`
- `"agent-memory-2026-07-22"`
- `"mid-conversation-tool-changes-2026-07-01"`
### Body Parameters
- `file_id: string`
ID of a previously uploaded file.
- `type: "file"`
- `"file"`
- `mount_path: optional string or null`
Mount path in the container. Defaults to `/mnt/session/uploads/<file_id>`.
### Returns
- `BetaManagedAgentsFileResource object { id, created_at, file_id, 3 more }`
- `id: string`
- `created_at: string`
A timestamp in RFC 3339 format
- `file_id: string`
- `mount_path: string`
- `type: "file"`
- `"file"`
- `updated_at: string`
A timestamp in RFC 3339 format
### Example
```http
curl https://api.anthropic.com/v1/sessions/$SESSION_ID/resources \
-H 'Content-Type: application/json' \
-H 'anthropic-version: 2023-06-01' \
-H 'anthropic-beta: managed-agents-2026-04-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY" \
-d '{
"file_id": "file_011CNha8iCJcU1wXNR6q4V8w",
"type": "file",
"mount_path": "/uploads/receipt.pdf"
}'
```
#### Response
```json
{
"id": "sesrsc_011CZkZBJq5dWxk9fVLNcPht",
"created_at": "2026-03-15T10:00:00Z",
"file_id": "file_011CNha8iCJcU1wXNR6q4V8w",
"mount_path": "/uploads/receipt.pdf",
"type": "file",
"updated_at": "2026-03-15T10:00:00Z"
}
```
api/beta/sessions/resources/delete First recorded · 123 lines, first recorded
## Delete Session Resource ### Path Parameters ### Header Parameters ### Returns ### Example #### Response
The first capture of this source. The page was already there, and this is what it said.
---
title: Delete Session Resource
url: https://platform.claude.com/docs/en/api/beta/sessions/resources/delete
---
## Delete Session Resource
**delete** `/v1/sessions/{session_id}/resources/{resource_id}`
Delete Session Resource
### Path Parameters
- `session_id: string`
- `resource_id: string`
### Header Parameters
- `"anthropic-beta": optional array of AnthropicBeta`
Optional header to specify the beta version(s) you want to use.
- `string`
- `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
- `"message-batches-2024-09-24"`
- `"prompt-caching-2024-07-31"`
- `"computer-use-2024-10-22"`
- `"computer-use-2025-01-24"`
- `"pdfs-2024-09-25"`
- `"token-counting-2024-11-01"`
- `"token-efficient-tools-2025-02-19"`
- `"output-128k-2025-02-19"`
- `"files-api-2025-04-14"`
- `"mcp-client-2025-04-04"`
- `"mcp-client-2025-11-20"`
- `"dev-full-thinking-2025-05-14"`
- `"interleaved-thinking-2025-05-14"`
- `"code-execution-2025-05-22"`
- `"extended-cache-ttl-2025-04-11"`
- `"context-1m-2025-08-07"`
- `"context-management-2025-06-27"`
- `"model-context-window-exceeded-2025-08-26"`
- `"skills-2025-10-02"`
- `"fast-mode-2026-02-01"`
- `"output-300k-2026-03-24"`
- `"user-profiles-2026-03-24"`
- `"advisor-tool-2026-03-01"`
- `"managed-agents-2026-04-01"`
- `"cache-diagnosis-2026-04-07"`
- `"dreaming-2026-04-21"`
- `"thinking-token-count-2026-05-13"`
- `"server-side-fallback-2026-06-01"`
- `"server-side-fallback-2026-07-01"`
- `"fallback-credit-2026-06-01"`
- `"fallback-credit-2026-07-01"`
- `"agent-memory-2026-07-22"`
- `"mid-conversation-tool-changes-2026-07-01"`
### Returns
- `BetaManagedAgentsDeleteSessionResource object { id, type }`
Confirmation of resource deletion.
- `id: string`
- `type: "session_resource_deleted"`
- `"session_resource_deleted"`
### Example
```http
curl https://api.anthropic.com/v1/sessions/$SESSION_ID/resources/$RESOURCE_ID \
-X DELETE \
-H 'anthropic-version: 2023-06-01' \
-H 'anthropic-beta: managed-agents-2026-04-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY"
```
#### Response
```json
{
"id": "sesrsc_011CZkZBJq5dWxk9fVLNcPht",
"type": "session_resource_deleted"
}
```
api/beta/sessions/resources/list First recorded · 247 lines, first recorded
## List Session Resources ### Path Parameters ### Query Parameters ### Header Parameters ### Returns ### Example #### Response
The first capture of this source. The page was already there, and this is what it said.
---
title: List Session Resources
url: https://platform.claude.com/docs/en/api/beta/sessions/resources/list
---
## List Session Resources
**get** `/v1/sessions/{session_id}/resources`
List Session Resources
### Path Parameters
- `session_id: string`
### Query Parameters
- `limit: optional number`
Maximum number of resources to return per page (max 1000). If omitted, returns all resources.
- `page: optional string`
Opaque cursor from a previous response's next_page field.
### Header Parameters
- `"anthropic-beta": optional array of AnthropicBeta`
Optional header to specify the beta version(s) you want to use.
- `string`
- `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
- `"message-batches-2024-09-24"`
- `"prompt-caching-2024-07-31"`
- `"computer-use-2024-10-22"`
- `"computer-use-2025-01-24"`
- `"pdfs-2024-09-25"`
- `"token-counting-2024-11-01"`
- `"token-efficient-tools-2025-02-19"`
- `"output-128k-2025-02-19"`
- `"files-api-2025-04-14"`
- `"mcp-client-2025-04-04"`
- `"mcp-client-2025-11-20"`
- `"dev-full-thinking-2025-05-14"`
- `"interleaved-thinking-2025-05-14"`
- `"code-execution-2025-05-22"`
- `"extended-cache-ttl-2025-04-11"`
- `"context-1m-2025-08-07"`
- `"context-management-2025-06-27"`
- `"model-context-window-exceeded-2025-08-26"`
- `"skills-2025-10-02"`
- `"fast-mode-2026-02-01"`
- `"output-300k-2026-03-24"`
- `"user-profiles-2026-03-24"`
- `"advisor-tool-2026-03-01"`
- `"managed-agents-2026-04-01"`
- `"cache-diagnosis-2026-04-07"`
- `"dreaming-2026-04-21"`
- `"thinking-token-count-2026-05-13"`
- `"server-side-fallback-2026-06-01"`
- `"server-side-fallback-2026-07-01"`
- `"fallback-credit-2026-06-01"`
- `"fallback-credit-2026-07-01"`
- `"agent-memory-2026-07-22"`
- `"mid-conversation-tool-changes-2026-07-01"`
### Returns
- `data: array of BetaManagedAgentsSessionResource`
Resources for the session, ordered by `created_at`.
- `BetaManagedAgentsGitHubRepositoryResource object { id, created_at, mount_path, 4 more }`
- `id: string`
- `created_at: string`
A timestamp in RFC 3339 format
- `mount_path: string`
- `type: "github_repository"`
- `"github_repository"`
- `updated_at: string`
A timestamp in RFC 3339 format
- `url: string`
- `checkout: optional BetaManagedAgentsBranchCheckout or BetaManagedAgentsCommitCheckout or null`
- `BetaManagedAgentsBranchCheckout object { name, type }`
- `name: string`
Branch name to check out.
- `type: "branch"`
- `"branch"`
- `BetaManagedAgentsCommitCheckout object { sha, type }`
- `sha: string`
Full commit SHA to check out.
- `type: "commit"`
- `"commit"`
- `BetaManagedAgentsFileResource object { id, created_at, file_id, 3 more }`
- `id: string`
- `created_at: string`
A timestamp in RFC 3339 format
- `file_id: string`
- `mount_path: string`
- `type: "file"`
- `"file"`
- `updated_at: string`
A timestamp in RFC 3339 format
- `BetaManagedAgentsMemoryStoreResource object { memory_store_id, type, access, 4 more }`
A memory store attached 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"`
- `"memory_store"`
- `access: optional "read_write" or "read_only" or null`
Access mode for an attached memory store.
- `"read_write"`
- `"read_only"`
- `description: optional string`
Description of the memory store, snapshotted at attach time. Rendered into the agent's system prompt. Empty string when the store has no description.
- `instructions: optional string or null`
Per-attachment guidance for the agent on how to use this store. Rendered into the memory section of the system prompt. Max 4096 chars.
- `mount_path: optional string or null`
Filesystem path where the store is mounted in the session container, e.g. /mnt/memory/user-preferences. Derived from the store's name. Output-only.
- `name: optional string or null`
Display name of the memory store, snapshotted at attach time. Later edits to the store's name do not propagate to this resource.
- `next_page: optional string or null`
Opaque cursor for the next page. Null when no more results.
### Example
```http
curl https://api.anthropic.com/v1/sessions/$SESSION_ID/resources \
-H 'anthropic-version: 2023-06-01' \
-H 'anthropic-beta: managed-agents-2026-04-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY"
```
#### Response
```json
{
"data": [
{
"id": "sesrsc_011CZkZBJq5dWxk9fVLNcPht",
"created_at": "2026-03-15T10:00:00Z",
"file_id": "file_011CNha8iCJcU1wXNR6q4V8w",
"mount_path": "/uploads/receipt.pdf",
"type": "file",
"updated_at": "2026-03-15T10:00:00Z"
},
{
"id": "sesrsc_011CZkZCKr6eXyl0gWMOdQiu",
"created_at": "2026-03-15T10:00:00Z",
"mount_path": "/workspace/example-repo",
"type": "github_repository",
"updated_at": "2026-03-15T10:00:00Z",
"url": "https://github.com/example-org/example-repo",
"checkout": {
"name": "main",
"type": "branch"
}
}
],
"next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="
}
```
api/beta/sessions/resources/retrieve First recorded · 218 lines, first recorded
## Get Session Resource ### Path Parameters ### Header Parameters ### Returns ### Example #### Response
The first capture of this source. The page was already there, and this is what it said.
---
title: Get Session Resource
url: https://platform.claude.com/docs/en/api/beta/sessions/resources/retrieve
---
## Get Session Resource
**get** `/v1/sessions/{session_id}/resources/{resource_id}`
Get Session Resource
### Path Parameters
- `session_id: string`
- `resource_id: string`
### Header Parameters
- `"anthropic-beta": optional array of AnthropicBeta`
Optional header to specify the beta version(s) you want to use.
- `string`
- `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
- `"message-batches-2024-09-24"`
- `"prompt-caching-2024-07-31"`
- `"computer-use-2024-10-22"`
- `"computer-use-2025-01-24"`
- `"pdfs-2024-09-25"`
- `"token-counting-2024-11-01"`
- `"token-efficient-tools-2025-02-19"`
- `"output-128k-2025-02-19"`
- `"files-api-2025-04-14"`
- `"mcp-client-2025-04-04"`
- `"mcp-client-2025-11-20"`
- `"dev-full-thinking-2025-05-14"`
- `"interleaved-thinking-2025-05-14"`
- `"code-execution-2025-05-22"`
- `"extended-cache-ttl-2025-04-11"`
- `"context-1m-2025-08-07"`
- `"context-management-2025-06-27"`
- `"model-context-window-exceeded-2025-08-26"`
- `"skills-2025-10-02"`
- `"fast-mode-2026-02-01"`
- `"output-300k-2026-03-24"`
- `"user-profiles-2026-03-24"`
- `"advisor-tool-2026-03-01"`
- `"managed-agents-2026-04-01"`
- `"cache-diagnosis-2026-04-07"`
- `"dreaming-2026-04-21"`
- `"thinking-token-count-2026-05-13"`
- `"server-side-fallback-2026-06-01"`
- `"server-side-fallback-2026-07-01"`
- `"fallback-credit-2026-06-01"`
- `"fallback-credit-2026-07-01"`
- `"agent-memory-2026-07-22"`
- `"mid-conversation-tool-changes-2026-07-01"`
### Returns
- `BetaManagedAgentsGitHubRepositoryResource object { id, created_at, mount_path, 4 more }`
- `id: string`
- `created_at: string`
A timestamp in RFC 3339 format
- `mount_path: string`
- `type: "github_repository"`
- `"github_repository"`
- `updated_at: string`
A timestamp in RFC 3339 format
- `url: string`
- `checkout: optional BetaManagedAgentsBranchCheckout or BetaManagedAgentsCommitCheckout or null`
- `BetaManagedAgentsBranchCheckout object { name, type }`
- `name: string`
Branch name to check out.
- `type: "branch"`
- `"branch"`
- `BetaManagedAgentsCommitCheckout object { sha, type }`
- `sha: string`
Full commit SHA to check out.
- `type: "commit"`
- `"commit"`
- `BetaManagedAgentsFileResource object { id, created_at, file_id, 3 more }`
- `id: string`
- `created_at: string`
A timestamp in RFC 3339 format
- `file_id: string`
- `mount_path: string`
- `type: "file"`
- `"file"`
- `updated_at: string`
A timestamp in RFC 3339 format
- `BetaManagedAgentsMemoryStoreResource object { memory_store_id, type, access, 4 more }`
A memory store attached 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"`
- `"memory_store"`
- `access: optional "read_write" or "read_only" or null`
Access mode for an attached memory store.
- `"read_write"`
- `"read_only"`
- `description: optional string`
Description of the memory store, snapshotted at attach time. Rendered into the agent's system prompt. Empty string when the store has no description.
- `instructions: optional string or null`
Per-attachment guidance for the agent on how to use this store. Rendered into the memory section of the system prompt. Max 4096 chars.
- `mount_path: optional string or null`
Filesystem path where the store is mounted in the session container, e.g. /mnt/memory/user-preferences. Derived from the store's name. Output-only.
- `name: optional string or null`
Display name of the memory store, snapshotted at attach time. Later edits to the store's name do not propagate to this resource.
### Example
```http
curl https://api.anthropic.com/v1/sessions/$SESSION_ID/resources/$RESOURCE_ID \
-H 'anthropic-version: 2023-06-01' \
-H 'anthropic-beta: managed-agents-2026-04-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY"
```
#### Response
```json
{
"id": "sesrsc_011CZkZCKr6eXyl0gWMOdQiu",
"created_at": "2026-03-15T10:00:00Z",
"mount_path": "/workspace/example-repo",
"type": "github_repository",
"updated_at": "2026-03-15T10:00:00Z",
"url": "https://github.com/example-org/example-repo",
"checkout": {
"name": "main",
"type": "branch"
}
}
```
api/beta/sessions/resources/update First recorded · 228 lines, first recorded
## Update Session Resource ### Path Parameters ### Header Parameters ### Body Parameters ### Returns ### Example #### Response
The first capture of this source. The page was already there, and this is what it said.
---
title: Update Session Resource
url: https://platform.claude.com/docs/en/api/beta/sessions/resources/update
---
## Update Session Resource
**post** `/v1/sessions/{session_id}/resources/{resource_id}`
Update Session Resource
### Path Parameters
- `session_id: string`
- `resource_id: string`
### Header Parameters
- `"anthropic-beta": optional array of AnthropicBeta`
Optional header to specify the beta version(s) you want to use.
- `string`
- `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
- `"message-batches-2024-09-24"`
- `"prompt-caching-2024-07-31"`
- `"computer-use-2024-10-22"`
- `"computer-use-2025-01-24"`
- `"pdfs-2024-09-25"`
- `"token-counting-2024-11-01"`
- `"token-efficient-tools-2025-02-19"`
- `"output-128k-2025-02-19"`
- `"files-api-2025-04-14"`
- `"mcp-client-2025-04-04"`
- `"mcp-client-2025-11-20"`
- `"dev-full-thinking-2025-05-14"`
- `"interleaved-thinking-2025-05-14"`
- `"code-execution-2025-05-22"`
- `"extended-cache-ttl-2025-04-11"`
- `"context-1m-2025-08-07"`
- `"context-management-2025-06-27"`
- `"model-context-window-exceeded-2025-08-26"`
- `"skills-2025-10-02"`
- `"fast-mode-2026-02-01"`
- `"output-300k-2026-03-24"`
- `"user-profiles-2026-03-24"`
- `"advisor-tool-2026-03-01"`
- `"managed-agents-2026-04-01"`
- `"cache-diagnosis-2026-04-07"`
- `"dreaming-2026-04-21"`
- `"thinking-token-count-2026-05-13"`
- `"server-side-fallback-2026-06-01"`
- `"server-side-fallback-2026-07-01"`
- `"fallback-credit-2026-06-01"`
- `"fallback-credit-2026-07-01"`
- `"agent-memory-2026-07-22"`
- `"mid-conversation-tool-changes-2026-07-01"`
### Body Parameters
- `authorization_token: string`
New authorization token for the resource. Currently only `github_repository` resources support token rotation.
### Returns
- `BetaManagedAgentsGitHubRepositoryResource object { id, created_at, mount_path, 4 more }`
- `id: string`
- `created_at: string`
A timestamp in RFC 3339 format
- `mount_path: string`
- `type: "github_repository"`
- `"github_repository"`
- `updated_at: string`
A timestamp in RFC 3339 format
- `url: string`
- `checkout: optional BetaManagedAgentsBranchCheckout or BetaManagedAgentsCommitCheckout or null`
- `BetaManagedAgentsBranchCheckout object { name, type }`
- `name: string`
Branch name to check out.
- `type: "branch"`
- `"branch"`
- `BetaManagedAgentsCommitCheckout object { sha, type }`
- `sha: string`
Full commit SHA to check out.
- `type: "commit"`
- `"commit"`
- `BetaManagedAgentsFileResource object { id, created_at, file_id, 3 more }`
- `id: string`
- `created_at: string`
A timestamp in RFC 3339 format
- `file_id: string`
- `mount_path: string`
- `type: "file"`
- `"file"`
- `updated_at: string`
A timestamp in RFC 3339 format
- `BetaManagedAgentsMemoryStoreResource object { memory_store_id, type, access, 4 more }`
A memory store attached 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"`
- `"memory_store"`
- `access: optional "read_write" or "read_only" or null`
Access mode for an attached memory store.
- `"read_write"`
- `"read_only"`
- `description: optional string`
Description of the memory store, snapshotted at attach time. Rendered into the agent's system prompt. Empty string when the store has no description.
- `instructions: optional string or null`
Per-attachment guidance for the agent on how to use this store. Rendered into the memory section of the system prompt. Max 4096 chars.
- `mount_path: optional string or null`
Filesystem path where the store is mounted in the session container, e.g. /mnt/memory/user-preferences. Derived from the store's name. Output-only.
- `name: optional string or null`
Display name of the memory store, snapshotted at attach time. Later edits to the store's name do not propagate to this resource.
### Example
```http
curl https://api.anthropic.com/v1/sessions/$SESSION_ID/resources/$RESOURCE_ID \
-H 'Content-Type: application/json' \
-H 'anthropic-version: 2023-06-01' \
-H 'anthropic-beta: managed-agents-2026-04-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY" \
-d '{
"authorization_token": "ghp_exampletoken"
}'
```
#### Response
```json
{
"id": "sesrsc_011CZkZCKr6eXyl0gWMOdQiu",
"created_at": "2026-03-15T10:00:00Z",
"mount_path": "/workspace/example-repo",
"type": "github_repository",
"updated_at": "2026-03-15T10:00:00Z",
"url": "https://github.com/example-org/example-repo",
"checkout": {
"name": "main",
"type": "branch"
}
}
```
api/beta/sessions/retrieve First recorded · 947 lines, first recorded
## Get Session ### Path Parameters ### Header Parameters ### Returns ### Example #### Response
The first capture of this source. The page was already there, and this is what it said.
---
title: Get Session
url: https://platform.claude.com/docs/en/api/beta/sessions/retrieve
---
## Get Session
**get** `/v1/sessions/{session_id}`
Get Session
### Path Parameters
- `session_id: string`
### Header Parameters
- `"anthropic-beta": optional array of AnthropicBeta`
Optional header to specify the beta version(s) you want to use.
- `string`
- `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
- `"message-batches-2024-09-24"`
- `"prompt-caching-2024-07-31"`
- `"computer-use-2024-10-22"`
- `"computer-use-2025-01-24"`
- `"pdfs-2024-09-25"`
- `"token-counting-2024-11-01"`
- `"token-efficient-tools-2025-02-19"`
- `"output-128k-2025-02-19"`
- `"files-api-2025-04-14"`
- `"mcp-client-2025-04-04"`
- `"mcp-client-2025-11-20"`
- `"dev-full-thinking-2025-05-14"`
- `"interleaved-thinking-2025-05-14"`
- `"code-execution-2025-05-22"`
- `"extended-cache-ttl-2025-04-11"`
- `"context-1m-2025-08-07"`
- `"context-management-2025-06-27"`
- `"model-context-window-exceeded-2025-08-26"`
- `"skills-2025-10-02"`
- `"fast-mode-2026-02-01"`
- `"output-300k-2026-03-24"`
- `"user-profiles-2026-03-24"`
- `"advisor-tool-2026-03-01"`
- `"managed-agents-2026-04-01"`
- `"cache-diagnosis-2026-04-07"`
- `"dreaming-2026-04-21"`
- `"thinking-token-count-2026-05-13"`
- `"server-side-fallback-2026-06-01"`
- `"server-side-fallback-2026-07-01"`
- `"fallback-credit-2026-06-01"`
- `"fallback-credit-2026-07-01"`
- `"agent-memory-2026-07-22"`
- `"mid-conversation-tool-changes-2026-07-01"`
### Returns
- `BetaManagedAgentsSession object { id, agent, archived_at, 14 more }`
A Managed Agents `session`.
- `id: string`
- `agent: BetaManagedAgentsSessionAgent`
Resolved `agent` definition for a `session`. Snapshot of the `agent` at `session` creation time.
- `id: string`
- `description: string or null`
- `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
- `name: string`
- `type: "url"`
- `"url"`
- `url: string`
- `model: BetaManagedAgentsModelConfig`
Model identifier and configuration.
- `id: BetaManagedAgentsModel`
The model that will power your agent.
See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
- `"claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more`
The model that will power your agent.
See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
- `"claude-sonnet-5"`
High-performance model for coding and agents
- `"claude-fable-5"`
Next generation of intelligence for the hardest knowledge work and coding problems
- `"claude-opus-5"`
Powerful intelligence for long-running agents and coding
- `"claude-opus-4-8"`
Powerful intelligence for long-running agents and coding
- `"claude-opus-4-7"`
Powerful intelligence for long-running agents and coding
- `"claude-opus-4-6"`
Powerful intelligence for long-running agents and coding
- `"claude-sonnet-4-6"`
Best combination of speed and intelligence
- `"claude-haiku-4-5"`
Fastest model with near-frontier intelligence
- `"claude-haiku-4-5-20251001"`
Fastest model with near-frontier intelligence
- `"claude-opus-4-5"`
Powerful intelligence for long-running agents and coding
- `"claude-opus-4-5-20251101"`
Powerful intelligence for long-running agents and coding
- `"claude-sonnet-4-5"`
High-performance model for agents and coding
- `"claude-sonnet-4-5-20250929"`
High-performance model for agents and coding
- `string`
- `effort: optional BetaManagedAgentsEffortLow or BetaManagedAgentsEffortMedium or BetaManagedAgentsEffortHigh or 2 more`
How hard Claude works on each turn. Sets `output_config.effort` on every Messages call the session makes.
- `BetaManagedAgentsEffortLow object { type }`
Low effort. Favors latency over reasoning depth.
- `type: "low"`
- `"low"`
- `BetaManagedAgentsEffortMedium object { type }`
Medium effort. Balances latency and reasoning depth.
- `type: "medium"`
- `"medium"`
- `BetaManagedAgentsEffortHigh object { type }`
High effort. Favors reasoning depth.
- `type: "high"`
- `"high"`
- `BetaManagedAgentsEffortXhigh object { type }`
Extra-high effort. Not all models accept this level.
- `type: "xhigh"`
- `"xhigh"`
- `BetaManagedAgentsEffortMax object { type }`
Maximum effort. Favors reasoning depth over latency.
- `type: "max"`
- `"max"`
- `inference_geo: optional string`
Geographic region for model inference. When unset, requests fall through to the workspace's default_inference_geo.
- `speed: optional "standard" or "fast"`
Inference speed mode. `fast` provides significantly faster output token generation at premium pricing. Not all models support `fast`; invalid combinations are rejected at create time.
- `"standard"`
- `"fast"`
- `multiagent: BetaManagedAgentsSessionMultiagentCoordinator or null`
Resolved coordinator topology with full agent definitions for each roster member.
- `agents: array of BetaManagedAgentsSessionThreadAgent or BetaManagedAgentsAdvisor`
Full `agent` definitions the coordinator may spawn as session threads.
- `BetaManagedAgentsSessionThreadAgent object { id, description, mcp_servers, 7 more }`
Resolved `agent` definition for a single `session_thread`. Snapshot of the agent at thread creation time. The multiagent roster is not repeated here; read it from `Session.agent`.
- `id: string`
- `description: string or null`
- `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
- `name: string`
- `type: "url"`
- `url: string`
- `model: BetaManagedAgentsModelConfig`
Model identifier and configuration.
- `name: string`
- `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`
- `BetaManagedAgentsAnthropicSkill object { skill_id, type, version }`
A resolved Anthropic-managed skill.
- `skill_id: string`
- `type: "anthropic"`
- `"anthropic"`
- `version: string`
- `BetaManagedAgentsCustomSkill object { skill_id, type, version }`
A resolved user-created custom skill.
- `skill_id: string`
- `type: "custom"`
- `"custom"`
- `version: string`
- `system: string or null`
Cut at 300 lines. The page has the rest.
api/beta/sessions/threads First recorded · 8812 lines, first recorded
# Threads ## List Session Threads ### Path Parameters ### Query Parameters ### Header Parameters ### Returns ### Example #### Response ## Get Session Thread ### Path Parameters ### Header Parameters ### Returns ### Example #### Response ## Archive Session Thread ### Path Parameters ### Header Parameters ### Returns ### Example #### Response ## Domain Types ### Beta Managed Agents Session Thread ### Beta Managed Agents Session Thread Stats ### Beta Managed Agents Session Thread Status ### Beta Managed Agents Session Thread Usage ### Beta Managed Agents Stream Session Thread Events # Events ## List Session Thread Events ### Path Parameters ### Query Parameters ### Header Parameters ### Returns ### Example #### Response ## Stream Session Thread Events ### Path Parameters ### Query Parameters ### Header Parameters ### Returns ### Example #### Response
The first capture of this source. The page was already there, and this is what it said.
---
title: Threads
url: https://platform.claude.com/docs/en/api/beta/sessions/threads
---
# Threads
## List Session Threads
**get** `/v1/sessions/{session_id}/threads`
List Session Threads
### Path Parameters
- `session_id: string`
### Query Parameters
- `limit: optional number`
Maximum results per page. Defaults to 1000.
- `page: optional string`
Opaque pagination cursor from a previous response's next_page. Forward-only.
### Header Parameters
- `"anthropic-beta": optional array of AnthropicBeta`
Optional header to specify the beta version(s) you want to use.
- `string`
- `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
- `"message-batches-2024-09-24"`
- `"prompt-caching-2024-07-31"`
- `"computer-use-2024-10-22"`
- `"computer-use-2025-01-24"`
- `"pdfs-2024-09-25"`
- `"token-counting-2024-11-01"`
- `"token-efficient-tools-2025-02-19"`
- `"output-128k-2025-02-19"`
- `"files-api-2025-04-14"`
- `"mcp-client-2025-04-04"`
- `"mcp-client-2025-11-20"`
- `"dev-full-thinking-2025-05-14"`
- `"interleaved-thinking-2025-05-14"`
- `"code-execution-2025-05-22"`
- `"extended-cache-ttl-2025-04-11"`
- `"context-1m-2025-08-07"`
- `"context-management-2025-06-27"`
- `"model-context-window-exceeded-2025-08-26"`
- `"skills-2025-10-02"`
- `"fast-mode-2026-02-01"`
- `"output-300k-2026-03-24"`
- `"user-profiles-2026-03-24"`
- `"advisor-tool-2026-03-01"`
- `"managed-agents-2026-04-01"`
- `"cache-diagnosis-2026-04-07"`
- `"dreaming-2026-04-21"`
- `"thinking-token-count-2026-05-13"`
- `"server-side-fallback-2026-06-01"`
- `"server-side-fallback-2026-07-01"`
- `"fallback-credit-2026-06-01"`
- `"fallback-credit-2026-07-01"`
- `"agent-memory-2026-07-22"`
- `"mid-conversation-tool-changes-2026-07-01"`
### Returns
- `data: optional array of BetaManagedAgentsSessionThread`
Threads in the session, primary first then children in spawn order.
- `id: string`
Unique identifier for this thread.
- `agent: BetaManagedAgentsSessionThreadAgent or BetaManagedAgentsAdvisor`
A session-resolved multiagent roster entry.
- `BetaManagedAgentsSessionThreadAgent object { id, description, mcp_servers, 7 more }`
Resolved `agent` definition for a single `session_thread`. Snapshot of the agent at thread creation time. The multiagent roster is not repeated here; read it from `Session.agent`.
- `id: string`
- `description: string or null`
- `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
- `name: string`
- `type: "url"`
- `"url"`
- `url: string`
- `model: BetaManagedAgentsModelConfig`
Model identifier and configuration.
- `id: BetaManagedAgentsModel`
The model that will power your agent.
See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
- `"claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more`
The model that will power your agent.
See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
- `"claude-sonnet-5"`
High-performance model for coding and agents
- `"claude-fable-5"`
Next generation of intelligence for the hardest knowledge work and coding problems
- `"claude-opus-5"`
Powerful intelligence for long-running agents and coding
- `"claude-opus-4-8"`
Powerful intelligence for long-running agents and coding
- `"claude-opus-4-7"`
Powerful intelligence for long-running agents and coding
- `"claude-opus-4-6"`
Powerful intelligence for long-running agents and coding
- `"claude-sonnet-4-6"`
Best combination of speed and intelligence
- `"claude-haiku-4-5"`
Fastest model with near-frontier intelligence
- `"claude-haiku-4-5-20251001"`
Fastest model with near-frontier intelligence
- `"claude-opus-4-5"`
Powerful intelligence for long-running agents and coding
- `"claude-opus-4-5-20251101"`
Powerful intelligence for long-running agents and coding
- `"claude-sonnet-4-5"`
High-performance model for agents and coding
- `"claude-sonnet-4-5-20250929"`
High-performance model for agents and coding
- `string`
- `effort: optional BetaManagedAgentsEffortLow or BetaManagedAgentsEffortMedium or BetaManagedAgentsEffortHigh or 2 more`
How hard Claude works on each turn. Sets `output_config.effort` on every Messages call the session makes.
- `BetaManagedAgentsEffortLow object { type }`
Low effort. Favors latency over reasoning depth.
- `type: "low"`
- `"low"`
- `BetaManagedAgentsEffortMedium object { type }`
Medium effort. Balances latency and reasoning depth.
- `type: "medium"`
- `"medium"`
- `BetaManagedAgentsEffortHigh object { type }`
High effort. Favors reasoning depth.
- `type: "high"`
- `"high"`
- `BetaManagedAgentsEffortXhigh object { type }`
Extra-high effort. Not all models accept this level.
- `type: "xhigh"`
- `"xhigh"`
- `BetaManagedAgentsEffortMax object { type }`
Maximum effort. Favors reasoning depth over latency.
- `type: "max"`
- `"max"`
- `inference_geo: optional string`
Geographic region for model inference. When unset, requests fall through to the workspace's default_inference_geo.
- `speed: optional "standard" or "fast"`
Inference speed mode. `fast` provides significantly faster output token generation at premium pricing. Not all models support `fast`; invalid combinations are rejected at create time.
- `"standard"`
- `"fast"`
- `name: string`
- `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`
- `BetaManagedAgentsAnthropicSkill object { skill_id, type, version }`
A resolved Anthropic-managed skill.
- `skill_id: string`
- `type: "anthropic"`
- `"anthropic"`
- `version: string`
- `BetaManagedAgentsCustomSkill object { skill_id, type, version }`
A resolved user-created custom skill.
- `skill_id: string`
- `type: "custom"`
- `"custom"`
- `version: string`
- `system: string or null`
- `tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool`
- `BetaManagedAgentsAgentToolset20260401 object { configs, default_config, type }`
- `configs: array of BetaManagedAgentsAgentToolConfig`
- `enabled: boolean`
- `name: "bash" or "edit" or "read" or 5 more`
Cut at 300 lines. The page has the rest.
api/beta/sessions/threads/archive First recorded · 644 lines, first recorded
## Archive Session Thread ### Path Parameters ### Header Parameters ### Returns ### Example #### Response
The first capture of this source. The page was already there, and this is what it said.
---
title: Archive Session Thread
url: https://platform.claude.com/docs/en/api/beta/sessions/threads/archive
---
## Archive Session Thread
**post** `/v1/sessions/{session_id}/threads/{thread_id}/archive`
Archive Session Thread
### Path Parameters
- `session_id: string`
- `thread_id: string`
### Header Parameters
- `"anthropic-beta": optional array of AnthropicBeta`
Optional header to specify the beta version(s) you want to use.
- `string`
- `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
- `"message-batches-2024-09-24"`
- `"prompt-caching-2024-07-31"`
- `"computer-use-2024-10-22"`
- `"computer-use-2025-01-24"`
- `"pdfs-2024-09-25"`
- `"token-counting-2024-11-01"`
- `"token-efficient-tools-2025-02-19"`
- `"output-128k-2025-02-19"`
- `"files-api-2025-04-14"`
- `"mcp-client-2025-04-04"`
- `"mcp-client-2025-11-20"`
- `"dev-full-thinking-2025-05-14"`
- `"interleaved-thinking-2025-05-14"`
- `"code-execution-2025-05-22"`
- `"extended-cache-ttl-2025-04-11"`
- `"context-1m-2025-08-07"`
- `"context-management-2025-06-27"`
- `"model-context-window-exceeded-2025-08-26"`
- `"skills-2025-10-02"`
- `"fast-mode-2026-02-01"`
- `"output-300k-2026-03-24"`
- `"user-profiles-2026-03-24"`
- `"advisor-tool-2026-03-01"`
- `"managed-agents-2026-04-01"`
- `"cache-diagnosis-2026-04-07"`
- `"dreaming-2026-04-21"`
- `"thinking-token-count-2026-05-13"`
- `"server-side-fallback-2026-06-01"`
- `"server-side-fallback-2026-07-01"`
- `"fallback-credit-2026-06-01"`
- `"fallback-credit-2026-07-01"`
- `"agent-memory-2026-07-22"`
- `"mid-conversation-tool-changes-2026-07-01"`
### Returns
- `BetaManagedAgentsSessionThread object { id, agent, archived_at, 8 more }`
An execution thread within a `session`. Each session has one primary thread plus zero or more child threads spawned by the coordinator.
- `id: string`
Unique identifier for this thread.
- `agent: BetaManagedAgentsSessionThreadAgent or BetaManagedAgentsAdvisor`
A session-resolved multiagent roster entry.
- `BetaManagedAgentsSessionThreadAgent object { id, description, mcp_servers, 7 more }`
Resolved `agent` definition for a single `session_thread`. Snapshot of the agent at thread creation time. The multiagent roster is not repeated here; read it from `Session.agent`.
- `id: string`
- `description: string or null`
- `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
- `name: string`
- `type: "url"`
- `"url"`
- `url: string`
- `model: BetaManagedAgentsModelConfig`
Model identifier and configuration.
- `id: BetaManagedAgentsModel`
The model that will power your agent.
See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
- `"claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more`
The model that will power your agent.
See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
- `"claude-sonnet-5"`
High-performance model for coding and agents
- `"claude-fable-5"`
Next generation of intelligence for the hardest knowledge work and coding problems
- `"claude-opus-5"`
Powerful intelligence for long-running agents and coding
- `"claude-opus-4-8"`
Powerful intelligence for long-running agents and coding
- `"claude-opus-4-7"`
Powerful intelligence for long-running agents and coding
- `"claude-opus-4-6"`
Powerful intelligence for long-running agents and coding
- `"claude-sonnet-4-6"`
Best combination of speed and intelligence
- `"claude-haiku-4-5"`
Fastest model with near-frontier intelligence
- `"claude-haiku-4-5-20251001"`
Fastest model with near-frontier intelligence
- `"claude-opus-4-5"`
Powerful intelligence for long-running agents and coding
- `"claude-opus-4-5-20251101"`
Powerful intelligence for long-running agents and coding
- `"claude-sonnet-4-5"`
High-performance model for agents and coding
- `"claude-sonnet-4-5-20250929"`
High-performance model for agents and coding
- `string`
- `effort: optional BetaManagedAgentsEffortLow or BetaManagedAgentsEffortMedium or BetaManagedAgentsEffortHigh or 2 more`
How hard Claude works on each turn. Sets `output_config.effort` on every Messages call the session makes.
- `BetaManagedAgentsEffortLow object { type }`
Low effort. Favors latency over reasoning depth.
- `type: "low"`
- `"low"`
- `BetaManagedAgentsEffortMedium object { type }`
Medium effort. Balances latency and reasoning depth.
- `type: "medium"`
- `"medium"`
- `BetaManagedAgentsEffortHigh object { type }`
High effort. Favors reasoning depth.
- `type: "high"`
- `"high"`
- `BetaManagedAgentsEffortXhigh object { type }`
Extra-high effort. Not all models accept this level.
- `type: "xhigh"`
- `"xhigh"`
- `BetaManagedAgentsEffortMax object { type }`
Maximum effort. Favors reasoning depth over latency.
- `type: "max"`
- `"max"`
- `inference_geo: optional string`
Geographic region for model inference. When unset, requests fall through to the workspace's default_inference_geo.
- `speed: optional "standard" or "fast"`
Inference speed mode. `fast` provides significantly faster output token generation at premium pricing. Not all models support `fast`; invalid combinations are rejected at create time.
- `"standard"`
- `"fast"`
- `name: string`
- `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`
- `BetaManagedAgentsAnthropicSkill object { skill_id, type, version }`
A resolved Anthropic-managed skill.
- `skill_id: string`
- `type: "anthropic"`
- `"anthropic"`
- `version: string`
- `BetaManagedAgentsCustomSkill object { skill_id, type, version }`
A resolved user-created custom skill.
- `skill_id: string`
- `type: "custom"`
- `"custom"`
- `version: string`
- `system: string or null`
- `tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool`
- `BetaManagedAgentsAgentToolset20260401 object { configs, default_config, type }`
- `configs: array of BetaManagedAgentsAgentToolConfig`
- `enabled: boolean`
- `name: "bash" or "edit" or "read" or 5 more`
Built-in agent tool identifier.
- `"bash"`
- `"edit"`
- `"read"`
- `"write"`
Cut at 300 lines. The page has the rest.
api/beta/sessions/threads/events First recorded · 4285 lines, first recorded
# Events ## List Session Thread Events ### Path Parameters ### Query Parameters ### Header Parameters ### Returns ### Example #### Response ## Stream Session Thread Events ### Path Parameters ### Query Parameters ### Header Parameters ### Returns ### Example #### Response
The first capture of this source. The page was already there, and this is what it said.
---
title: Events
url: https://platform.claude.com/docs/en/api/beta/sessions/threads/events
---
# Events
## List Session Thread Events
**get** `/v1/sessions/{session_id}/threads/{thread_id}/events`
List Session Thread Events
### Path Parameters
- `session_id: string`
- `thread_id: string`
### Query Parameters
- `limit: optional number`
Query parameter for limit
- `page: optional string`
Query parameter for page
### Header Parameters
- `"anthropic-beta": optional array of AnthropicBeta`
Optional header to specify the beta version(s) you want to use.
- `string`
- `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
- `"message-batches-2024-09-24"`
- `"prompt-caching-2024-07-31"`
- `"computer-use-2024-10-22"`
- `"computer-use-2025-01-24"`
- `"pdfs-2024-09-25"`
- `"token-counting-2024-11-01"`
- `"token-efficient-tools-2025-02-19"`
- `"output-128k-2025-02-19"`
- `"files-api-2025-04-14"`
- `"mcp-client-2025-04-04"`
- `"mcp-client-2025-11-20"`
- `"dev-full-thinking-2025-05-14"`
- `"interleaved-thinking-2025-05-14"`
- `"code-execution-2025-05-22"`
- `"extended-cache-ttl-2025-04-11"`
- `"context-1m-2025-08-07"`
- `"context-management-2025-06-27"`
- `"model-context-window-exceeded-2025-08-26"`
- `"skills-2025-10-02"`
- `"fast-mode-2026-02-01"`
- `"output-300k-2026-03-24"`
- `"user-profiles-2026-03-24"`
- `"advisor-tool-2026-03-01"`
- `"managed-agents-2026-04-01"`
- `"cache-diagnosis-2026-04-07"`
- `"dreaming-2026-04-21"`
- `"thinking-token-count-2026-05-13"`
- `"server-side-fallback-2026-06-01"`
- `"server-side-fallback-2026-07-01"`
- `"fallback-credit-2026-06-01"`
- `"fallback-credit-2026-07-01"`
- `"agent-memory-2026-07-22"`
- `"mid-conversation-tool-changes-2026-07-01"`
### Returns
- `data: optional array of BetaManagedAgentsSessionEvent`
Events for the thread, ordered by `processed_at`.
- `BetaManagedAgentsUserMessageEvent object { id, content, type, processed_at }`
A user message event in the session conversation.
- `id: string`
Unique identifier for this event.
- `content: array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsRedactedBlock`
Array of content blocks comprising the user message.
- `BetaManagedAgentsTextBlock object { text, type }`
Regular text content.
- `text: string`
The text content.
- `type: "text"`
- `"text"`
- `BetaManagedAgentsImageBlock object { source, type }`
Image content specified directly as base64 data or as a reference via a URL.
- `source: BetaManagedAgentsBase64ImageSource or BetaManagedAgentsURLImageSource or BetaManagedAgentsFileImageSource`
Union type for image source variants.
- `BetaManagedAgentsBase64ImageSource object { data, media_type, type }`
Base64-encoded image data.
- `data: string`
Base64-encoded image data.
- `media_type: string`
MIME type of the image (e.g., "image/png", "image/jpeg", "image/gif", "image/webp").
- `type: "base64"`
- `"base64"`
- `BetaManagedAgentsURLImageSource object { type, url }`
Image referenced by URL.
- `type: "url"`
- `"url"`
- `url: string`
URL of the image to fetch.
- `BetaManagedAgentsFileImageSource object { file_id, type }`
Image referenced by file ID.
- `file_id: string`
ID of a previously uploaded file.
- `type: "file"`
- `"file"`
- `type: "image"`
- `"image"`
- `BetaManagedAgentsDocumentBlock object { source, type, context, title }`
Document content, either specified directly as base64 data, as text, or as a reference via a URL.
- `source: BetaManagedAgentsBase64DocumentSource or BetaManagedAgentsPlainTextDocumentSource or BetaManagedAgentsURLDocumentSource or BetaManagedAgentsFileDocumentSource`
Union type for document source variants.
- `BetaManagedAgentsBase64DocumentSource object { data, media_type, type }`
Base64-encoded document data.
- `data: string`
Base64-encoded document data.
- `media_type: string`
MIME type of the document (e.g., "application/pdf").
- `type: "base64"`
- `"base64"`
- `BetaManagedAgentsPlainTextDocumentSource object { data, media_type, type }`
Plain text document content.
- `data: string`
The plain text content.
- `media_type: "text/plain"`
MIME type of the text content. Must be "text/plain".
- `"text/plain"`
- `type: "text"`
- `"text"`
- `BetaManagedAgentsURLDocumentSource object { type, url }`
Document referenced by URL.
- `type: "url"`
- `"url"`
- `url: string`
URL of the document to fetch.
- `BetaManagedAgentsFileDocumentSource object { file_id, type }`
Document referenced by file ID.
- `file_id: string`
ID of a previously uploaded file.
- `type: "file"`
- `"file"`
- `type: "document"`
- `"document"`
- `context: optional string or null`
Additional context about the document for the model.
- `title: optional string or null`
The title of the document.
- `BetaManagedAgentsRedactedBlock object { type }`
Placeholder for content withheld by Anthropic model policy.
- `type: "redacted"`
- `"redacted"`
- `type: "user.message"`
- `"user.message"`
- `processed_at: optional string or null`
A timestamp in RFC 3339 format
- `BetaManagedAgentsUserInterruptEvent object { id, type, processed_at, session_thread_id }`
An interrupt event that pauses agent execution and returns control to the user.
- `id: string`
Unique identifier for this event.
- `type: "user.interrupt"`
- `"user.interrupt"`
- `processed_at: optional string or null`
A timestamp in RFC 3339 format
- `session_thread_id: optional string or null`
If absent, interrupts every non-archived thread in a multiagent session (or the primary alone in a single-agent session). If present, interrupts only the named thread.
Cut at 300 lines. The page has the rest.
api/beta/sessions/threads/events/list First recorded · 2118 lines, first recorded
## List Session Thread Events ### Path Parameters ### Query Parameters ### Header Parameters ### Returns ### Example #### Response
The first capture of this source. The page was already there, and this is what it said.
---
title: List Session Thread Events
url: https://platform.claude.com/docs/en/api/beta/sessions/threads/events/list
---
## List Session Thread Events
**get** `/v1/sessions/{session_id}/threads/{thread_id}/events`
List Session Thread Events
### Path Parameters
- `session_id: string`
- `thread_id: string`
### Query Parameters
- `limit: optional number`
Query parameter for limit
- `page: optional string`
Query parameter for page
### Header Parameters
- `"anthropic-beta": optional array of AnthropicBeta`
Optional header to specify the beta version(s) you want to use.
- `string`
- `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
- `"message-batches-2024-09-24"`
- `"prompt-caching-2024-07-31"`
- `"computer-use-2024-10-22"`
- `"computer-use-2025-01-24"`
- `"pdfs-2024-09-25"`
- `"token-counting-2024-11-01"`
- `"token-efficient-tools-2025-02-19"`
- `"output-128k-2025-02-19"`
- `"files-api-2025-04-14"`
- `"mcp-client-2025-04-04"`
- `"mcp-client-2025-11-20"`
- `"dev-full-thinking-2025-05-14"`
- `"interleaved-thinking-2025-05-14"`
- `"code-execution-2025-05-22"`
- `"extended-cache-ttl-2025-04-11"`
- `"context-1m-2025-08-07"`
- `"context-management-2025-06-27"`
- `"model-context-window-exceeded-2025-08-26"`
- `"skills-2025-10-02"`
- `"fast-mode-2026-02-01"`
- `"output-300k-2026-03-24"`
- `"user-profiles-2026-03-24"`
- `"advisor-tool-2026-03-01"`
- `"managed-agents-2026-04-01"`
- `"cache-diagnosis-2026-04-07"`
- `"dreaming-2026-04-21"`
- `"thinking-token-count-2026-05-13"`
- `"server-side-fallback-2026-06-01"`
- `"server-side-fallback-2026-07-01"`
- `"fallback-credit-2026-06-01"`
- `"fallback-credit-2026-07-01"`
- `"agent-memory-2026-07-22"`
- `"mid-conversation-tool-changes-2026-07-01"`
### Returns
- `data: optional array of BetaManagedAgentsSessionEvent`
Events for the thread, ordered by `processed_at`.
- `BetaManagedAgentsUserMessageEvent object { id, content, type, processed_at }`
A user message event in the session conversation.
- `id: string`
Unique identifier for this event.
- `content: array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsRedactedBlock`
Array of content blocks comprising the user message.
- `BetaManagedAgentsTextBlock object { text, type }`
Regular text content.
- `text: string`
The text content.
- `type: "text"`
- `"text"`
- `BetaManagedAgentsImageBlock object { source, type }`
Image content specified directly as base64 data or as a reference via a URL.
- `source: BetaManagedAgentsBase64ImageSource or BetaManagedAgentsURLImageSource or BetaManagedAgentsFileImageSource`
Union type for image source variants.
- `BetaManagedAgentsBase64ImageSource object { data, media_type, type }`
Base64-encoded image data.
- `data: string`
Base64-encoded image data.
- `media_type: string`
MIME type of the image (e.g., "image/png", "image/jpeg", "image/gif", "image/webp").
- `type: "base64"`
- `"base64"`
- `BetaManagedAgentsURLImageSource object { type, url }`
Image referenced by URL.
- `type: "url"`
- `"url"`
- `url: string`
URL of the image to fetch.
- `BetaManagedAgentsFileImageSource object { file_id, type }`
Image referenced by file ID.
- `file_id: string`
ID of a previously uploaded file.
- `type: "file"`
- `"file"`
- `type: "image"`
- `"image"`
- `BetaManagedAgentsDocumentBlock object { source, type, context, title }`
Document content, either specified directly as base64 data, as text, or as a reference via a URL.
- `source: BetaManagedAgentsBase64DocumentSource or BetaManagedAgentsPlainTextDocumentSource or BetaManagedAgentsURLDocumentSource or BetaManagedAgentsFileDocumentSource`
Union type for document source variants.
- `BetaManagedAgentsBase64DocumentSource object { data, media_type, type }`
Base64-encoded document data.
- `data: string`
Base64-encoded document data.
- `media_type: string`
MIME type of the document (e.g., "application/pdf").
- `type: "base64"`
- `"base64"`
- `BetaManagedAgentsPlainTextDocumentSource object { data, media_type, type }`
Plain text document content.
- `data: string`
The plain text content.
- `media_type: "text/plain"`
MIME type of the text content. Must be "text/plain".
- `"text/plain"`
- `type: "text"`
- `"text"`
- `BetaManagedAgentsURLDocumentSource object { type, url }`
Document referenced by URL.
- `type: "url"`
- `"url"`
- `url: string`
URL of the document to fetch.
- `BetaManagedAgentsFileDocumentSource object { file_id, type }`
Document referenced by file ID.
- `file_id: string`
ID of a previously uploaded file.
- `type: "file"`
- `"file"`
- `type: "document"`
- `"document"`
- `context: optional string or null`
Additional context about the document for the model.
- `title: optional string or null`
The title of the document.
- `BetaManagedAgentsRedactedBlock object { type }`
Placeholder for content withheld by Anthropic model policy.
- `type: "redacted"`
- `"redacted"`
- `type: "user.message"`
- `"user.message"`
- `processed_at: optional string or null`
A timestamp in RFC 3339 format
- `BetaManagedAgentsUserInterruptEvent object { id, type, processed_at, session_thread_id }`
An interrupt event that pauses agent execution and returns control to the user.
- `id: string`
Unique identifier for this event.
- `type: "user.interrupt"`
- `"user.interrupt"`
- `processed_at: optional string or null`
A timestamp in RFC 3339 format
- `session_thread_id: optional string or null`
If absent, interrupts every non-archived thread in a multiagent session (or the primary alone in a single-agent session). If present, interrupts only the named thread.
- `BetaManagedAgentsUserToolConfirmationEvent object { id, result, tool_use_id, 4 more }`
Cut at 300 lines. The page has the rest.
api/beta/sessions/threads/events/stream First recorded · 2169 lines, first recorded
## Stream Session Thread Events ### Path Parameters ### Query Parameters ### Header Parameters ### Returns ### Example #### Response
The first capture of this source. The page was already there, and this is what it said.
---
title: Stream Session Thread Events
url: https://platform.claude.com/docs/en/api/beta/sessions/threads/events/stream
---
## Stream Session Thread Events
**get** `/v1/sessions/{session_id}/threads/{thread_id}/stream`
Stream Session Thread Events
### Path Parameters
- `session_id: string`
- `thread_id: string`
### Query Parameters
- `event_deltas: optional array of BetaManagedAgentsDeltaType`
When set, this connection also receives streaming deltas (`event_start`, `event_delta`) while an event is being produced, before the event itself arrives. Deltas are best-effort; when the final event is produced it carries the complete content. A model request that ends early (an error or interrupt) produces no final event — its terminal `span.model_request_end` closes the preview. Accepts one or more event types to preview and may be repeated: `agent.message` streams `content_delta` fragments; `agent.thinking` is start-only — a signal that the agent has begun extended thinking, concluded by the `agent.thinking` event itself. Only previews of the requested event types are sent.
- `"agent.message"`
- `"agent.thinking"`
### Header Parameters
- `"anthropic-beta": optional array of AnthropicBeta`
Optional header to specify the beta version(s) you want to use.
- `string`
- `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
- `"message-batches-2024-09-24"`
- `"prompt-caching-2024-07-31"`
- `"computer-use-2024-10-22"`
- `"computer-use-2025-01-24"`
- `"pdfs-2024-09-25"`
- `"token-counting-2024-11-01"`
- `"token-efficient-tools-2025-02-19"`
- `"output-128k-2025-02-19"`
- `"files-api-2025-04-14"`
- `"mcp-client-2025-04-04"`
- `"mcp-client-2025-11-20"`
- `"dev-full-thinking-2025-05-14"`
- `"interleaved-thinking-2025-05-14"`
- `"code-execution-2025-05-22"`
- `"extended-cache-ttl-2025-04-11"`
- `"context-1m-2025-08-07"`
- `"context-management-2025-06-27"`
- `"model-context-window-exceeded-2025-08-26"`
- `"skills-2025-10-02"`
- `"fast-mode-2026-02-01"`
- `"output-300k-2026-03-24"`
- `"user-profiles-2026-03-24"`
- `"advisor-tool-2026-03-01"`
- `"managed-agents-2026-04-01"`
- `"cache-diagnosis-2026-04-07"`
- `"dreaming-2026-04-21"`
- `"thinking-token-count-2026-05-13"`
- `"server-side-fallback-2026-06-01"`
- `"server-side-fallback-2026-07-01"`
- `"fallback-credit-2026-06-01"`
- `"fallback-credit-2026-07-01"`
- `"agent-memory-2026-07-22"`
- `"mid-conversation-tool-changes-2026-07-01"`
### Returns
- `BetaManagedAgentsStreamSessionThreadEvents = BetaManagedAgentsUserMessageEvent or BetaManagedAgentsUserInterruptEvent or BetaManagedAgentsUserToolConfirmationEvent or 34 more`
Server-sent event in a single thread's stream.
- `BetaManagedAgentsUserMessageEvent object { id, content, type, processed_at }`
A user message event in the session conversation.
- `id: string`
Unique identifier for this event.
- `content: array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsRedactedBlock`
Array of content blocks comprising the user message.
- `BetaManagedAgentsTextBlock object { text, type }`
Regular text content.
- `text: string`
The text content.
- `type: "text"`
- `"text"`
- `BetaManagedAgentsImageBlock object { source, type }`
Image content specified directly as base64 data or as a reference via a URL.
- `source: BetaManagedAgentsBase64ImageSource or BetaManagedAgentsURLImageSource or BetaManagedAgentsFileImageSource`
Union type for image source variants.
- `BetaManagedAgentsBase64ImageSource object { data, media_type, type }`
Base64-encoded image data.
- `data: string`
Base64-encoded image data.
- `media_type: string`
MIME type of the image (e.g., "image/png", "image/jpeg", "image/gif", "image/webp").
- `type: "base64"`
- `"base64"`
- `BetaManagedAgentsURLImageSource object { type, url }`
Image referenced by URL.
- `type: "url"`
- `"url"`
- `url: string`
URL of the image to fetch.
- `BetaManagedAgentsFileImageSource object { file_id, type }`
Image referenced by file ID.
- `file_id: string`
ID of a previously uploaded file.
- `type: "file"`
- `"file"`
- `type: "image"`
- `"image"`
- `BetaManagedAgentsDocumentBlock object { source, type, context, title }`
Document content, either specified directly as base64 data, as text, or as a reference via a URL.
- `source: BetaManagedAgentsBase64DocumentSource or BetaManagedAgentsPlainTextDocumentSource or BetaManagedAgentsURLDocumentSource or BetaManagedAgentsFileDocumentSource`
Union type for document source variants.
- `BetaManagedAgentsBase64DocumentSource object { data, media_type, type }`
Base64-encoded document data.
- `data: string`
Base64-encoded document data.
- `media_type: string`
MIME type of the document (e.g., "application/pdf").
- `type: "base64"`
- `"base64"`
- `BetaManagedAgentsPlainTextDocumentSource object { data, media_type, type }`
Plain text document content.
- `data: string`
The plain text content.
- `media_type: "text/plain"`
MIME type of the text content. Must be "text/plain".
- `"text/plain"`
- `type: "text"`
- `"text"`
- `BetaManagedAgentsURLDocumentSource object { type, url }`
Document referenced by URL.
- `type: "url"`
- `"url"`
- `url: string`
URL of the document to fetch.
- `BetaManagedAgentsFileDocumentSource object { file_id, type }`
Document referenced by file ID.
- `file_id: string`
ID of a previously uploaded file.
- `type: "file"`
- `"file"`
- `type: "document"`
- `"document"`
- `context: optional string or null`
Additional context about the document for the model.
- `title: optional string or null`
The title of the document.
- `BetaManagedAgentsRedactedBlock object { type }`
Placeholder for content withheld by Anthropic model policy.
- `type: "redacted"`
- `"redacted"`
- `type: "user.message"`
- `"user.message"`
- `processed_at: optional string or null`
A timestamp in RFC 3339 format
- `BetaManagedAgentsUserInterruptEvent object { id, type, processed_at, session_thread_id }`
An interrupt event that pauses agent execution and returns control to the user.
- `id: string`
Unique identifier for this event.
- `type: "user.interrupt"`
- `"user.interrupt"`
- `processed_at: optional string or null`
A timestamp in RFC 3339 format
- `session_thread_id: optional string or null`
If absent, interrupts every non-archived thread in a multiagent session (or the primary alone in a single-agent session). If present, interrupts only the named thread.
- `BetaManagedAgentsUserToolConfirmationEvent object { id, result, tool_use_id, 4 more }`
Cut at 300 lines. The page has the rest.
api/beta/sessions/threads/list First recorded · 660 lines, first recorded
## List Session Threads ### Path Parameters ### Query Parameters ### Header Parameters ### Returns ### Example #### Response
The first capture of this source. The page was already there, and this is what it said.
---
title: List Session Threads
url: https://platform.claude.com/docs/en/api/beta/sessions/threads/list
---
## List Session Threads
**get** `/v1/sessions/{session_id}/threads`
List Session Threads
### Path Parameters
- `session_id: string`
### Query Parameters
- `limit: optional number`
Maximum results per page. Defaults to 1000.
- `page: optional string`
Opaque pagination cursor from a previous response's next_page. Forward-only.
### Header Parameters
- `"anthropic-beta": optional array of AnthropicBeta`
Optional header to specify the beta version(s) you want to use.
- `string`
- `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
- `"message-batches-2024-09-24"`
- `"prompt-caching-2024-07-31"`
- `"computer-use-2024-10-22"`
- `"computer-use-2025-01-24"`
- `"pdfs-2024-09-25"`
- `"token-counting-2024-11-01"`
- `"token-efficient-tools-2025-02-19"`
- `"output-128k-2025-02-19"`
- `"files-api-2025-04-14"`
- `"mcp-client-2025-04-04"`
- `"mcp-client-2025-11-20"`
- `"dev-full-thinking-2025-05-14"`
- `"interleaved-thinking-2025-05-14"`
- `"code-execution-2025-05-22"`
- `"extended-cache-ttl-2025-04-11"`
- `"context-1m-2025-08-07"`
- `"context-management-2025-06-27"`
- `"model-context-window-exceeded-2025-08-26"`
- `"skills-2025-10-02"`
- `"fast-mode-2026-02-01"`
- `"output-300k-2026-03-24"`
- `"user-profiles-2026-03-24"`
- `"advisor-tool-2026-03-01"`
- `"managed-agents-2026-04-01"`
- `"cache-diagnosis-2026-04-07"`
- `"dreaming-2026-04-21"`
- `"thinking-token-count-2026-05-13"`
- `"server-side-fallback-2026-06-01"`
- `"server-side-fallback-2026-07-01"`
- `"fallback-credit-2026-06-01"`
- `"fallback-credit-2026-07-01"`
- `"agent-memory-2026-07-22"`
- `"mid-conversation-tool-changes-2026-07-01"`
### Returns
- `data: optional array of BetaManagedAgentsSessionThread`
Threads in the session, primary first then children in spawn order.
- `id: string`
Unique identifier for this thread.
- `agent: BetaManagedAgentsSessionThreadAgent or BetaManagedAgentsAdvisor`
A session-resolved multiagent roster entry.
- `BetaManagedAgentsSessionThreadAgent object { id, description, mcp_servers, 7 more }`
Resolved `agent` definition for a single `session_thread`. Snapshot of the agent at thread creation time. The multiagent roster is not repeated here; read it from `Session.agent`.
- `id: string`
- `description: string or null`
- `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
- `name: string`
- `type: "url"`
- `"url"`
- `url: string`
- `model: BetaManagedAgentsModelConfig`
Model identifier and configuration.
- `id: BetaManagedAgentsModel`
The model that will power your agent.
See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
- `"claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more`
The model that will power your agent.
See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
- `"claude-sonnet-5"`
High-performance model for coding and agents
- `"claude-fable-5"`
Next generation of intelligence for the hardest knowledge work and coding problems
- `"claude-opus-5"`
Powerful intelligence for long-running agents and coding
- `"claude-opus-4-8"`
Powerful intelligence for long-running agents and coding
- `"claude-opus-4-7"`
Powerful intelligence for long-running agents and coding
- `"claude-opus-4-6"`
Powerful intelligence for long-running agents and coding
- `"claude-sonnet-4-6"`
Best combination of speed and intelligence
- `"claude-haiku-4-5"`
Fastest model with near-frontier intelligence
- `"claude-haiku-4-5-20251001"`
Fastest model with near-frontier intelligence
- `"claude-opus-4-5"`
Powerful intelligence for long-running agents and coding
- `"claude-opus-4-5-20251101"`
Powerful intelligence for long-running agents and coding
- `"claude-sonnet-4-5"`
High-performance model for agents and coding
- `"claude-sonnet-4-5-20250929"`
High-performance model for agents and coding
- `string`
- `effort: optional BetaManagedAgentsEffortLow or BetaManagedAgentsEffortMedium or BetaManagedAgentsEffortHigh or 2 more`
How hard Claude works on each turn. Sets `output_config.effort` on every Messages call the session makes.
- `BetaManagedAgentsEffortLow object { type }`
Low effort. Favors latency over reasoning depth.
- `type: "low"`
- `"low"`
- `BetaManagedAgentsEffortMedium object { type }`
Medium effort. Balances latency and reasoning depth.
- `type: "medium"`
- `"medium"`
- `BetaManagedAgentsEffortHigh object { type }`
High effort. Favors reasoning depth.
- `type: "high"`
- `"high"`
- `BetaManagedAgentsEffortXhigh object { type }`
Extra-high effort. Not all models accept this level.
- `type: "xhigh"`
- `"xhigh"`
- `BetaManagedAgentsEffortMax object { type }`
Maximum effort. Favors reasoning depth over latency.
- `type: "max"`
- `"max"`
- `inference_geo: optional string`
Geographic region for model inference. When unset, requests fall through to the workspace's default_inference_geo.
- `speed: optional "standard" or "fast"`
Inference speed mode. `fast` provides significantly faster output token generation at premium pricing. Not all models support `fast`; invalid combinations are rejected at create time.
- `"standard"`
- `"fast"`
- `name: string`
- `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`
- `BetaManagedAgentsAnthropicSkill object { skill_id, type, version }`
A resolved Anthropic-managed skill.
- `skill_id: string`
- `type: "anthropic"`
- `"anthropic"`
- `version: string`
- `BetaManagedAgentsCustomSkill object { skill_id, type, version }`
A resolved user-created custom skill.
- `skill_id: string`
- `type: "custom"`
- `"custom"`
- `version: string`
- `system: string or null`
- `tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool`
- `BetaManagedAgentsAgentToolset20260401 object { configs, default_config, type }`
- `configs: array of BetaManagedAgentsAgentToolConfig`
- `enabled: boolean`
- `name: "bash" or "edit" or "read" or 5 more`
Built-in agent tool identifier.
Cut at 300 lines. The page has the rest.
api/beta/sessions/threads/retrieve First recorded · 643 lines, first recorded
## Get Session Thread ### Path Parameters ### Header Parameters ### Returns ### Example #### Response
The first capture of this source. The page was already there, and this is what it said.
---
title: Get Session Thread
url: https://platform.claude.com/docs/en/api/beta/sessions/threads/retrieve
---
## Get Session Thread
**get** `/v1/sessions/{session_id}/threads/{thread_id}`
Get Session Thread
### Path Parameters
- `session_id: string`
- `thread_id: string`
### Header Parameters
- `"anthropic-beta": optional array of AnthropicBeta`
Optional header to specify the beta version(s) you want to use.
- `string`
- `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
- `"message-batches-2024-09-24"`
- `"prompt-caching-2024-07-31"`
- `"computer-use-2024-10-22"`
- `"computer-use-2025-01-24"`
- `"pdfs-2024-09-25"`
- `"token-counting-2024-11-01"`
- `"token-efficient-tools-2025-02-19"`
- `"output-128k-2025-02-19"`
- `"files-api-2025-04-14"`
- `"mcp-client-2025-04-04"`
- `"mcp-client-2025-11-20"`
- `"dev-full-thinking-2025-05-14"`
- `"interleaved-thinking-2025-05-14"`
- `"code-execution-2025-05-22"`
- `"extended-cache-ttl-2025-04-11"`
- `"context-1m-2025-08-07"`
- `"context-management-2025-06-27"`
- `"model-context-window-exceeded-2025-08-26"`
- `"skills-2025-10-02"`
- `"fast-mode-2026-02-01"`
- `"output-300k-2026-03-24"`
- `"user-profiles-2026-03-24"`
- `"advisor-tool-2026-03-01"`
- `"managed-agents-2026-04-01"`
- `"cache-diagnosis-2026-04-07"`
- `"dreaming-2026-04-21"`
- `"thinking-token-count-2026-05-13"`
- `"server-side-fallback-2026-06-01"`
- `"server-side-fallback-2026-07-01"`
- `"fallback-credit-2026-06-01"`
- `"fallback-credit-2026-07-01"`
- `"agent-memory-2026-07-22"`
- `"mid-conversation-tool-changes-2026-07-01"`
### Returns
- `BetaManagedAgentsSessionThread object { id, agent, archived_at, 8 more }`
An execution thread within a `session`. Each session has one primary thread plus zero or more child threads spawned by the coordinator.
- `id: string`
Unique identifier for this thread.
- `agent: BetaManagedAgentsSessionThreadAgent or BetaManagedAgentsAdvisor`
A session-resolved multiagent roster entry.
- `BetaManagedAgentsSessionThreadAgent object { id, description, mcp_servers, 7 more }`
Resolved `agent` definition for a single `session_thread`. Snapshot of the agent at thread creation time. The multiagent roster is not repeated here; read it from `Session.agent`.
- `id: string`
- `description: string or null`
- `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
- `name: string`
- `type: "url"`
- `"url"`
- `url: string`
- `model: BetaManagedAgentsModelConfig`
Model identifier and configuration.
- `id: BetaManagedAgentsModel`
The model that will power your agent.
See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
- `"claude-sonnet-5" or "claude-fable-5" or "claude-opus-5" or 10 more`
The model that will power your agent.
See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
- `"claude-sonnet-5"`
High-performance model for coding and agents
- `"claude-fable-5"`
Next generation of intelligence for the hardest knowledge work and coding problems
- `"claude-opus-5"`
Powerful intelligence for long-running agents and coding
- `"claude-opus-4-8"`
Powerful intelligence for long-running agents and coding
- `"claude-opus-4-7"`
Powerful intelligence for long-running agents and coding
- `"claude-opus-4-6"`
Powerful intelligence for long-running agents and coding
- `"claude-sonnet-4-6"`
Best combination of speed and intelligence
- `"claude-haiku-4-5"`
Fastest model with near-frontier intelligence
- `"claude-haiku-4-5-20251001"`
Fastest model with near-frontier intelligence
- `"claude-opus-4-5"`
Powerful intelligence for long-running agents and coding
- `"claude-opus-4-5-20251101"`
Powerful intelligence for long-running agents and coding
- `"claude-sonnet-4-5"`
High-performance model for agents and coding
- `"claude-sonnet-4-5-20250929"`
High-performance model for agents and coding
- `string`
- `effort: optional BetaManagedAgentsEffortLow or BetaManagedAgentsEffortMedium or BetaManagedAgentsEffortHigh or 2 more`
How hard Claude works on each turn. Sets `output_config.effort` on every Messages call the session makes.
- `BetaManagedAgentsEffortLow object { type }`
Low effort. Favors latency over reasoning depth.
- `type: "low"`
- `"low"`
- `BetaManagedAgentsEffortMedium object { type }`
Medium effort. Balances latency and reasoning depth.
- `type: "medium"`
- `"medium"`
- `BetaManagedAgentsEffortHigh object { type }`
High effort. Favors reasoning depth.
- `type: "high"`
- `"high"`
- `BetaManagedAgentsEffortXhigh object { type }`
Extra-high effort. Not all models accept this level.
- `type: "xhigh"`
- `"xhigh"`
- `BetaManagedAgentsEffortMax object { type }`
Maximum effort. Favors reasoning depth over latency.
- `type: "max"`
- `"max"`
- `inference_geo: optional string`
Geographic region for model inference. When unset, requests fall through to the workspace's default_inference_geo.
- `speed: optional "standard" or "fast"`
Inference speed mode. `fast` provides significantly faster output token generation at premium pricing. Not all models support `fast`; invalid combinations are rejected at create time.
- `"standard"`
- `"fast"`
- `name: string`
- `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`
- `BetaManagedAgentsAnthropicSkill object { skill_id, type, version }`
A resolved Anthropic-managed skill.
- `skill_id: string`
- `type: "anthropic"`
- `"anthropic"`
- `version: string`
- `BetaManagedAgentsCustomSkill object { skill_id, type, version }`
A resolved user-created custom skill.
- `skill_id: string`
- `type: "custom"`
- `"custom"`
- `version: string`
- `system: string or null`
- `tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool`
- `BetaManagedAgentsAgentToolset20260401 object { configs, default_config, type }`
- `configs: array of BetaManagedAgentsAgentToolConfig`
- `enabled: boolean`
- `name: "bash" or "edit" or "read" or 5 more`
Built-in agent tool identifier.
- `"bash"`
- `"edit"`
- `"read"`
- `"write"`
Cut at 300 lines. The page has the rest.
api/beta/sessions/update First recorded · 1171 lines, first recorded
## Update Session ### Path Parameters ### Header Parameters ### Body Parameters ### Returns ### Example #### Response
The first capture of this source. The page was already there, and this is what it said.
---
title: Update Session
url: https://platform.claude.com/docs/en/api/beta/sessions/update
---
## Update Session
**post** `/v1/sessions/{session_id}`
Update Session
### Path Parameters
- `session_id: string`
### Header Parameters
- `"anthropic-beta": optional array of AnthropicBeta`
Optional header to specify the beta version(s) you want to use.
- `string`
- `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
- `"message-batches-2024-09-24"`
- `"prompt-caching-2024-07-31"`
- `"computer-use-2024-10-22"`
- `"computer-use-2025-01-24"`
- `"pdfs-2024-09-25"`
- `"token-counting-2024-11-01"`
- `"token-efficient-tools-2025-02-19"`
- `"output-128k-2025-02-19"`
- `"files-api-2025-04-14"`
- `"mcp-client-2025-04-04"`
- `"mcp-client-2025-11-20"`
- `"dev-full-thinking-2025-05-14"`
- `"interleaved-thinking-2025-05-14"`
- `"code-execution-2025-05-22"`
- `"extended-cache-ttl-2025-04-11"`
- `"context-1m-2025-08-07"`
- `"context-management-2025-06-27"`
- `"model-context-window-exceeded-2025-08-26"`
- `"skills-2025-10-02"`
- `"fast-mode-2026-02-01"`
- `"output-300k-2026-03-24"`
- `"user-profiles-2026-03-24"`
- `"advisor-tool-2026-03-01"`
- `"managed-agents-2026-04-01"`
- `"cache-diagnosis-2026-04-07"`
- `"dreaming-2026-04-21"`
- `"thinking-token-count-2026-05-13"`
- `"server-side-fallback-2026-06-01"`
- `"server-side-fallback-2026-07-01"`
- `"fallback-credit-2026-06-01"`
- `"fallback-credit-2026-07-01"`
- `"agent-memory-2026-07-22"`
- `"mid-conversation-tool-changes-2026-07-01"`
### Body Parameters
- `agent: optional BetaManagedAgentsSessionAgentUpdate`
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.
- `mcp_servers: optional array of BetaManagedAgentsURLMCPServerParams`
Replacement MCP server list. Full replacement: the provided array becomes the new value. Send an empty array to clear; omit to preserve.
- `name: string`
Unique name for this server, referenced by mcp_toolset configurations. 1-255 characters.
- `type: "url"`
- `"url"`
- `url: string`
Endpoint URL for the MCP server.
- `tools: optional array of BetaManagedAgentsAgentToolset20260401Params or BetaManagedAgentsMCPToolsetParams or BetaManagedAgentsCustomToolParams`
Replacement tool list. Full replacement: the provided array becomes the new value. Send an empty array to clear; omit to preserve.
- `BetaManagedAgentsAgentToolset20260401Params object { type, configs, default_config }`
Configuration for built-in agent tools. Use this to enable or disable groups of tools available to the agent.
- `type: "agent_toolset_20260401"`
- `"agent_toolset_20260401"`
- `configs: optional array of BetaManagedAgentsAgentToolConfigParams`
Per-tool configuration overrides.
- `name: "bash" or "edit" or "read" or 5 more`
Built-in agent tool identifier.
- `"bash"`
- `"edit"`
- `"read"`
- `"write"`
- `"glob"`
- `"grep"`
- `"web_fetch"`
- `"web_search"`
- `enabled: optional boolean or null`
Whether this tool is enabled and available to Claude. Overrides the default_config setting.
- `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
Permission policy for tool execution.
- `BetaManagedAgentsAlwaysAllowPolicy object { type }`
Tool calls are automatically approved without user confirmation.
- `type: "always_allow"`
- `"always_allow"`
- `BetaManagedAgentsAlwaysAskPolicy object { type }`
Tool calls require user confirmation before execution.
- `type: "always_ask"`
- `"always_ask"`
- `default_config: optional BetaManagedAgentsAgentToolsetDefaultConfigParams or null`
Default configuration for all tools in a toolset.
- `enabled: optional boolean or null`
Whether tools are enabled and available to Claude by default. Defaults to true if not specified.
- `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
Permission policy for tool execution.
- `BetaManagedAgentsAlwaysAllowPolicy object { type }`
Tool calls are automatically approved without user confirmation.
- `BetaManagedAgentsAlwaysAskPolicy object { type }`
Tool calls require user confirmation before execution.
- `BetaManagedAgentsMCPToolsetParams object { mcp_server_name, type, configs, default_config }`
Configuration for tools from an MCP server defined in `mcp_servers`.
- `mcp_server_name: string`
Name of the MCP server. Must match a server name from the mcp_servers array. 1-255 characters.
- `type: "mcp_toolset"`
- `"mcp_toolset"`
- `configs: optional array of BetaManagedAgentsMCPToolConfigParams`
Per-tool configuration overrides.
- `name: string`
Name of the MCP tool to configure. 1-128 characters.
- `enabled: optional boolean or null`
Whether this tool is enabled. Overrides the `default_config` setting.
- `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
Permission policy for tool execution.
- `BetaManagedAgentsAlwaysAllowPolicy object { type }`
Tool calls are automatically approved without user confirmation.
- `BetaManagedAgentsAlwaysAskPolicy object { type }`
Tool calls require user confirmation before execution.
- `default_config: optional BetaManagedAgentsMCPToolsetDefaultConfigParams or null`
Default configuration for all tools from an MCP server.
- `enabled: optional boolean or null`
Whether tools are enabled by default. Defaults to true if not specified.
- `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
Permission policy for tool execution.
- `BetaManagedAgentsAlwaysAllowPolicy object { type }`
Tool calls are automatically approved without user confirmation.
- `BetaManagedAgentsAlwaysAskPolicy object { type }`
Tool calls require user confirmation before execution.
- `BetaManagedAgentsCustomToolParams object { description, input_schema, name, type }`
A custom tool that is executed by the API client rather than the agent. When the agent calls this tool, an `agent.custom_tool_use` event is emitted and the session goes idle, waiting for the client to provide the result via a `user.custom_tool_result` event.
- `description: string`
Description of what the tool does, shown to the agent to help it decide when to use the tool.
- `input_schema: BetaManagedAgentsCustomToolInputSchema`
JSON Schema for custom tool input parameters.
- `type: "object"`
- `"object"`
- `properties: optional map[unknown] or null`
- `required: optional array of string or null`
- `name: string`
Unique name for the tool. 1-128 characters; letters, digits, underscores, and hyphens.
- `type: "custom"`
- `"custom"`
- `budget: optional BetaManagedAgentsBudgetLimit or null`
A hard spend ceiling. The session stops issuing new model requests once the tracked list cost reaches `max_list_cost`.
- `max_list_cost: BetaMonetaryAmount`
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: BetaCurrency`
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.
- `"USD"`
- `type: "limit"`
- `"limit"`
- `metadata: optional map[string] or null`
Cut at 300 lines. The page has the rest.
api/beta/skills First recorded · 1697 lines, first recorded
# Skills ## Create Skill ### Header Parameters ### Returns ### Example #### Response ## List Skills ### Query Parameters ### Header Parameters ### Returns ### Example #### Response ## Get Skill ### Path Parameters ### Header Parameters ### Returns ### Example #### Response ## Delete Skill ### Path Parameters ### Header Parameters ### Returns ### Example #### Response ## Domain Types ### Skill Create Response ### Skill List Response ### Skill Retrieve Response ### Skill Delete Response # Versions ## Create Skill Version ### Path Parameters ### Header Parameters ### Returns ### Example #### Response ## List Skill Versions ### Path Parameters ### Query Parameters ### Header Parameters ### Returns ### Example #### Response ## Download Skill Version Content ### Path Parameters ### Header Parameters ### Example ## Get Skill Version ### Path Parameters ### Header Parameters ### Returns ### Example #### Response ## Delete Skill Version ### Path Parameters ### Header Parameters ### Returns ### Example #### Response ## Domain Types ### Version Create Response ### Version List Response ### Version Retrieve Response ### Version Delete Response
The first capture of this source. The page was already there, and this is what it said.
---
title: Skills
url: https://platform.claude.com/docs/en/api/beta/skills
---
# Skills
## Create Skill
**post** `/v1/skills`
Create Skill
### Header Parameters
- `"anthropic-beta": optional array of AnthropicBeta`
Optional header to specify the beta version(s) you want to use.
- `string`
- `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
- `"message-batches-2024-09-24"`
- `"prompt-caching-2024-07-31"`
- `"computer-use-2024-10-22"`
- `"computer-use-2025-01-24"`
- `"pdfs-2024-09-25"`
- `"token-counting-2024-11-01"`
- `"token-efficient-tools-2025-02-19"`
- `"output-128k-2025-02-19"`
- `"files-api-2025-04-14"`
- `"mcp-client-2025-04-04"`
- `"mcp-client-2025-11-20"`
- `"dev-full-thinking-2025-05-14"`
- `"interleaved-thinking-2025-05-14"`
- `"code-execution-2025-05-22"`
- `"extended-cache-ttl-2025-04-11"`
- `"context-1m-2025-08-07"`
- `"context-management-2025-06-27"`
- `"model-context-window-exceeded-2025-08-26"`
- `"skills-2025-10-02"`
- `"fast-mode-2026-02-01"`
- `"output-300k-2026-03-24"`
- `"user-profiles-2026-03-24"`
- `"advisor-tool-2026-03-01"`
- `"managed-agents-2026-04-01"`
- `"cache-diagnosis-2026-04-07"`
- `"dreaming-2026-04-21"`
- `"thinking-token-count-2026-05-13"`
- `"server-side-fallback-2026-06-01"`
- `"server-side-fallback-2026-07-01"`
- `"fallback-credit-2026-06-01"`
- `"fallback-credit-2026-07-01"`
- `"agent-memory-2026-07-22"`
- `"mid-conversation-tool-changes-2026-07-01"`
### Returns
- `id: string`
Unique identifier for the skill.
The format and length of IDs may change over time.
- `created_at: string`
ISO 8601 timestamp of when the skill was created.
- `display_title: string or null`
Display title for the skill.
This is a human-readable label that is not included in the prompt sent to the model.
- `latest_version: string or null`
The latest version identifier for the skill.
This represents the most recent version of the skill that has been created.
- `source: string`
Source of the skill.
This may be one of the following values:
* `"custom"`: the skill was created by a user
* `"anthropic"`: the skill was created by Anthropic
- `type: string`
Object type.
For Skills, this is always `"skill"`.
- `updated_at: string`
ISO 8601 timestamp of when the skill was last updated.
### Example
```http
curl https://api.anthropic.com/v1/skills \
-H 'Content-Type: multipart/form-data' \
-H 'anthropic-version: 2023-06-01' \
-H 'anthropic-beta: skills-2025-10-02' \
-H "X-Api-Key: $ANTHROPIC_API_KEY" \
-F files='["Example data"]'
```
#### Response
```json
{
"id": "skill_01JAbcdefghijklmnopqrstuvw",
"created_at": "2024-10-30T23:58:27.427722Z",
"display_title": "My Custom Skill",
"latest_version": "1759178010641129",
"source": "custom",
"type": "type",
"updated_at": "2024-10-30T23:58:27.427722Z"
}
```
## List Skills
**get** `/v1/skills`
List Skills
### Query Parameters
- `limit: optional number`
Number of results to return per page.
Maximum value is 100. Defaults to 20.
- `page: optional string`
Pagination token for fetching a specific page of results.
Pass the value from a previous response's `next_page` field to get the next page of results.
- `source: optional string`
Filter skills by source.
If provided, only skills from the specified source will be returned:
* `"custom"`: only return user-created skills
* `"anthropic"`: only return Anthropic-created skills
### Header Parameters
- `"anthropic-beta": optional array of AnthropicBeta`
Optional header to specify the beta version(s) you want to use.
- `string`
- `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
- `"message-batches-2024-09-24"`
- `"prompt-caching-2024-07-31"`
- `"computer-use-2024-10-22"`
- `"computer-use-2025-01-24"`
- `"pdfs-2024-09-25"`
- `"token-counting-2024-11-01"`
- `"token-efficient-tools-2025-02-19"`
- `"output-128k-2025-02-19"`
- `"files-api-2025-04-14"`
- `"mcp-client-2025-04-04"`
- `"mcp-client-2025-11-20"`
- `"dev-full-thinking-2025-05-14"`
- `"interleaved-thinking-2025-05-14"`
- `"code-execution-2025-05-22"`
- `"extended-cache-ttl-2025-04-11"`
- `"context-1m-2025-08-07"`
- `"context-management-2025-06-27"`
- `"model-context-window-exceeded-2025-08-26"`
- `"skills-2025-10-02"`
- `"fast-mode-2026-02-01"`
- `"output-300k-2026-03-24"`
- `"user-profiles-2026-03-24"`
- `"advisor-tool-2026-03-01"`
- `"managed-agents-2026-04-01"`
- `"cache-diagnosis-2026-04-07"`
- `"dreaming-2026-04-21"`
- `"thinking-token-count-2026-05-13"`
- `"server-side-fallback-2026-06-01"`
- `"server-side-fallback-2026-07-01"`
- `"fallback-credit-2026-06-01"`
- `"fallback-credit-2026-07-01"`
- `"agent-memory-2026-07-22"`
- `"mid-conversation-tool-changes-2026-07-01"`
### Returns
- `data: array of object { id, created_at, display_title, 4 more }`
List of skills.
- `id: string`
Unique identifier for the skill.
The format and length of IDs may change over time.
- `created_at: string`
ISO 8601 timestamp of when the skill was created.
- `display_title: string or null`
Display title for the skill.
This is a human-readable label that is not included in the prompt sent to the model.
- `latest_version: string or null`
The latest version identifier for the skill.
This represents the most recent version of the skill that has been created.
- `source: string`
Source of the skill.
This may be one of the following values:
* `"custom"`: the skill was created by a user
* `"anthropic"`: the skill was created by Anthropic
- `type: string`
Cut at 300 lines. The page has the rest.
api/beta/skills/create First recorded · 154 lines, first recorded
## Create Skill ### Header Parameters ### Returns ### Example #### Response
The first capture of this source. The page was already there, and this is what it said.
---
title: Create Skill
url: https://platform.claude.com/docs/en/api/beta/skills/create
---
## Create Skill
**post** `/v1/skills`
Create Skill
### Header Parameters
- `"anthropic-beta": optional array of AnthropicBeta`
Optional header to specify the beta version(s) you want to use.
- `string`
- `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
- `"message-batches-2024-09-24"`
- `"prompt-caching-2024-07-31"`
- `"computer-use-2024-10-22"`
- `"computer-use-2025-01-24"`
- `"pdfs-2024-09-25"`
- `"token-counting-2024-11-01"`
- `"token-efficient-tools-2025-02-19"`
- `"output-128k-2025-02-19"`
- `"files-api-2025-04-14"`
- `"mcp-client-2025-04-04"`
- `"mcp-client-2025-11-20"`
- `"dev-full-thinking-2025-05-14"`
- `"interleaved-thinking-2025-05-14"`
- `"code-execution-2025-05-22"`
- `"extended-cache-ttl-2025-04-11"`
- `"context-1m-2025-08-07"`
- `"context-management-2025-06-27"`
- `"model-context-window-exceeded-2025-08-26"`
- `"skills-2025-10-02"`
- `"fast-mode-2026-02-01"`
- `"output-300k-2026-03-24"`
- `"user-profiles-2026-03-24"`
- `"advisor-tool-2026-03-01"`
- `"managed-agents-2026-04-01"`
- `"cache-diagnosis-2026-04-07"`
- `"dreaming-2026-04-21"`
- `"thinking-token-count-2026-05-13"`
- `"server-side-fallback-2026-06-01"`
- `"server-side-fallback-2026-07-01"`
- `"fallback-credit-2026-06-01"`
- `"fallback-credit-2026-07-01"`
- `"agent-memory-2026-07-22"`
- `"mid-conversation-tool-changes-2026-07-01"`
### Returns
- `id: string`
Unique identifier for the skill.
The format and length of IDs may change over time.
- `created_at: string`
ISO 8601 timestamp of when the skill was created.
- `display_title: string or null`
Display title for the skill.
This is a human-readable label that is not included in the prompt sent to the model.
- `latest_version: string or null`
The latest version identifier for the skill.
This represents the most recent version of the skill that has been created.
- `source: string`
Source of the skill.
This may be one of the following values:
* `"custom"`: the skill was created by a user
* `"anthropic"`: the skill was created by Anthropic
- `type: string`
Object type.
For Skills, this is always `"skill"`.
- `updated_at: string`
ISO 8601 timestamp of when the skill was last updated.
### Example
```http
curl https://api.anthropic.com/v1/skills \
-H 'Content-Type: multipart/form-data' \
-H 'anthropic-version: 2023-06-01' \
-H 'anthropic-beta: skills-2025-10-02' \
-H "X-Api-Key: $ANTHROPIC_API_KEY" \
-F files='["Example data"]'
```
#### Response
```json
{
"id": "skill_01JAbcdefghijklmnopqrstuvw",
"created_at": "2024-10-30T23:58:27.427722Z",
"display_title": "My Custom Skill",
"latest_version": "1759178010641129",
"source": "custom",
"type": "type",
"updated_at": "2024-10-30T23:58:27.427722Z"
}
```
api/beta/skills/delete First recorded · 127 lines, first recorded
## Delete Skill ### Path Parameters ### Header Parameters ### Returns ### Example #### Response
The first capture of this source. The page was already there, and this is what it said.
---
title: Delete Skill
url: https://platform.claude.com/docs/en/api/beta/skills/delete
---
## Delete Skill
**delete** `/v1/skills/{skill_id}`
Delete Skill
### Path Parameters
- `skill_id: string`
Unique identifier for the skill.
The format and length of IDs may change over time.
### Header Parameters
- `"anthropic-beta": optional array of AnthropicBeta`
Optional header to specify the beta version(s) you want to use.
- `string`
- `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
- `"message-batches-2024-09-24"`
- `"prompt-caching-2024-07-31"`
- `"computer-use-2024-10-22"`
- `"computer-use-2025-01-24"`
- `"pdfs-2024-09-25"`
- `"token-counting-2024-11-01"`
- `"token-efficient-tools-2025-02-19"`
- `"output-128k-2025-02-19"`
- `"files-api-2025-04-14"`
- `"mcp-client-2025-04-04"`
- `"mcp-client-2025-11-20"`
- `"dev-full-thinking-2025-05-14"`
- `"interleaved-thinking-2025-05-14"`
- `"code-execution-2025-05-22"`
- `"extended-cache-ttl-2025-04-11"`
- `"context-1m-2025-08-07"`
- `"context-management-2025-06-27"`
- `"model-context-window-exceeded-2025-08-26"`
- `"skills-2025-10-02"`
- `"fast-mode-2026-02-01"`
- `"output-300k-2026-03-24"`
- `"user-profiles-2026-03-24"`
- `"advisor-tool-2026-03-01"`
- `"managed-agents-2026-04-01"`
- `"cache-diagnosis-2026-04-07"`
- `"dreaming-2026-04-21"`
- `"thinking-token-count-2026-05-13"`
- `"server-side-fallback-2026-06-01"`
- `"server-side-fallback-2026-07-01"`
- `"fallback-credit-2026-06-01"`
- `"fallback-credit-2026-07-01"`
- `"agent-memory-2026-07-22"`
- `"mid-conversation-tool-changes-2026-07-01"`
### Returns
- `id: string`
Unique identifier for the skill.
The format and length of IDs may change over time.
- `type: string`
Deleted object type.
For Skills, this is always `"skill_deleted"`.
### Example
```http
curl https://api.anthropic.com/v1/skills/$SKILL_ID \
-X DELETE \
-H 'anthropic-version: 2023-06-01' \
-H 'anthropic-beta: skills-2025-10-02' \
-H "X-Api-Key: $ANTHROPIC_API_KEY"
```
#### Response
```json
{
"id": "skill_01JAbcdefghijklmnopqrstuvw",
"type": "type"
}
```
api/beta/skills/list First recorded · 197 lines, first recorded
## List Skills ### Query Parameters ### Header Parameters ### Returns ### Example #### Response
The first capture of this source. The page was already there, and this is what it said.
---
title: List Skills
url: https://platform.claude.com/docs/en/api/beta/skills/list
---
## List Skills
**get** `/v1/skills`
List Skills
### Query Parameters
- `limit: optional number`
Number of results to return per page.
Maximum value is 100. Defaults to 20.
- `page: optional string`
Pagination token for fetching a specific page of results.
Pass the value from a previous response's `next_page` field to get the next page of results.
- `source: optional string`
Filter skills by source.
If provided, only skills from the specified source will be returned:
* `"custom"`: only return user-created skills
* `"anthropic"`: only return Anthropic-created skills
### Header Parameters
- `"anthropic-beta": optional array of AnthropicBeta`
Optional header to specify the beta version(s) you want to use.
- `string`
- `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
- `"message-batches-2024-09-24"`
- `"prompt-caching-2024-07-31"`
- `"computer-use-2024-10-22"`
- `"computer-use-2025-01-24"`
- `"pdfs-2024-09-25"`
- `"token-counting-2024-11-01"`
- `"token-efficient-tools-2025-02-19"`
- `"output-128k-2025-02-19"`
- `"files-api-2025-04-14"`
- `"mcp-client-2025-04-04"`
- `"mcp-client-2025-11-20"`
- `"dev-full-thinking-2025-05-14"`
- `"interleaved-thinking-2025-05-14"`
- `"code-execution-2025-05-22"`
- `"extended-cache-ttl-2025-04-11"`
- `"context-1m-2025-08-07"`
- `"context-management-2025-06-27"`
- `"model-context-window-exceeded-2025-08-26"`
- `"skills-2025-10-02"`
- `"fast-mode-2026-02-01"`
- `"output-300k-2026-03-24"`
- `"user-profiles-2026-03-24"`
- `"advisor-tool-2026-03-01"`
- `"managed-agents-2026-04-01"`
- `"cache-diagnosis-2026-04-07"`
- `"dreaming-2026-04-21"`
- `"thinking-token-count-2026-05-13"`
- `"server-side-fallback-2026-06-01"`
- `"server-side-fallback-2026-07-01"`
- `"fallback-credit-2026-06-01"`
- `"fallback-credit-2026-07-01"`
- `"agent-memory-2026-07-22"`
- `"mid-conversation-tool-changes-2026-07-01"`
### Returns
- `data: array of object { id, created_at, display_title, 4 more }`
List of skills.
- `id: string`
Unique identifier for the skill.
The format and length of IDs may change over time.
- `created_at: string`
ISO 8601 timestamp of when the skill was created.
- `display_title: string or null`
Display title for the skill.
This is a human-readable label that is not included in the prompt sent to the model.
- `latest_version: string or null`
The latest version identifier for the skill.
This represents the most recent version of the skill that has been created.
- `source: string`
Source of the skill.
This may be one of the following values:
* `"custom"`: the skill was created by a user
* `"anthropic"`: the skill was created by Anthropic
- `type: string`
Object type.
For Skills, this is always `"skill"`.
- `updated_at: string`
ISO 8601 timestamp of when the skill was last updated.
- `has_more: boolean`
Whether there are more results available.
If `true`, there are additional results that can be fetched using the `next_page` token.
- `next_page: string or null`
Token for fetching the next page of results.
If `null`, there are no more results available. Pass this value to the `page` parameter in the next request to get the next page.
### Example
```http
curl https://api.anthropic.com/v1/skills \
-H 'anthropic-version: 2023-06-01' \
-H 'anthropic-beta: skills-2025-10-02' \
-H "X-Api-Key: $ANTHROPIC_API_KEY"
```
#### Response
```json
{
"data": [
{
"id": "skill_01JAbcdefghijklmnopqrstuvw",
"created_at": "2024-10-30T23:58:27.427722Z",
"display_title": "My Custom Skill",
"latest_version": "1759178010641129",
"source": "custom",
"type": "type",
"updated_at": "2024-10-30T23:58:27.427722Z"
}
],
"has_more": true,
"next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="
}
```
api/beta/skills/retrieve First recorded · 160 lines, first recorded
## Get Skill ### Path Parameters ### Header Parameters ### Returns ### Example #### Response
The first capture of this source. The page was already there, and this is what it said.
---
title: Get Skill
url: https://platform.claude.com/docs/en/api/beta/skills/retrieve
---
## Get Skill
**get** `/v1/skills/{skill_id}`
Get Skill
### Path Parameters
- `skill_id: string`
Unique identifier for the skill.
The format and length of IDs may change over time.
### Header Parameters
- `"anthropic-beta": optional array of AnthropicBeta`
Optional header to specify the beta version(s) you want to use.
- `string`
- `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
- `"message-batches-2024-09-24"`
- `"prompt-caching-2024-07-31"`
- `"computer-use-2024-10-22"`
- `"computer-use-2025-01-24"`
- `"pdfs-2024-09-25"`
- `"token-counting-2024-11-01"`
- `"token-efficient-tools-2025-02-19"`
- `"output-128k-2025-02-19"`
- `"files-api-2025-04-14"`
- `"mcp-client-2025-04-04"`
- `"mcp-client-2025-11-20"`
- `"dev-full-thinking-2025-05-14"`
- `"interleaved-thinking-2025-05-14"`
- `"code-execution-2025-05-22"`
- `"extended-cache-ttl-2025-04-11"`
- `"context-1m-2025-08-07"`
- `"context-management-2025-06-27"`
- `"model-context-window-exceeded-2025-08-26"`
- `"skills-2025-10-02"`
- `"fast-mode-2026-02-01"`
- `"output-300k-2026-03-24"`
- `"user-profiles-2026-03-24"`
- `"advisor-tool-2026-03-01"`
- `"managed-agents-2026-04-01"`
- `"cache-diagnosis-2026-04-07"`
- `"dreaming-2026-04-21"`
- `"thinking-token-count-2026-05-13"`
- `"server-side-fallback-2026-06-01"`
- `"server-side-fallback-2026-07-01"`
- `"fallback-credit-2026-06-01"`
- `"fallback-credit-2026-07-01"`
- `"agent-memory-2026-07-22"`
- `"mid-conversation-tool-changes-2026-07-01"`
### Returns
- `id: string`
Unique identifier for the skill.
The format and length of IDs may change over time.
- `created_at: string`
ISO 8601 timestamp of when the skill was created.
- `display_title: string or null`
Display title for the skill.
This is a human-readable label that is not included in the prompt sent to the model.
- `latest_version: string or null`
The latest version identifier for the skill.
This represents the most recent version of the skill that has been created.
- `source: string`
Source of the skill.
This may be one of the following values:
* `"custom"`: the skill was created by a user
* `"anthropic"`: the skill was created by Anthropic
- `type: string`
Object type.
For Skills, this is always `"skill"`.
- `updated_at: string`
ISO 8601 timestamp of when the skill was last updated.
### Example
```http
curl https://api.anthropic.com/v1/skills/$SKILL_ID \
-H 'anthropic-version: 2023-06-01' \
-H 'anthropic-beta: skills-2025-10-02' \
-H "X-Api-Key: $ANTHROPIC_API_KEY"
```
#### Response
```json
{
"id": "skill_01JAbcdefghijklmnopqrstuvw",
"created_at": "2024-10-30T23:58:27.427722Z",
"display_title": "My Custom Skill",
"latest_version": "1759178010641129",
"source": "custom",
"type": "type",
"updated_at": "2024-10-30T23:58:27.427722Z"
}
```
api/beta/skills/versions First recorded · 920 lines, first recorded
# Versions ## Create Skill Version ### Path Parameters ### Header Parameters ### Returns ### Example #### Response ## List Skill Versions ### Path Parameters ### Query Parameters ### Header Parameters ### Returns ### Example #### Response ## Download Skill Version Content ### Path Parameters ### Header Parameters ### Example ## Get Skill Version ### Path Parameters ### Header Parameters ### Returns ### Example #### Response ## Delete Skill Version ### Path Parameters ### Header Parameters ### Returns ### Example #### Response ## Domain Types ### Version Create Response ### Version List Response ### Version Retrieve Response ### Version Delete Response
The first capture of this source. The page was already there, and this is what it said.
---
title: Versions
url: https://platform.claude.com/docs/en/api/beta/skills/versions
---
# Versions
## Create Skill Version
**post** `/v1/skills/{skill_id}/versions`
Create Skill Version
### Path Parameters
- `skill_id: string`
Unique identifier for the skill.
The format and length of IDs may change over time.
### Header Parameters
- `"anthropic-beta": optional array of AnthropicBeta`
Optional header to specify the beta version(s) you want to use.
- `string`
- `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
- `"message-batches-2024-09-24"`
- `"prompt-caching-2024-07-31"`
- `"computer-use-2024-10-22"`
- `"computer-use-2025-01-24"`
- `"pdfs-2024-09-25"`
- `"token-counting-2024-11-01"`
- `"token-efficient-tools-2025-02-19"`
- `"output-128k-2025-02-19"`
- `"files-api-2025-04-14"`
- `"mcp-client-2025-04-04"`
- `"mcp-client-2025-11-20"`
- `"dev-full-thinking-2025-05-14"`
- `"interleaved-thinking-2025-05-14"`
- `"code-execution-2025-05-22"`
- `"extended-cache-ttl-2025-04-11"`
- `"context-1m-2025-08-07"`
- `"context-management-2025-06-27"`
- `"model-context-window-exceeded-2025-08-26"`
- `"skills-2025-10-02"`
- `"fast-mode-2026-02-01"`
- `"output-300k-2026-03-24"`
- `"user-profiles-2026-03-24"`
- `"advisor-tool-2026-03-01"`
- `"managed-agents-2026-04-01"`
- `"cache-diagnosis-2026-04-07"`
- `"dreaming-2026-04-21"`
- `"thinking-token-count-2026-05-13"`
- `"server-side-fallback-2026-06-01"`
- `"server-side-fallback-2026-07-01"`
- `"fallback-credit-2026-06-01"`
- `"fallback-credit-2026-07-01"`
- `"agent-memory-2026-07-22"`
- `"mid-conversation-tool-changes-2026-07-01"`
### Returns
- `id: string`
Unique identifier for the skill version.
The format and length of IDs may change over time.
- `created_at: string`
ISO 8601 timestamp of when the skill version was created.
- `description: string`
Description of the skill version.
This is extracted from the SKILL.md file in the skill upload.
- `directory: string`
Directory name of the skill version.
This is the top-level directory name that was extracted from the uploaded files.
- `name: string`
Human-readable name of the skill version.
This is extracted from the SKILL.md file in the skill upload.
- `skill_id: string`
Identifier for the skill that this version belongs to.
- `type: string`
Object type.
For Skill Versions, this is always `"skill_version"`.
- `version: string`
Version identifier for the skill.
Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").
### Example
```http
curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions \
-H 'Content-Type: multipart/form-data' \
-H 'anthropic-version: 2023-06-01' \
-H 'anthropic-beta: skills-2025-10-02' \
-H "X-Api-Key: $ANTHROPIC_API_KEY" \
-F files='["Example data"]'
```
#### Response
```json
{
"id": "skillver_01JAbcdefghijklmnopqrstuvw",
"created_at": "2024-10-30T23:58:27.427722Z",
"description": "A custom skill for doing something useful",
"directory": "my-skill",
"name": "my-skill",
"skill_id": "skill_01JAbcdefghijklmnopqrstuvw",
"type": "type",
"version": "1759178010641129"
}
```
## List Skill Versions
**get** `/v1/skills/{skill_id}/versions`
List Skill Versions
### Path Parameters
- `skill_id: string`
Unique identifier for the skill.
The format and length of IDs may change over time.
### Query Parameters
- `limit: optional number`
Number of items to return per page.
Defaults to `20`. Ranges from `1` to `1000`.
- `page: optional string`
Optionally set to the `next_page` token from the previous response.
### Header Parameters
- `"anthropic-beta": optional array of AnthropicBeta`
Optional header to specify the beta version(s) you want to use.
- `string`
- `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
- `"message-batches-2024-09-24"`
- `"prompt-caching-2024-07-31"`
- `"computer-use-2024-10-22"`
- `"computer-use-2025-01-24"`
- `"pdfs-2024-09-25"`
- `"token-counting-2024-11-01"`
- `"token-efficient-tools-2025-02-19"`
- `"output-128k-2025-02-19"`
- `"files-api-2025-04-14"`
- `"mcp-client-2025-04-04"`
- `"mcp-client-2025-11-20"`
- `"dev-full-thinking-2025-05-14"`
- `"interleaved-thinking-2025-05-14"`
- `"code-execution-2025-05-22"`
- `"extended-cache-ttl-2025-04-11"`
- `"context-1m-2025-08-07"`
- `"context-management-2025-06-27"`
- `"model-context-window-exceeded-2025-08-26"`
- `"skills-2025-10-02"`
- `"fast-mode-2026-02-01"`
- `"output-300k-2026-03-24"`
- `"user-profiles-2026-03-24"`
- `"advisor-tool-2026-03-01"`
- `"managed-agents-2026-04-01"`
- `"cache-diagnosis-2026-04-07"`
- `"dreaming-2026-04-21"`
- `"thinking-token-count-2026-05-13"`
- `"server-side-fallback-2026-06-01"`
- `"server-side-fallback-2026-07-01"`
- `"fallback-credit-2026-06-01"`
- `"fallback-credit-2026-07-01"`
- `"agent-memory-2026-07-22"`
- `"mid-conversation-tool-changes-2026-07-01"`
### Returns
- `data: array of object { id, created_at, description, 5 more }`
List of skill versions.
- `id: string`
Unique identifier for the skill version.
The format and length of IDs may change over time.
- `created_at: string`
ISO 8601 timestamp of when the skill version was created.
- `description: string`
Description of the skill version.
This is extracted from the SKILL.md file in the skill upload.
- `directory: string`
Directory name of the skill version.
This is the top-level directory name that was extracted from the uploaded files.
- `name: string`
Cut at 300 lines. The page has the rest.
api/beta/skills/versions/create First recorded · 166 lines, first recorded
## Create Skill Version ### Path Parameters ### Header Parameters ### Returns ### Example #### Response
The first capture of this source. The page was already there, and this is what it said.
---
title: Create Skill Version
url: https://platform.claude.com/docs/en/api/beta/skills/versions/create
---
## Create Skill Version
**post** `/v1/skills/{skill_id}/versions`
Create Skill Version
### Path Parameters
- `skill_id: string`
Unique identifier for the skill.
The format and length of IDs may change over time.
### Header Parameters
- `"anthropic-beta": optional array of AnthropicBeta`
Optional header to specify the beta version(s) you want to use.
- `string`
- `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
- `"message-batches-2024-09-24"`
- `"prompt-caching-2024-07-31"`
- `"computer-use-2024-10-22"`
- `"computer-use-2025-01-24"`
- `"pdfs-2024-09-25"`
- `"token-counting-2024-11-01"`
- `"token-efficient-tools-2025-02-19"`
- `"output-128k-2025-02-19"`
- `"files-api-2025-04-14"`
- `"mcp-client-2025-04-04"`
- `"mcp-client-2025-11-20"`
- `"dev-full-thinking-2025-05-14"`
- `"interleaved-thinking-2025-05-14"`
- `"code-execution-2025-05-22"`
- `"extended-cache-ttl-2025-04-11"`
- `"context-1m-2025-08-07"`
- `"context-management-2025-06-27"`
- `"model-context-window-exceeded-2025-08-26"`
- `"skills-2025-10-02"`
- `"fast-mode-2026-02-01"`
- `"output-300k-2026-03-24"`
- `"user-profiles-2026-03-24"`
- `"advisor-tool-2026-03-01"`
- `"managed-agents-2026-04-01"`
- `"cache-diagnosis-2026-04-07"`
- `"dreaming-2026-04-21"`
- `"thinking-token-count-2026-05-13"`
- `"server-side-fallback-2026-06-01"`
- `"server-side-fallback-2026-07-01"`
- `"fallback-credit-2026-06-01"`
- `"fallback-credit-2026-07-01"`
- `"agent-memory-2026-07-22"`
- `"mid-conversation-tool-changes-2026-07-01"`
### Returns
- `id: string`
Unique identifier for the skill version.
The format and length of IDs may change over time.
- `created_at: string`
ISO 8601 timestamp of when the skill version was created.
- `description: string`
Description of the skill version.
This is extracted from the SKILL.md file in the skill upload.
- `directory: string`
Directory name of the skill version.
This is the top-level directory name that was extracted from the uploaded files.
- `name: string`
Human-readable name of the skill version.
This is extracted from the SKILL.md file in the skill upload.
- `skill_id: string`
Identifier for the skill that this version belongs to.
- `type: string`
Object type.
For Skill Versions, this is always `"skill_version"`.
- `version: string`
Version identifier for the skill.
Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").
### Example
```http
curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions \
-H 'Content-Type: multipart/form-data' \
-H 'anthropic-version: 2023-06-01' \
-H 'anthropic-beta: skills-2025-10-02' \
-H "X-Api-Key: $ANTHROPIC_API_KEY" \
-F files='["Example data"]'
```
#### Response
```json
{
"id": "skillver_01JAbcdefghijklmnopqrstuvw",
"created_at": "2024-10-30T23:58:27.427722Z",
"description": "A custom skill for doing something useful",
"directory": "my-skill",
"name": "my-skill",
"skill_id": "skill_01JAbcdefghijklmnopqrstuvw",
"type": "type",
"version": "1759178010641129"
}
```