Beta
Models
Errors
BetaModels
BetaMessages
Create a Message
Send a structured list of input messages with text and/or image content, and the model will generate the next message in the conversation.
BetaMessagesBatches
Retrieve a Message Batch
This endpoint is idempotent and can be used to poll for Message Batch completion. To access the results of a Message Batch, make a request to the results_url field in the response.
List Message Batches
List all Message Batches within a Workspace. Most recently created batches are returned first.
Cancel a Message Batch
Batches may be canceled any time before processing ends. Once cancellation is initiated, the batch enters a canceling state, at which time the system may complete any in-progress, non-interruptible requests before finalizing cancellation.
Delete a Message Batch
Retrieve Message Batch results
Streams the results of a Message Batch as a .jsonl file.
BetaAgents
Create Agent
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.List Agents
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.Get Agent
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.Update Agent
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.Archive Agent
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.BetaAgentsVersions
List Agent Versions
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.BetaEnvironments
Update Environment
Update an existing environment's configuration.
Delete Environment
Delete an environment by ID. Returns a confirmation of the deletion.
Archive Environment
Archive an environment by ID. Archived environments cannot be used to create new sessions.
BetaEnvironmentsWork
Get Work Item
Note: these endpoints are called automatically by the pre-built environment worker provided in the SDKs and CLI, for orchestrating sessions with self-hosted sandbox environments. They are included here as a reference; you do not need to invoke them directly.
Poll for Work
Note: these endpoints are called automatically by the pre-built environment worker provided in the SDKs and CLI, for orchestrating sessions with self-hosted sandbox environments. They are included here as a reference; you do not need to invoke them directly.
Acknowledge Work
Note: these endpoints are called automatically by the pre-built environment worker provided in the SDKs and CLI, for orchestrating sessions with self-hosted sandbox environments. They are included here as a reference; you do not need to invoke them directly.
Record Heartbeat
Note: these endpoints are called automatically by the pre-built environment worker provided in the SDKs and CLI, for orchestrating sessions with self-hosted sandbox environments. They are included here as a reference; you do not need to invoke them directly.
Stop Work
Note: these endpoints are called automatically by the pre-built environment worker provided in the SDKs and CLI, for orchestrating sessions with self-hosted sandbox environments. They are included here as a reference; you do not need to invoke them directly.
List Work Items
Note: these endpoints are called automatically by the pre-built environment worker provided in the SDKs and CLI, for orchestrating sessions with self-hosted sandbox environments. They are included here as a reference; you do not need to invoke them directly.
Update Work Item
Note: these endpoints are called automatically by the pre-built environment worker provided in the SDKs and CLI, for orchestrating sessions with self-hosted sandbox environments. They are included here as a reference; you do not need to invoke them directly.
Get Queue Statistics
Get statistics about the work queue for an environment.
BetaSessions
Create Session
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.List Sessions
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.Get Session
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.Update Session
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.Delete Session
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.Archive Session
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.BetaSessionsEvents
List Events
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.Send Events
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.Stream Events
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.BetaSessionsResources
Add Session Resource
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.List Session Resources
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.Get Session Resource
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.Update Session Resource
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.Delete Session Resource
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.BetaSessionsThreads
List Session Threads
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.Get Session Thread
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.Archive Session Thread
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.BetaSessionsThreadsEvents
List Session Thread Events
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.Stream Session Thread Events
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.BetaDeployments
Create Deployment
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.List Deployments
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.Get Deployment
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.Update Deployment
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.Archive Deployment
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.Run Deployment Now
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.Pause Deployment
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.Unpause Deployment
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.BetaDeployment Runs
List Deployment Runs
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.Get Deployment Run
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.BetaVaults
Create a Vault
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.List Vaults
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.Retrieve a Vault
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.Update a Vault
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.Delete a Vault
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.Archive a Vault
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.BetaVaultsCredentials
Create a Credential
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.List Credentials
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.Retrieve a Credential
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.Update a Credential
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.Delete a Credential
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.Archive a Credential
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.Validate an MCP OAuth Credential
anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.BetaMemory Stores
Create a Memory Store
anthropic-beta: agent-memory-2026-07-22 or anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.List Memory Stores
anthropic-beta: agent-memory-2026-07-22 or anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.Retrieve a Memory Store
anthropic-beta: agent-memory-2026-07-22 or anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.Update a Memory Store
anthropic-beta: agent-memory-2026-07-22 or anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.Delete a Memory Store
anthropic-beta: agent-memory-2026-07-22 or anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.Archive a Memory Store
anthropic-beta: agent-memory-2026-07-22 or anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.BetaMemory StoresMemories
Create a Memory
anthropic-beta: agent-memory-2026-07-22 or anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.List Memories
anthropic-beta: agent-memory-2026-07-22 or anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.Retrieve a Memory
anthropic-beta: agent-memory-2026-07-22 or anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.Update a Memory
anthropic-beta: agent-memory-2026-07-22 or anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.Delete a Memory
anthropic-beta: agent-memory-2026-07-22 or anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.BetaMemory StoresMemory Versions
List Memory Versions
anthropic-beta: agent-memory-2026-07-22 or anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.Retrieve a Memory Version
anthropic-beta: agent-memory-2026-07-22 or anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.Redact a Memory Version
anthropic-beta: agent-memory-2026-07-22 or anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.BetaFiles
Upload File
List Files
Download File
Get File Metadata
Delete File
BetaSkills
Create Skill
List Skills
Get Skill
Delete Skill
BetaSkillsVersions
Create Skill Version
List Skill Versions
Download Skill Version Content
Download a skill version's content as a zip archive.
Get Skill Version
Delete Skill Version
BetaUser Profiles
Create User Profile
List User Profiles
Get User Profile
Update User Profile
Delete User Profile
Create Enrollment URL
BetaUser ProfilesAction URLs
Create Action URL
BetaDreams
Create a Dream
anthropic-beta: dreaming-2026-04-21. Learn how to send beta headers.Start an asynchronous job that uses past sessions to produce a reorganized version of a memory store and get back the dream to poll for the result.
List Dreams
anthropic-beta: dreaming-2026-04-21. Learn how to send beta headers.List the dreams in the workspace, newest first.
Get a Dream
anthropic-beta: dreaming-2026-04-21. Learn how to send beta headers.Get a dream by ID to check its status, output memory store, and token usage.
Cancel a Dream
anthropic-beta: dreaming-2026-04-21. Learn how to send beta headers.Stop a pending or running dream.
Archive a Dream
anthropic-beta: dreaming-2026-04-21. Learn how to send beta headers.Hide a completed, failed, or canceled dream from the default list of dreams.
BetaTunnels
Create Tunnel
anthropic-beta: mcp-tunnels-2026-06-22. Learn how to send beta headers.The Tunnels API is in research preview. It requires the anthropic-beta: mcp-tunnels-2026-06-22 header and may change without a deprecation period. It supersedes the Admin API endpoints at /v1/organizations/tunnels, which remain available during a migration window.
Get Tunnel
anthropic-beta: mcp-tunnels-2026-06-22. Learn how to send beta headers.The Tunnels API is in research preview. It requires the anthropic-beta: mcp-tunnels-2026-06-22 header and may change without a deprecation period. It supersedes the Admin API endpoints at /v1/organizations/tunnels, which remain available during a migration window.
List Tunnels
anthropic-beta: mcp-tunnels-2026-06-22. Learn how to send beta headers.The Tunnels API is in research preview. It requires the anthropic-beta: mcp-tunnels-2026-06-22 header and may change without a deprecation period. It supersedes the Admin API endpoints at /v1/organizations/tunnels, which remain available during a migration window.
Archive Tunnel
anthropic-beta: mcp-tunnels-2026-06-22. Learn how to send beta headers.The Tunnels API is in research preview. It requires the anthropic-beta: mcp-tunnels-2026-06-22 header and may change without a deprecation period. It supersedes the Admin API endpoints at /v1/organizations/tunnels, which remain available during a migration window.
Reveal Tunnel Token
anthropic-beta: mcp-tunnels-2026-06-22. Learn how to send beta headers.The Tunnels API is in research preview. It requires the anthropic-beta: mcp-tunnels-2026-06-22 header and may change without a deprecation period. It supersedes the Admin API endpoints at /v1/organizations/tunnels, which remain available during a migration window.
Rotate Tunnel Token
anthropic-beta: mcp-tunnels-2026-06-22. Learn how to send beta headers.The Tunnels API is in research preview. It requires the anthropic-beta: mcp-tunnels-2026-06-22 header and may change without a deprecation period. It supersedes the Admin API endpoints at /v1/organizations/tunnels, which remain available during a migration window.
BetaTunnelsCertificates
Create Tunnel Certificate
anthropic-beta: mcp-tunnels-2026-06-22. Learn how to send beta headers.The Tunnels API is in research preview. It requires the anthropic-beta: mcp-tunnels-2026-06-22 header and may change without a deprecation period. It supersedes the Admin API endpoints at /v1/organizations/tunnels, which remain available during a migration window.
Get Tunnel Certificate
anthropic-beta: mcp-tunnels-2026-06-22. Learn how to send beta headers.The Tunnels API is in research preview. It requires the anthropic-beta: mcp-tunnels-2026-06-22 header and may change without a deprecation period. It supersedes the Admin API endpoints at /v1/organizations/tunnels, which remain available during a migration window.
List Tunnel Certificates
anthropic-beta: mcp-tunnels-2026-06-22. Learn how to send beta headers.The Tunnels API is in research preview. It requires the anthropic-beta: mcp-tunnels-2026-06-22 header and may change without a deprecation period. It supersedes the Admin API endpoints at /v1/organizations/tunnels, which remain available during a migration window.
Archive Tunnel Certificate
anthropic-beta: mcp-tunnels-2026-06-22. Learn how to send beta headers.The Tunnels API is in research preview. It requires the anthropic-beta: mcp-tunnels-2026-06-22 header and may change without a deprecation period. It supersedes the Admin API endpoints at /v1/organizations/tunnels, which remain available during a migration window.
BetaOrganization
Get Current Organization
Retrieve information about the organization associated with the authenticated API key.
BetaOrganizationAPI Keys
List API Keys
Retrieve API Key (Admin API)
Retrieve information about a single API key in your organization, looked up by its ID. This Admin API endpoint requires an Admin API key, is intended for programmatic key management, and never returns the key's secret value. To view or create your own API keys, go to API keys in the Claude Console.
Update API Key
BetaOrganizationExternal Keys
Create External Key
Create an external key config owned by the caller's organization.
List External Keys
List external key configs in the caller's organization.
Get External Key
Retrieve a single external key config in the caller's organization by ID.
Update External Key
Partially update an external key config. Omitted fields are left unchanged.
Delete External Key
Delete an external key config.
Validate External Key
Validate an external key config against the customer's KMS.
BetaOrganizationFederationIssuers
Create Federation Issuer
Requires an OAuth access token with the org:admin scope, from ant auth login --scope org:admin or a workload identity federation rule; Admin API keys are not accepted. See Manage WIF with the Admin API.
List Federation Issuers
Requires an OAuth access token with the org:admin scope, from ant auth login --scope org:admin or a workload identity federation rule; Admin API keys are not accepted. See Manage WIF with the Admin API.
Get Federation Issuer
Requires an OAuth access token with the org:admin scope, from ant auth login --scope org:admin or a workload identity federation rule; Admin API keys are not accepted. See Manage WIF with the Admin API.
Update Federation Issuer
Requires an OAuth access token with the org:admin scope, from ant auth login --scope org:admin or a workload identity federation rule; Admin API keys are not accepted. See Manage WIF with the Admin API.
Archive Federation Issuer
Requires an OAuth access token with the org:admin scope, from ant auth login --scope org:admin or a workload identity federation rule; Admin API keys are not accepted. See Manage WIF with the Admin API.
BetaOrganizationFederationRules
Create Federation Rule
Requires an OAuth access token with the org:admin scope, from ant auth login --scope org:admin or a workload identity federation rule; Admin API keys are not accepted. See Manage WIF with the Admin API.
List Federation Rules
Requires an OAuth access token with the org:admin scope, from ant auth login --scope org:admin or a workload identity federation rule; Admin API keys are not accepted. See Manage WIF with the Admin API.
Get Federation Rule
Requires an OAuth access token with the org:admin scope, from ant auth login --scope org:admin or a workload identity federation rule; Admin API keys are not accepted. See Manage WIF with the Admin API.
Update Federation Rule
Requires an OAuth access token with the org:admin scope, from ant auth login --scope org:admin or a workload identity federation rule; Admin API keys are not accepted. See Manage WIF with the Admin API.
Archive Federation Rule
Requires an OAuth access token with the org:admin scope, from ant auth login --scope org:admin or a workload identity federation rule; Admin API keys are not accepted. See Manage WIF with the Admin API.
BetaOrganizationFederationRulesWorkspaces
Add Federation Rule Workspace
Requires an OAuth access token with the org:admin scope, from ant auth login --scope org:admin or a workload identity federation rule; Admin API keys are not accepted. See Manage WIF with the Admin API.
List Federation Rule Workspaces
Requires an OAuth access token with the org:admin scope, from ant auth login --scope org:admin or a workload identity federation rule; Admin API keys are not accepted. See Manage WIF with the Admin API.
Remove Federation Rule Workspace
Requires an OAuth access token with the org:admin scope, from ant auth login --scope org:admin or a workload identity federation rule; Admin API keys are not accepted. See Manage WIF with the Admin API.
BetaOrganizationInvites
BetaOrganizationService Accounts
Create Service Account
Requires an OAuth access token with the org:admin scope, from ant auth login --scope org:admin or a workload identity federation rule; Admin API keys are not accepted. See Manage WIF with the Admin API.
List Service Accounts
Requires an OAuth access token with the org:admin scope, from ant auth login --scope org:admin or a workload identity federation rule; Admin API keys are not accepted. See Manage WIF with the Admin API.
Get Service Account
Requires an OAuth access token with the org:admin scope, from ant auth login --scope org:admin or a workload identity federation rule; Admin API keys are not accepted. See Manage WIF with the Admin API.
Update Service Account
Requires an OAuth access token with the org:admin scope, from ant auth login --scope org:admin or a workload identity federation rule; Admin API keys are not accepted. See Manage WIF with the Admin API.
Archive Service Account
Requires an OAuth access token with the org:admin scope, from ant auth login --scope org:admin or a workload identity federation rule; Admin API keys are not accepted. See Manage WIF with the Admin API.
BetaOrganizationService AccountsWorkspaces
Add Workspace To Service Account
Requires an OAuth access token with the org:admin scope, from ant auth login --scope org:admin or a workload identity federation rule; Admin API keys are not accepted. See Manage WIF with the Admin API.
List Workspaces For Service Account
Requires an OAuth access token with the org:admin scope, from ant auth login --scope org:admin or a workload identity federation rule; Admin API keys are not accepted. See Manage WIF with the Admin API.
Remove Workspace From Service Account
Requires an OAuth access token with the org:admin scope, from ant auth login --scope org:admin or a workload identity federation rule; Admin API keys are not accepted. See Manage WIF with the Admin API.
BetaOrganizationUsers
Sign Out User
anthropic-beta: admin-user-sign-out-2026-10-08. Learn how to send beta headers.Sign a member out of Claude everywhere, without removing them from the organization. This ends their sign-in sessions and removes their trusted devices wherever they use Claude, including other organizations and individual plans. It also ends the OAuth tokens issued to them for this organization, so apps such as Claude Code must sign in again.
BetaOrganizationWorkspaces
List Workspaces
Create Workspace
Get Workspace
Update Workspace
Archive Workspace
BetaOrganizationWorkspacesRate Limits
List Workspace Rate Limits
List a workspace's rate limits.
Set Workspace Rate Limits
Set or clear rate-limit overrides for one rate-limit group in a workspace.
BetaOrganizationWorkspacesMembers
List Workspace Members
Create Workspace Member
Get Workspace Member
Update Workspace Member
Delete Workspace Member
BetaOrganizationWorkspacesService Accounts
List Service Account Workspace Members
Requires an OAuth access token with the org:admin scope, from ant auth login --scope org:admin or a workload identity federation rule; Admin API keys are not accepted. See Manage WIF with the Admin API.
Create Service Account Workspace Member
Requires an OAuth access token with the org:admin scope, from ant auth login --scope org:admin or a workload identity federation rule; Admin API keys are not accepted. See Manage WIF with the Admin API.
Get Service Account Workspace Member
Requires an OAuth access token with the org:admin scope, from ant auth login --scope org:admin or a workload identity federation rule; Admin API keys are not accepted. See Manage WIF with the Admin API.
Update Service Account Workspace Member
Requires an OAuth access token with the org:admin scope, from ant auth login --scope org:admin or a workload identity federation rule; Admin API keys are not accepted. See Manage WIF with the Admin API.
Delete Service Account Workspace Member
Requires an OAuth access token with the org:admin scope, from ant auth login --scope org:admin or a workload identity federation rule; Admin API keys are not accepted. See Manage WIF with the Admin API.
BetaOrganizationRate Limits
List Organization Rate Limits
List Messages API rate limits for your organization.
BetaOrganizationCompliance Settings
Get Compliance Settings
Retrieve your organization's Compliance Settings.
Update Compliance Settings
Update your organization's Compliance Settings.
BetaOrganizationUsage Report
Get Messages Usage Report
[Legacy] Get a report of your organization's Messages API usage, aggregated into time buckets.
Get Claude Code Usage Report
Retrieve daily aggregated usage metrics for Claude Code users. Enables organizations to analyze developer productivity and build custom dashboards.
BetaOrganizationCost Report
Get Cost Report
[Legacy] Get a report of your organization's Claude API costs in USD, aggregated into daily buckets.
BetaOrganizationMCP Tunnels
List Tunnels
anthropic-beta: mcp-tunnels-2026-05-19. Learn how to send beta headers.Deprecated. This Admin API endpoint is superseded by /v1/tunnels on the Claude API and will be removed after a migration window. New integrations should use /v1/tunnels with the anthropic-beta: mcp-tunnels-2026-06-22 header and a WIF token carrying the workspace:manage_tunnels scope. Existing integrations continue to work with the mcp-tunnels-2026-05-19 header and org:manage_tunnels scope during the migration window.
Get Tunnel
anthropic-beta: mcp-tunnels-2026-05-19. Learn how to send beta headers.Deprecated. This Admin API endpoint is superseded by /v1/tunnels on the Claude API and will be removed after a migration window. New integrations should use /v1/tunnels with the anthropic-beta: mcp-tunnels-2026-06-22 header and a WIF token carrying the workspace:manage_tunnels scope. Existing integrations continue to work with the mcp-tunnels-2026-05-19 header and org:manage_tunnels scope during the migration window.
Archive Tunnel
anthropic-beta: mcp-tunnels-2026-05-19. Learn how to send beta headers.Deprecated. This Admin API endpoint is superseded by /v1/tunnels on the Claude API and will be removed after a migration window. New integrations should use /v1/tunnels with the anthropic-beta: mcp-tunnels-2026-06-22 header and a WIF token carrying the workspace:manage_tunnels scope. Existing integrations continue to work with the mcp-tunnels-2026-05-19 header and org:manage_tunnels scope during the migration window.
Reveal Tunnel Token
anthropic-beta: mcp-tunnels-2026-05-19. Learn how to send beta headers.Deprecated. This Admin API endpoint is superseded by /v1/tunnels on the Claude API and will be removed after a migration window. New integrations should use /v1/tunnels with the anthropic-beta: mcp-tunnels-2026-06-22 header and a WIF token carrying the workspace:manage_tunnels scope. Existing integrations continue to work with the mcp-tunnels-2026-05-19 header and org:manage_tunnels scope during the migration window.
Rotate Tunnel Token
anthropic-beta: mcp-tunnels-2026-05-19. Learn how to send beta headers.Deprecated. This Admin API endpoint is superseded by /v1/tunnels on the Claude API and will be removed after a migration window. New integrations should use /v1/tunnels with the anthropic-beta: mcp-tunnels-2026-06-22 header and a WIF token carrying the workspace:manage_tunnels scope. Existing integrations continue to work with the mcp-tunnels-2026-05-19 header and org:manage_tunnels scope during the migration window.
BetaOrganizationMCP TunnelsTunnel Certificates
Create Tunnel Certificate
anthropic-beta: mcp-tunnels-2026-05-19. Learn how to send beta headers.Deprecated. This Admin API endpoint is superseded by /v1/tunnels on the Claude API and will be removed after a migration window. New integrations should use /v1/tunnels with the anthropic-beta: mcp-tunnels-2026-06-22 header and a WIF token carrying the workspace:manage_tunnels scope. Existing integrations continue to work with the mcp-tunnels-2026-05-19 header and org:manage_tunnels scope during the migration window.
List Tunnel Certificates
anthropic-beta: mcp-tunnels-2026-05-19. Learn how to send beta headers.Deprecated. This Admin API endpoint is superseded by /v1/tunnels on the Claude API and will be removed after a migration window. New integrations should use /v1/tunnels with the anthropic-beta: mcp-tunnels-2026-06-22 header and a WIF token carrying the workspace:manage_tunnels scope. Existing integrations continue to work with the mcp-tunnels-2026-05-19 header and org:manage_tunnels scope during the migration window.
Get Tunnel Certificate
anthropic-beta: mcp-tunnels-2026-05-19. Learn how to send beta headers.Deprecated. This Admin API endpoint is superseded by /v1/tunnels on the Claude API and will be removed after a migration window. New integrations should use /v1/tunnels with the anthropic-beta: mcp-tunnels-2026-06-22 header and a WIF token carrying the workspace:manage_tunnels scope. Existing integrations continue to work with the mcp-tunnels-2026-05-19 header and org:manage_tunnels scope during the migration window.
Archive Tunnel Certificate
anthropic-beta: mcp-tunnels-2026-05-19. Learn how to send beta headers.Deprecated. This Admin API endpoint is superseded by /v1/tunnels on the Claude API and will be removed after a migration window. New integrations should use /v1/tunnels with the anthropic-beta: mcp-tunnels-2026-06-22 header and a WIF token carrying the workspace:manage_tunnels scope. Existing integrations continue to work with the mcp-tunnels-2026-05-19 header and org:manage_tunnels scope during the migration window.
BetaOrganizationAnalyticsSummaries
Get Activity Summaries
Get organization-wide activity summaries for a date range.
BetaOrganizationAnalyticsUsers
List User Activity
Get per-user activity for a given day, with cursor-based pagination.
BetaOrganizationAnalyticsAppsChatProjects
Get Chat Project Usage
Get per-project activity for a given day, with cursor-based pagination.
BetaOrganizationAnalyticsConnectors
Get Connector Usage
Get per-connector usage for a given day, with cursor-based pagination.
BetaOrganizationAnalyticsPlugins
Get Plugin Usage
Get per-plugin install + invocation usage for a given day, with pagination.
BetaOrganizationAnalyticsSkills
Get Skill Usage
Get per-skill usage for a given day, with cursor-based pagination.
BetaOrganizationAnalyticsArtifacts
Get Artifact Activity
Get artifact-creation activity for a given day, broken out by MIME type.
BetaOrganizationAnalyticsUsage
Get Token Usage By Dimension
anthropic-beta: analytics-usage-cost-2026-08-24. Learn how to send beta headers.Get token usage across a date range, broken out by dimension.
BetaOrganizationAnalyticsCost
Get Cost By Dimension
anthropic-beta: analytics-usage-cost-2026-08-24. Learn how to send beta headers.Get cost in USD across a date range, broken out by dimension.
BetaOrganizationAnalyticsUsage Report
Get Token Usage Over Time
[Legacy] Get token usage over time across a date range.
BetaOrganizationAnalyticsUser Usage Report
Get Per-User Token Usage
[Legacy] Get per-user token usage across a date range.
BetaOrganizationAnalyticsCost Report
Get Cost Over Time
[Legacy] Get cost in USD over time across a date range.
BetaOrganizationAnalyticsUser Cost Report
Get Per-User Cost
[Legacy] Get per-user cost in USD across a date range.
BetaOrganizationSpend Limits
List Spend Limits
anthropic-beta: spend-limit-reads-2026-09-26. Learn how to send beta headers.List the organization's spend limits.
BetaOrganizationSpend LimitsEffective
List Effective Spend Limits
List each member's effective spend limit and period-to-date spend.
BetaOrganizationSpend LimitsIncrease Requests
List Spend Limit Increase Requests
List spend limit increase requests, most recent first.
Get Spend Limit Increase Request
Retrieve a spend limit increase request.
Approve Spend Limit Increase Request
Approve a pending spend limit increase request.
Deny Spend Limit Increase Request
Deny a pending spend limit increase request.
BetaOrganizationRBAC Groups
Create RBAC Group
Create an RBAC Group in the Claude Enterprise tenant. Groups created via the API have source type "direct".
Update RBAC Group
Update an RBAC Group's name. Groups provisioned by an identity provider (source type "scim") cannot be modified via the API while an organization in the tenant uses SCIM provisioning.
Delete RBAC Group
Delete an RBAC Group. Groups provisioned by an identity provider (source type "scim") cannot be deleted via the API while an organization in the tenant uses SCIM provisioning.
BetaOrganizationRBAC GroupsMembers
List RBAC Group Members
List members of an RBAC Group.
Add RBAC Group Member
Add a User to an RBAC Group. Membership of groups provisioned by an identity provider (source type "scim") cannot be modified via the API while an organization in the tenant uses SCIM provisioning.
Remove RBAC Group Member
Remove a User from an RBAC Group. Membership of groups provisioned by an identity provider (source type "scim") cannot be modified via the API while an organization in the tenant uses SCIM provisioning.
BetaOrganizationRBAC Roles
BetaOrganizationRBAC RolesPermissions
List RBAC Role Permissions
List the permissions an RBAC Role grants.
BetaOrganizationPlugins
Create Plugin
anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.Create an organization-owned Plugin and its first version by uploading the version's files.
Get Plugin
anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.Retrieve a Plugin by ID.
Update Plugin
anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.Change which stored version of an organization-owned Plugin is served to members, for example to roll back to an earlier one. This pins the served version: later uploads are stored but no longer change what is served, and pinning cannot currently be undone, here or in claude.ai.
List Plugins
anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.List the Plugins created under the organization, newest first: those in the organization's own plugin marketplaces and those in members' personal plugin marketplaces.
Delete Plugin
anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.Permanently delete a Plugin and every version it holds, exactly as when an administrator deletes it in claude.ai. The Plugin may belong to the organization or to a member, including a member who has since left the organization. Do not delete a Plugin only because your pipeline did not create it: a member or an administrator might have added it in claude.ai.
BetaOrganizationPluginsVersions
Create Plugin Version
anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.Add a version to an organization-owned Plugin by uploading the new version's files; it becomes the version served to members unless the Plugin's served version has been pinned.
List Plugin Versions
anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.List a Plugin's versions, newest first.
Get Plugin Version
anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.Retrieve one version of a Plugin by its ID, or the Plugin's newest version.
Download Plugin Version Archive
anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.Download one version's .zip archive, exactly as stored. Each download of a
Plugin from a member's personal plugin marketplace is recorded on the Compliance API
activity feed.
BetaOrganizationPluginsInstallation Settings
List Plugin Installation Settings
anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.List an organization-owned Plugin's installation settings, which say which members it is for, most recently created first.
Set Plugin Installation Setting
anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.Set or change an organization-owned Plugin's installation setting for the whole organization or for one RBAC Group.
Remove Plugin Installation Setting
anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.Remove an organization-owned Plugin's own installation setting for the whole organization or for one RBAC Group.
BetaOrganizationPlugin Marketplaces
List Plugin Marketplaces
anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.List the plugin marketplaces Plugins live in, newest first: the organization's own and its members' personal ones.
Get Plugin Marketplace
anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.Retrieve a plugin marketplace by ID.
Update Plugin Marketplace
anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.Set the default installation setting of one of the organization's own plugin marketplaces. Every Plugin in it without a setting of its own gets this default as its organization-wide setting, including Plugins added later.
Validate Plugin Marketplace Repository
anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.Check whether a plugin marketplace held in a public GitHub repository would synchronize into claude.ai, without connecting or storing it.
Validate Plugin Marketplace Archive
anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.Check whether a plugin marketplace, uploaded as a .zip of the marketplace
directory, would synchronize into claude.ai, without connecting or storing it.
BetaOrganizationTelemetry Destinations
Create a Telemetry Destination
anthropic-beta: telemetry-destinations-2026-08-11. Learn how to send beta headers.Register an OpenTelemetry destination for the organization.
List Telemetry Destinations
anthropic-beta: telemetry-destinations-2026-08-11. Learn how to send beta headers.List the organization's destinations, newest first, optionally only those that cover given workspaces.
Retrieve a Telemetry Destination
anthropic-beta: telemetry-destinations-2026-08-11. Learn how to send beta headers.Read a destination's configuration, state, and most recent delivery results.
Update a Telemetry Destination
anthropic-beta: telemetry-destinations-2026-08-11. Learn how to send beta headers.Change a telemetry destination's settings, its state, or which workspaces it covers.
Delete a Telemetry Destination
anthropic-beta: telemetry-destinations-2026-08-11. Learn how to send beta headers.Delete a destination and its workspace list.
Test a Telemetry Destination
anthropic-beta: telemetry-destinations-2026-08-11. Learn how to send beta headers.Send one test span, named anthropic.test, to the destination with its registered headers, once and without retries, and report the destination's answer. The response is 200 whether or not the destination answered with a 2xx status: its result has the type success, or the type failure and the reason in error. The destination's configuration, state and delivery_health do not change. A disabled destination can be tested too. Wait 10 seconds between tests of one destination; a request that comes sooner may be answered with status 429.
BetaOrganizationTelemetry DestinationsWorkspaces
List Telemetry Destination Workspaces
anthropic-beta: telemetry-destinations-2026-08-11. Learn how to send beta headers.List the workspaces on a destination's workspace list, newest entry first.
Add a Telemetry Destination Workspace
anthropic-beta: telemetry-destinations-2026-08-11. Learn how to send beta headers.Add one workspace to a destination's workspace list.
Remove a Telemetry Destination Workspace
anthropic-beta: telemetry-destinations-2026-08-11. Learn how to send beta headers.Remove one workspace from a destination's workspace list.
BetaOrganizationWebhooks
Create Organization Webhook Endpoint
anthropic-beta: webhooks-2026-10-07. Learn how to send beta headers.Create an organization webhook endpoint.
List Organization Webhook Endpoints
anthropic-beta: webhooks-2026-10-07. Learn how to send beta headers.List the organization's webhook endpoints.
Get Organization Webhook Endpoint
anthropic-beta: webhooks-2026-10-07. Learn how to send beta headers.Retrieve an organization webhook endpoint by ID.
Update Organization Webhook Endpoint
anthropic-beta: webhooks-2026-10-07. Learn how to send beta headers.Update an organization webhook endpoint. Only the fields you send are changed.
Delete Organization Webhook Endpoint
anthropic-beta: webhooks-2026-10-07. Learn how to send beta headers.Delete an organization webhook endpoint.
Regenerate Organization Webhook Endpoint Signing Secret
anthropic-beta: webhooks-2026-10-07. Learn how to send beta headers.Replace an organization webhook endpoint's signing secret. The old secret stops working immediately. The new secret is returned only in this response.
BetaOrganizationClaude TagSlack Channels
Set Up Slack Channel
anthropic-beta: experimental-claude-tag-2026-10-21. Learn how to send beta headers.Set a Slack channel up for Claude Tag and return it with its identifier. If the channel is already set up, whether in claude.ai, by Claude's first use in it or by an earlier request, the existing channel is returned, so the request can be repeated. settings, when sent, is applied as an update applies it. Before a channel is set up, Claude's Slack app confirms with Slack that the channel is in the workspace, is not archived and is visible to the app; a channel that fails the confirmation returns 404. Setting the channel up and applying settings are two steps: when the second is refused, the response is the refusal, the channel stays set up with every setting unset, and the error's details.slack_channel_id holds the channel's identifier.
List Slack Channels
anthropic-beta: experimental-claude-tag-2026-10-21. Learn how to send beta headers.List the set-up Slack channels of one Slack workspace, newest first by created_at. A channel that is not set up is not listed: Slack holds the full list of a workspace's channels. Pass slack_channel_id as well to look one channel up by its Slack identifiers: data then holds that channel, or is empty when it is not set up, and limit and page are ignored. A workspace that the organization owns only through a Slack Enterprise Grid returns 404 until it is set up. With include_inherited=true each channel's settings holds what applies in it, and the request fails with 503 rather than resolve against a settings level that could not be read. A page cursor resumes only a request with the same include_inherited.
Get Slack Channel
anthropic-beta: experimental-claude-tag-2026-10-21. Learn how to send beta headers.Get one Slack channel and its settings. By default settings holds what the channel itself stores: a setting that is null there is not set on the channel and is inherited. With include_inherited=true, settings holds what applies in the channel once the settings levels above it are taken into account, and the request fails with 503 rather than resolve against a settings level that could not be read. Either way sources names the settings level each value comes from, so a caller tells the channel's own value from an inherited one by its source, not by whether it is null.
Update Slack Channel
anthropic-beta: experimental-claude-tag-2026-10-21. Learn how to send beta headers.Change the settings a Slack channel stores. The update is partial: a setting left out is unchanged, and a setting sent as null is cleared, so the channel inherits it. If any value is refused, no setting in the request is stored. A group direct message takes no settings and returns 400.
Remove Slack Channel
anthropic-beta: experimental-claude-tag-2026-10-21. Learn how to send beta headers.Remove a Slack channel from Claude Tag. This deletes the channel's stored settings and its Bundle Targets at once, and then, in the background, the channel's sessions and their transcripts, its memory, its routines and the artifacts published from it. None of it can be restored. The channel in Slack and its messages are unchanged. The request is refused with 400 and error.details.error_code slack_channel_enabled while enabled resolves to true for the channel, as a read with include_inherited=true returns it: set enabled to false on the channel first. This guards against removing a channel in use by mistake; it is not a way to keep Claude out, because the removal deletes the channel's own enabled: false with its other settings, after which the channel inherits again and Claude's next use of it can set it up anew with a new identifier. The identifier returns 404 as soon as the request returns, so a repeated removal returns 404. A group direct message returns 400, and so does a channel that holds configuration this API does not manage.
BetaOrganizationClaude TagSlack Workspaces
List Slack Workspaces
anthropic-beta: experimental-claude-tag-2026-10-21. Learn how to send beta headers.List the set-up Slack workspaces the organization owns, newest first by created_at. Pass slack_workspace_id to look one workspace up by its Slack identifier: data then holds that workspace, or is empty when it is not set up. A workspace of a Slack Enterprise Grid the organization has connected returns 404 until it is set up. With include_inherited=true each workspace's settings holds what applies in it, and the request fails with 503 rather than resolve against a settings level that could not be read. A page cursor resumes only a request with the same include_inherited.
Get Slack Workspace
anthropic-beta: experimental-claude-tag-2026-10-21. Learn how to send beta headers.Get one Slack workspace and its settings. By default settings holds what the workspace itself stores: a setting that is null there is not set on the workspace and is inherited. With include_inherited=true, settings holds what applies in the workspace once the organization's Slack defaults are taken into account, and the request fails with 503 rather than resolve against a settings level that could not be read. Either way sources names the settings level each value comes from.
Update Slack Workspace
anthropic-beta: experimental-claude-tag-2026-10-21. Learn how to send beta headers.Change the settings a Slack workspace stores. The update is partial: a setting left out is unchanged, and a setting sent as null is cleared, so the workspace inherits it. If any value is refused, no setting in the request is stored.
BetaOrganizationClaude TagBundles
List Bundles
anthropic-beta: experimental-claude-tag-2026-10-21. Learn how to send beta headers.List the organization's Bundles, newest first by created_at. A Bundle that Claude Tag manages for itself is not listed.
Get Bundle
anthropic-beta: experimental-claude-tag-2026-10-21. Learn how to send beta headers.Get one Bundle. What the Bundle grants (connectors, repositories and credentials) is never returned.
Update Bundle
anthropic-beta: experimental-claude-tag-2026-10-21. Learn how to send beta headers.Change a Bundle's instructions. The update is partial: a field left out is unchanged, and instructions sent as null or as an empty string clears them. The later of two updates wins. Sessions that start after the change use the new instructions; sessions already running keep the ones they started with. Some Bundles are managed in claude.ai, and an update of one returns 400.
BetaOrganizationClaude TagBundlesTargets
List Bundle Targets
anthropic-beta: experimental-claude-tag-2026-10-21. Learn how to send beta headers.List the Slack channels and Slack workspaces a Bundle is attached to, newest first by created_at. Only channels and workspaces the organization owns are listed; a Bundle that is attached to anything else has no Bundle Target for it.
Attach Bundle
anthropic-beta: experimental-claude-tag-2026-10-21. Learn how to send beta headers.Attach a Bundle to a Slack channel or a Slack workspace. A Bundle attached to a workspace can be used in the workspace and in every channel in it. Attaching a Bundle to a channel or workspace it is already attached to returns the existing Bundle Target. The channel or workspace must be set up: attaching never sets a channel up. A group direct message takes no Bundle and returns 400.
Get Bundle Target
anthropic-beta: experimental-claude-tag-2026-10-21. Learn how to send beta headers.Get one Bundle Target. Returns 404 when target_id is the identifier of another Bundle's Bundle Target, or the Bundle Target was detached.
Detach Bundle
anthropic-beta: experimental-claude-tag-2026-10-21. Learn how to send beta headers.Detach a Bundle from a Slack channel or a Slack workspace. A repeated detach returns 404.