Claude Platform Docs

Agenten

Agent erstellen
$client->beta->agents->create(Model model, string name, ?string description, ?list<BetaManagedAgentsURLMCPServerParams> mcpServers, ?array<string,string> metadata, ?BetaManagedAgentsMultiagentParams multiagent, ?list<BetaManagedAgentsSkillParams> skills, ?string system, ?list<Tool> tools, ?list<AnthropicBeta> betas, ?string workspaceID): BetaManagedAgentsAgent
POST/v1/agents
Agenten auflisten
$client->beta->agents->list(?\Datetime createdAtGte, ?\Datetime createdAtLte, ?bool includeArchived, ?int limit, ?string page, ?list<AnthropicBeta> betas, ?string workspaceID): PageCursor<BetaManagedAgentsAgent>
GET/v1/agents
Agent abrufen
$client->beta->agents->retrieve(string agentID, ?int version, ?list<AnthropicBeta> betas, ?string workspaceID): BetaManagedAgentsAgent
GET/v1/agents/{agent_id}
Agent aktualisieren
$client->beta->agents->update(string agentID, ?string description, ?list<BetaManagedAgentsURLMCPServerParams> mcpServers, ?array<string,string> metadata, ?Model model, ?BetaManagedAgentsMultiagentParams multiagent, ?string name, ?list<BetaManagedAgentsSkillParams> skills, ?string system, ?list<Tool> tools, ?int version, ?list<AnthropicBeta> betas, ?string workspaceID): BetaManagedAgentsAgent
POST/v1/agents/{agent_id}
Agent archivieren
$client->beta->agents->archive(string agentID, ?list<AnthropicBeta> betas, ?string workspaceID): BetaManagedAgentsAgent
POST/v1/agents/{agent_id}/archive
Models
class BetaManagedAgentsAdvisor { $type; $model; }
Type type
string model

The advisor model id.

class BetaManagedAgentsAgent { $type; $id; $archivedAt; /* 12 more */ }
class BetaManagedAgentsAgentReference { $type; $id; $version; }
Type type
string id
int version
class BetaManagedAgentsAgentToolConfig
One of the following:
class BetaManagedAgentsAgentToolConfigParams
One of the following:
class BetaManagedAgentsAgentToolsetDefaultConfig { $enabled; $permissionPolicy; }
bool enabled
PermissionPolicy permissionPolicy

Permission policy for tool execution.

class BetaManagedAgentsAgentToolsetDefaultConfigParams { $enabled; $permissionPolicy; }
?bool enabled

Whether tools are enabled and available to Claude by default. Defaults to true if not specified.

?PermissionPolicy permissionPolicy

Permission policy for tool execution.

class BetaManagedAgentsAgentToolset20260401 { $type; $configs; $defaultConfig; }
Type type
BetaManagedAgentsAgentToolsetDefaultConfig defaultConfig

Resolved default configuration for agent tools.

class BetaManagedAgentsAgentToolset20260401BashInput { $command; $restart; $timeoutMs; }
?string command

Shell command to execute. Omit only when restart is true.

?bool restart

When true, restart the persistent bash session instead of running a command. Subsequent calls without restart will run against the fresh session.

?int timeoutMs

Per-call timeout in milliseconds. Defaults to the runner-wide tool timeout when omitted or zero.

class BetaManagedAgentsAgentToolset20260401EditInput { $filePath; $newString; $oldString; $replaceAll; }
string filePath

Path of the file to edit.

string newString

Replacement text.

string oldString

Substring to find and replace.

?bool replaceAll

When true, replace every occurrence of old_string instead of requiring a unique match.

class BetaManagedAgentsAgentToolset20260401GlobInput { $pattern; $path; }
string pattern

