Anthropic Sessions?beta=true API
The Sessions?beta=true API from Anthropic — 1 operation(s) for sessions?beta=true.
Anthropic Sessions?beta=true API is one of 43 APIs that Anthropic publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Sessions?beta=true. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.
This API exposes 2 operations across 1 path, and defines 127 schemas. It is described by OpenAPI 3.2.0.
Requests are made against a single base URL, https://api.anthropic.com.
2 operations
1 paths
127 schemas
1 GET1 POST
Metadata
The identity and technical contract details declared by the specification.
Paths & Operations 2
Across 1 path, the API surfaces 2 operations — 1 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.
Sessions?beta=true 2
POST
/v1/sessions?beta=true
Create Session
GET
/v1/sessions?beta=true
List Sessions
Schemas 127
The contract defines 127 schemas that model the data the API accepts and returns. The most detailed are BetaManagedAgentsSession (17 properties), BetaManagedAgentsSessionAgent (11 properties), BetaManagedAgentsSessionThreadAgent (10 properties), BetaManagedAgentsAgentWithOverridesParams (8 properties). Each schema is shown below with its type and property counts.
BetaManagedAgentsMCPToolsetParams
object
Configuration for tools from an MCP server defined in mcpservers.
4 properties
2 required
BetaManagedAgentsSessionUsage
object
Cumulative token usage for a session across all turns.
7 properties
BetaManagedAgentsMCPToolConfig
object
Resolved configuration for a specific MCP tool.
3 properties
3 required
BetaManagedAgentsUserMessageEventParams
object
Parameters for sending a user message to the session.
2 properties
2 required
BetaManagedAgentsMCPToolsetDefaultConfig
object
Resolved default configuration for all tools from an MCP server.
2 properties
2 required
BetaManagedAgentsDocumentBlock
object
Document content, either specified directly as base64 data, as text, or as a reference via a URL.
4 properties
2 required
BetaManagedAgentsEffortHigh
object
High effort. Favors reasoning depth.
1 property
1 required
BetaManagedAgentsCustomToolParams
object
A custom tool that is executed by the API client rather than the agent. When the agent calls this tool, an agent.customtooluse event is emitted and the session…
4 properties
4 required
BetaManagedAgentsURLImageSource
object
Image referenced by URL.
2 properties
2 required
BetaManagedAgentsBudget
object
An enforced spend ceiling on a session. Discriminated on type; limit is the only kind currently supported.
BetaManagedAgentsAgentToolset20260401Params
object
Configuration for built-in agent tools. Use this to enable or disable groups of tools available to the agent.
3 properties
1 required
BetaManagedAgentsWriteToolConfig
object
Configuration for the write tool.
4 properties
4 required
BetaManagedAgentsModelConfig
object
Model identifier and configuration.
4 properties
1 required
BetaManagedAgentsCacheCreationUsage
object
Prompt-cache creation token usage broken down by cache lifetime.
2 properties
BetaManagedAgentsPermissionPolicy
object
Permission policy for tool execution.
BetaManagedAgentsCustomSkillParams
object
A user-created custom skill.
3 properties
2 required
BetaManagedAgentsFileDocumentSource
object
Document referenced by file ID.
2 properties
2 required
BetaManagedAgentsModelConfigParams
object
An object that defines additional configuration control over model use
4 properties
1 required
BetaManagedAgentsAgentToolConfigUnion
object
Configuration for a specific agent tool.
BetaManagedAgentsFileRubricParams
object
Rubric referenced by a file uploaded via the Files API.
2 properties
2 required
BetaManagedAgentsCustomSkill
object
A resolved user-created custom skill.
3 properties
3 required
BetaManagedAgentsMCPToolConfigParams
object
Configuration override for a specific MCP tool.
3 properties
1 required
BetaManagedAgentsGlobToolConfig
object
Configuration for the glob tool.
4 properties
4 required
BetaManagedAgentsUserContentBlock
object
Content block in a user message. Can be text, image, or document.
BetaManagedAgentsReadToolConfigParams
object
Configuration override for the read tool.
4 properties
1 required
BetaGatewayTimeoutError
object
2 properties
2 required
BetaManagedAgentsAgentToolsetDefaultConfigParams
object
Default configuration for all tools in a toolset.
2 properties
BetaManagedAgentsGrepToolConfig
object
Configuration for the grep tool.
4 properties
4 required
BetaManagedAgentsSessionThreadAgent
object
Resolved agent definition for a single sessionthread. Snapshot of the agent at thread creation time. The multiagent roster is not repeated here; read it from S…
10 properties
10 required
BetaManagedAgentsListSessions
object
Paginated list of sessions.
3 properties
BetaManagedAgentsWebFetchToolConfigParams
object
Configuration override for the webfetch tool.
7 properties
1 required
BetaManagedAgentsModel
The model that will power your agent. See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
BetaManagedAgentsSessionStats
object
Timing statistics for a session.
2 properties
BetaManagedAgentsAnthropicSkill
object
A resolved Anthropic-managed skill.
3 properties
3 required
BetaManagedAgentsCustomToolInputSchema
object
JSON Schema for custom tool input parameters.
3 properties
1 required
BetaManagedAgentsSessionAgent
object
Resolved agent definition for a session. Snapshot of the agent at session creation time.
11 properties
11 required
BetaManagedAgentsAgentToolset20260401
object
3 properties
3 required
BetaManagedAgentsAnthropicSkillParams
object
An Anthropic-managed skill.
3 properties
2 required
BetaManagedAgentsEffortXhigh
object
Extra-high effort. Not all models accept this level.
1 property
1 required
BetaManagedAgentsBranchCheckout
object
2 properties
2 required
BetaManagedAgentsGrepToolConfigParams
object
Configuration override for the grep tool.
4 properties
1 required
BetaManagedAgentsCreateSessionParams
object
Request parameters for creating a session.
8 properties
2 required
BetaManagedAgentsBase64DocumentSource
object
Base64-encoded document data.
3 properties
3 required
BetaManagedAgentsAgentToolParams
object
Union type for tool configurations in the tools array.
BetaManagedAgentsGitHubRepositoryResourceParams
object
Mount a GitHub repository into the session's container.
5 properties
3 required
BetaManagedAgentsSessionMultiagentCoordinator
object
Resolved coordinator topology with full agent definitions for each roster member.
2 properties
2 required
BetaManagedAgentsMCPServer
object
Union type for MCP server connection definitions returned in API responses.
BetaManagedAgentsAgentToolConfigUnionParams
object
Configuration override for a specific tool within a toolset.
BetaManagedAgentsAgentParams
object
Specification for an Agent. Provide a specific version or use the short-form agent="agentid" for the most recent version
3 properties
2 required
BetaManagedAgentsFileResourceParams
object
Mount a file uploaded via the Files API into the session.
3 properties
2 required
BetaManagedAgentsBashToolConfigParams
object
Configuration override for the bash tool.
4 properties
1 required
BetaManagedAgentsSessionMultiagent
Resolved multiagent orchestration configuration as returned on a session.
BetaManagedAgentsMCPServerParams
object
Union type for MCP server connection definitions.
BetaAPIError
object
2 properties
2 required
BetaManagedAgentsWebSearchToolConfigParams
object
Configuration override for the websearch tool.
7 properties
1 required
BetaManagedAgentsEffortLevel
string
How hard Claude works on each turn. Higher levels favor reasoning depth over latency. Not all models accept every level; invalid combinations are rejected at c…
BetaManagedAgentsSessionResourceParams
object
Union of resources that can be mounted into a session.
BetaManagedAgentsWriteToolConfigParams
object
Configuration override for the write tool.
4 properties
1 required
BetaRateLimitError
object
2 properties
2 required
BetaManagedAgentsOutcomeEvaluationResource
object
Evaluation state for a single outcome defined via a defineoutcome event.
7 properties
7 required
BetaManagedAgentsServerToolUsage
object
Cumulative count of server-executed tool invocations, broken down by tool.
2 properties
BetaManagedAgentsMCPServerURLDefinition
object
URL-based MCP server connection as returned in API responses.
3 properties
3 required
BetaManagedAgentsUserLocation
object
Approximate user location for search result localization.
5 properties
1 required
BetaManagedAgentsURLDocumentSource
object
Document referenced by URL.
2 properties
2 required
BetaManagedAgentsModelParams
BetaManagedAgentsCommitCheckout
object
2 properties
2 required
BetaManagedAgentsPlainTextDocumentSource
object
Plain text document content.
3 properties
3 required
BetaManagedAgentsReadToolConfig
object
Configuration for the read tool.
4 properties
4 required
BetaManagedAgentsMemoryStoreResource
object
A memory store attached to an agent session.
7 properties
2 required
BetaManagedAgentsSpeed
string
Inference speed mode. fast provides significantly faster output token generation at premium pricing. Not all models support fast; invalid combinations are reje…
BetaManagedAgentsMCPToolset
object
4 properties
4 required
BetaInvalidRequestError
object
2 properties
2 required
BetaManagedAgentsRubricParams
Rubric for grading the quality of an outcome.
BetaManagedAgentsWebSearchToolConfig
object
Configuration for the websearch tool.
7 properties
4 required
BetaManagedAgentsAgentTool
object
Union type for tool configurations returned in API responses.
BetaManagedAgentsEffortMedium
object
Medium effort. Balances latency and reasoning depth.
1 property
1 required
BetaManagedAgentsEffortLow
object
Low effort. Favors latency over reasoning depth.
1 property
1 required
BetaManagedAgentsGlobToolConfigParams
object
Configuration override for the glob tool.
4 properties
1 required
BetaManagedAgentsEffortParams
BetaManagedAgentsTextRubricParams
object
Rubric content provided inline as text.
2 properties
2 required
BetaManagedAgentsRedactedBlock
object
Placeholder for content withheld by Anthropic model policy.
1 property
1 required
BetaManagedAgentsUserDefineOutcomeEventParams
object
Parameters for defining an outcome the agent should work toward. The agent begins work on receipt.
4 properties
3 required
BetaCurrency
string
BetaManagedAgentsBudgetLimit
object
A hard spend ceiling. The session stops issuing new model requests once the tracked list cost reaches maxlistcost.
2 properties
2 required
BetaManagedAgentsURLMCPServerParams
object
URL-based MCP server connection.
3 properties
3 required
BetaManagedAgentsGitHubRepositoryResource
object
7 properties
6 required
BetaManagedAgentsImageBlock
object
Image content specified directly as base64 data or as a reference via a URL.
2 properties
2 required
BetaManagedAgentsSessionInitialEventParams
object
An event sent to the session immediately after it is created. Supports user.message and user.defineoutcome.
BetaTimestamp
string
A timestamp in RFC 3339 format
BetaOverloadedError
object
2 properties
2 required
BetaBillingError
object
2 properties
2 required
BetaManagedAgentsFileResource
object
6 properties
6 required
BetaManagedAgentsEditToolConfig
object
Configuration for the edit tool.
4 properties
4 required
BetaManagedAgentsEffortMax
object
Maximum effort. Favors reasoning depth over latency.
1 property
1 required
BetaManagedAgentsMemoryStoreResourceParam
object
Parameters for attaching a memory store to an agent session.
4 properties
2 required
BetaManagedAgentsEditToolConfigParams
object
Configuration override for the edit tool.
4 properties
1 required
BetaManagedAgentsRepositoryCheckout
object
BetaManagedAgentsAlwaysAskPolicy
object
Tool calls require user confirmation before execution.
1 property
1 required
BetaManagedAgentsSessionRosterEntry
A session-resolved multiagent roster entry.
BetaAuthenticationError
object
2 properties
2 required
BetaManagedAgentsTextBlock
object
Regular text content.
2 properties
2 required
BetaNotFoundError
object
2 properties
2 required
BetaManagedAgentsAdvisor
object
Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
2 properties
2 required
BetaManagedAgentsSkillParams
Skill to load in the session container.
BetaManagedAgentsEffort
object
How hard Claude works on each turn. Sets outputconfig.effort on every Messages call the session makes.
BetaPermissionError
object
2 properties
2 required
BetaManagedAgentsCreateSessionAgentUnionParams
BetaManagedAgentsAgentToolsetDefaultConfig
object
Resolved default configuration for agent tools.
2 properties
2 required
BetaManagedAgentsBashToolConfig
object
Configuration for the bash tool.
4 properties
4 required
BetaManagedAgentsSkill
Resolved skill as returned in API responses.
BetaMonetaryAmount
object
A monetary amount in a specific currency.
2 properties
2 required
BetaManagedAgentsAlwaysAllowPolicy
object
Tool calls are automatically approved without user confirmation.
1 property
1 required
BetaManagedAgentsFileImageSource
object
Image referenced by file ID.
2 properties
2 required
BetaManagedAgentsMCPToolsetDefaultConfigParams
object
Default configuration for all tools from an MCP server.
2 properties
BetaManagedAgentsListOrder
string
ListOrder enum
BetaManagedAgentsSessionResource
object
BetaManagedAgentsMountMode
string
Access mode for an attached memory store.
BetaManagedAgentsImageSource
object
Union type for image source variants.
BetaManagedAgentsDocumentSource
object
Union type for document source variants.
BetaManagedAgentsAgentWithOverridesParams
object
Reference to an agent plus optional configuration overrides. Each provided field replaces the agent's value for the caller's use; the agent resource is unchang…
8 properties
2 required
BetaManagedAgentsCustomTool
object
A custom tool as returned in API responses.
4 properties
4 required
BetaErrorResponse
object
3 properties
3 required
BetaManagedAgentsSessionStatus
string
SessionStatus enum
BetaManagedAgentsWebFetchToolConfig
object
Configuration for the webfetch tool.
7 properties
4 required
BetaManagedAgentsBase64ImageSource
object
Base64-encoded image data.
3 properties
3 required
BetaManagedAgentsSession
object
A Managed Agents session.
17 properties
16 required
AnthropicBeta
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from Anthropic 12
Other APIs Anthropic publishes across the network.
Anthropic Messages API
Anthropic Models API
Anthropic Files API
Anthropic Skills API
Anthropic Agents API
Anthropic Api Keys API
Anthropic Cost API
Anthropic Environments API
Anthropic Events API
Anthropic Organization API
Anthropic Organization Invites API
Anthropic Organization Members API
#Sessions?beta=true
Where this information came from
This is an independent, third-party profile of Anthropic Sessions?beta=true API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.