Doublestar glob pattern (e.g. **/*.go). Absolute patterns are only permitted when the runner is configured to allow them.

?string path

Optional directory root to search under. Defaults to the runner's working directory.

class BetaManagedAgentsAgentToolset20260401GrepInput { $pattern; $path; }
string pattern

Regular expression to search for.

?string path

Optional directory root to search under. Defaults to the runner's working directory.

class BetaManagedAgentsAgentToolset20260401Params { $type; $configs; $defaultConfig; }
Type type
?list<BetaManagedAgentsAgentToolConfigParams> configs

Per-tool configuration overrides.

?BetaManagedAgentsAgentToolsetDefaultConfigParams defaultConfig

Default configuration for all tools in a toolset.

class BetaManagedAgentsAgentToolset20260401ReadInput { $filePath; $viewRange; }
string filePath

Path of the file to read.

?list<int> viewRange

Optional [start_line, end_line] 1-indexed inclusive range. When omitted the entire file is returned. end_line of 0 or negative means "to end of file".

class BetaManagedAgentsAgentToolset20260401WriteInput { $content; $filePath; }
string content

Full file contents to write.

string filePath

Path of the file to write.

class BetaManagedAgentsAlwaysAllowPolicy { $type; }
Type type
class BetaManagedAgentsAlwaysAskPolicy { $type; }
Type type
class BetaManagedAgentsAnthropicSkill { $type; $skillID; $version; }
Type type
string skillID
string version
class BetaManagedAgentsAnthropicSkillParams { $type; $skillID; $version; }
Type type
string skillID

Identifier of the Anthropic skill (e.g., "xlsx").

?string version

Version to pin. Defaults to latest if omitted.

class BetaManagedAgentsAutoPolicy { $type = 'auto'; }
"auto" type
class BetaManagedAgentsBashToolConfig { $type = 'bash'; $enabled; $name; $permissionPolicy; }
"bash" type
bool enabled
"bash" name
PermissionPolicy permissionPolicy

Permission policy for tool execution.

class BetaManagedAgentsBashToolConfigParams { $type; $name; $enabled; $permissionPolicy; }
?Type type
"bash" name

Must be "bash".

?bool enabled

Whether this tool is enabled and available to Claude. Overrides the default_config setting.

?PermissionPolicy permissionPolicy

Permission policy for tool execution.

class BetaManagedAgentsCustomSkill { $type; $skillID; $version; }
Type type
string skillID
string version
class BetaManagedAgentsCustomSkillParams { $type; $skillID; $version; }
Type type
string skillID

Tagged ID of the custom skill (e.g., "skill_01XJ5...").

?string version

Version to pin. Defaults to latest if omitted.

class BetaManagedAgentsCustomTool { $type; $description; $inputSchema; $name; }
Type type
string description
BetaManagedAgentsCustomToolInputSchema inputSchema

JSON Schema for custom tool input parameters.

string name
class BetaManagedAgentsCustomToolInputSchema { $type = 'object'; $properties; $required; }
"object" type
?array<string,mixed> properties
?list<string> required
class BetaManagedAgentsCustomToolParams { $type; $description; $inputSchema; $name; }
Type type
string description

Description of what the tool does, shown to the agent to help it decide when to use the tool.

BetaManagedAgentsCustomToolInputSchema inputSchema

JSON Schema for custom tool input parameters.

string name

Unique name for the tool. 1-128 characters; letters, digits, underscores, and hyphens.

class BetaManagedAgentsEditToolConfig { $type = 'edit'; $enabled; $name; $permissionPolicy; }
"edit" type
bool enabled
"edit" name
PermissionPolicy permissionPolicy

Permission policy for tool execution.

class BetaManagedAgentsEditToolConfigParams { $type; $name; $enabled; $permissionPolicy; }
?Type type
"edit" name

Must be "edit".

?bool enabled

Whether this tool is enabled and available to Claude. Overrides the default_config setting.

?PermissionPolicy permissionPolicy

Permission policy for tool execution.

class BetaManagedAgentsEffortHigh { $type; }
Type type
class BetaManagedAgentsEffortLow { $type; }
Type type
class BetaManagedAgentsEffortMax { $type; }
Type type
class BetaManagedAgentsEffortMedium { $type; }
Type type
class BetaManagedAgentsEffortXhigh { $type; }
Type type
class BetaManagedAgentsGlobToolConfig { $type = 'glob'; $enabled; $name; $permissionPolicy; }
"glob" type
bool enabled
"glob" name
PermissionPolicy permissionPolicy

Permission policy for tool execution.

class BetaManagedAgentsGlobToolConfigParams { $type; $name; $enabled; $permissionPolicy; }
?Type type
"glob" name

Must be "glob".

?bool enabled

Whether this tool is enabled and available to Claude. Overrides the default_config setting.

?PermissionPolicy permissionPolicy

Permission policy for tool execution.

class BetaManagedAgentsGrepToolConfig { $type = 'grep'; $enabled; $name; $permissionPolicy; }
"grep" type
bool enabled
"grep" name
PermissionPolicy permissionPolicy

Permission policy for tool execution.

class BetaManagedAgentsGrepToolConfigParams { $type; $name; $enabled; $permissionPolicy; }
?Type type
"grep" name

Must be "grep".

?bool enabled

Whether this tool is enabled and available to Claude. Overrides the default_config setting.

?PermissionPolicy permissionPolicy

Permission policy for tool execution.

class BetaManagedAgentsMCPServerURLDefinition { $type; $name; $url; }
Type type
string name
string url
class BetaManagedAgentsMCPToolConfig { $enabled; $name; $permissionPolicy; }
bool enabled
string name
PermissionPolicy permissionPolicy

Permission policy for tool execution.

class BetaManagedAgentsMCPToolConfigParams { $name; $enabled; $permissionPolicy; }
string name

Name of the MCP tool to configure. 1-128 characters.

?bool enabled

Whether this tool is enabled. Overrides the default_config setting.

?PermissionPolicy permissionPolicy

Permission policy for tool execution.

class BetaManagedAgentsMCPToolset { $type; $configs; $defaultConfig; $mcpServerName; }
Type type
BetaManagedAgentsMCPToolsetDefaultConfig defaultConfig

Resolved default configuration for all tools from an MCP server.

string mcpServerName
class BetaManagedAgentsMCPToolsetDefaultConfig { $enabled; $permissionPolicy; }
bool enabled
PermissionPolicy permissionPolicy

Permission policy for tool execution.

class BetaManagedAgentsMCPToolsetDefaultConfigParams { $enabled; $permissionPolicy; }
?bool enabled

Whether tools are enabled by default. Defaults to true if not specified.

?PermissionPolicy permissionPolicy

Permission policy for tool execution.

class BetaManagedAgentsMCPToolsetParams { $type; $mcpServerName; $configs; $defaultConfig; }
Type type
string mcpServerName

Name of the MCP server. Must match a server name from the mcp_servers array. 1-255 characters.

?list<BetaManagedAgentsMCPToolConfigParams> configs

Per-tool configuration overrides.

?BetaManagedAgentsMCPToolsetDefaultConfigParams defaultConfig

Default configuration for all tools from an MCP server.

enum BetaManagedAgentsModel
One of the following:
"claude-fable-5-1"

Frontier intelligence for ambitious tasks across coding, scientific discovery, and enterprise workflows

"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

class BetaManagedAgentsModelConfig { $id; $effort; $inferenceGeo; $speed; }
BetaManagedAgentsModel id

The model that will power your agent.

See models for additional details and options.

?Effort effort

How hard Claude works on each turn. Sets output_config.effort on every Messages call the session makes.

?string inferenceGeo

Geographic region for model inference. When unset, requests fall through to the workspace's default_inference_geo.

?Speed speed

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.

class BetaManagedAgentsModelConfigParams { $id; $effort; $inferenceGeo; $speed; }
BetaManagedAgentsModel id

The model that will power your agent.

See models for additional details and options.

?Effort effort

How hard Claude works on each inference call. Accepts a bare level string ("high") or {"type": "high"}. On create, omitting it resolves the per-model default; on update, omitting it leaves the stored value unchanged.

?string inferenceGeo

Geographic region for model inference. When unset, requests fall through to the workspace's default_inference_geo. On update, model is whole-object replacement — omitting inference_geo clears it.

?Speed speed

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.

class BetaManagedAgentsMultiagentCoordinator { $type; $agents; }
Type type
list<Agent> agents

Agents the coordinator may spawn as session threads, each resolved to a specific version.

class BetaManagedAgentsMultiagentCoordinatorParams { $type; $agents; }
Type type
list<BetaManagedAgentsMultiagentRosterEntryParams> agents

Agents the coordinator may spawn as session threads. 1–20 entries. Each entry is an agent ID string, a versioned {"type":"agent","id","version"} reference, or {"type":"self"} to allow recursive self-invocation. Entries must reference distinct agents (after resolving self and string forms); at most one self. Referenced agents must exist, must not be archived, and must not themselves have multiagent set (depth limit 1).

class BetaManagedAgentsMultiagentSelfParams { $type; }
Type type
class BetaManagedAgentsReadToolConfig { $type = 'read'; $enabled; $name; $permissionPolicy; }
"read" type
bool enabled
"read" name
PermissionPolicy permissionPolicy

Permission policy for tool execution.

class BetaManagedAgentsReadToolConfigParams { $type; $name; $enabled; $permissionPolicy; }
?Type type
"read" name

Must be "read".

?bool enabled

Whether this tool is enabled and available to Claude. Overrides the default_config setting.

?PermissionPolicy permissionPolicy

Permission policy for tool execution.

class BetaManagedAgentsSessionThreadAgent { $type; $id; $description; /* 7 more */ }
Type type
string id
?string description
BetaManagedAgentsModelConfig model

Model identifier and configuration.

string name
list<Skill> skills
?string system
list<Tool> tools
int version
class BetaManagedAgentsSkillParams
One of the following:
class BetaManagedAgentsAnthropicSkillParams { $type; $skillID; $version; }
Type type
string skillID

Identifier of the Anthropic skill (e.g., "xlsx").

?string version

Version to pin. Defaults to latest if omitted.

class BetaManagedAgentsCustomSkillParams { $type; $skillID; $version; }
Type type
string skillID

Tagged ID of the custom skill (e.g., "skill_01XJ5...").

?string version

Version to pin. Defaults to latest if omitted.

class BetaManagedAgentsURLMCPServerParams { $type; $name; $url; }
Type type
string name

Unique name for this server, referenced by mcp_toolset configurations. 1-255 characters.

string url

Endpoint URL for the MCP server.

class BetaManagedAgentsUserLocation { $type = 'approximate'; $city; $country; /* 2 more */ }
"approximate" type

Location precision. Only "approximate" is supported.

?string city

City name.

?string country

Two-letter ISO 3166-1 country code, uppercase.

?string region

Region or state name.

?string timezone

IANA timezone identifier, e.g. "America/Los_Angeles".

class BetaManagedAgentsWebFetchToolConfig { $type = 'web_fetch'; $enabled; $name; /* 4 more */ }
"web_fetch" type
bool enabled
"web_fetch" name
PermissionPolicy permissionPolicy

Permission policy for tool execution.

?list<string> allowedDomains
?list<string> blockedDomains
?int maxContentTokens
class BetaManagedAgentsWebFetchToolConfigParams { $type; $name; $allowedDomains; /* 4 more */ }
?Type type
"web_fetch" name

Must be "web_fetch".

?list<string> allowedDomains

Only fetch URLs whose host is one of these domains or a subdomain of one. Each entry is a plain hostname like "docs.example.com" (no scheme, port, or path). At most 64 entries; an empty list is rejected (omit the field instead). Cannot be combined with blocked_domains.

?list<string> blockedDomains

Never fetch URLs whose host is one of these domains or a subdomain of one. Each entry is a plain hostname like "ads.example.com" (no scheme, port, or path). At most 64 entries; an empty list is rejected (omit the field instead). Cannot be combined with allowed_domains.

?bool enabled

Whether this tool is enabled and available to Claude. Overrides the default_config setting.

?int maxContentTokens

Maximum number of tokens of fetched text content to include in context per call. Does not apply to binary content such as PDFs.

?PermissionPolicy permissionPolicy

Permission policy for tool execution.

class BetaManagedAgentsWebSearchToolConfig { $type = 'web_search'; $enabled; $name; /* 4 more */ }
"web_search" type
bool enabled
"web_search" name
PermissionPolicy permissionPolicy

Permission policy for tool execution.

?list<string> allowedDomains
?list<string> blockedDomains
?BetaManagedAgentsUserLocation userLocation

Approximate user location for search result localization.

class BetaManagedAgentsWebSearchToolConfigParams { $type; $name; $allowedDomains; /* 4 more */ }
?Type type
"web_search" name

Must be "web_search".

?list<string> allowedDomains

Only return search results whose host is one of these domains or a subdomain of one. Each entry is a plain hostname like "docs.example.com" (no scheme or port; an optional path suffix is accepted). At most 64 entries; an empty list is rejected (omit the field instead). Cannot be combined with blocked_domains.

?list<string> blockedDomains

Never return search results whose host is one of these domains or a subdomain of one. Each entry is a plain hostname like "ads.example.com" (no scheme or port; an optional path suffix is accepted). At most 64 entries; an empty list is rejected (omit the field instead). Cannot be combined with allowed_domains.

?bool enabled

Whether this tool is enabled and available to Claude. Overrides the default_config setting.

?PermissionPolicy permissionPolicy

Permission policy for tool execution.

?BetaManagedAgentsUserLocation userLocation

Approximate user location for search result localization.

class BetaManagedAgentsWriteToolConfig { $type = 'write'; $enabled; $name; $permissionPolicy; }
"write" type
bool enabled
"write" name
PermissionPolicy permissionPolicy

Permission policy for tool execution.

class BetaManagedAgentsWriteToolConfigParams { $type; $name; $enabled; $permissionPolicy; }
?Type type
"write" name

Must be "write".

?bool enabled

Whether this tool is enabled and available to Claude. Overrides the default_config setting.

?PermissionPolicy permissionPolicy

Permission policy for tool execution.

AgentenVersionen

Agent-Versionen auflisten
$client->beta->agents->versions->list(string agentID, ?int limit, ?string page, ?list<AnthropicBeta> betas, ?string workspaceID): PageCursor<BetaManagedAgentsAgent>
GET/v1/agents/{agent_id}/versions