{ "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://raw.githubusercontent.com/api-evangelist/anthropic/main/json-schema/anthropic-beta-managed-agents-list-agents-schema.json", "title": "BetaManagedAgentsListAgents", "description": "Paginated list of agents.", "x-generated": "2026-09-23", "x-method": "derived", "x-generator": "derive-json-schema.py", "x-source": "openapi/anthropic-agents-beta-true-api-openapi.yml#/components/schemas/BetaManagedAgentsListAgents", "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": { "description": "List of agents.", "x-stainless-pagination-property": { "purpose": "items" }, "type": "array", "items": { "$ref": "#/$defs/BetaManagedAgentsAgent" } }, "next_page": { "description": "Opaque cursor for the next page. Null when no more results.", "x-stainless-pagination-property": { "purpose": "next_cursor_field" }, "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "$defs": { "BetaManagedAgentsAdvisor": { "description": "Platform advisor roster entry: a model the session's primary thread may consult mid-turn.", "type": "object", "additionalProperties": false, "required": [ "type", "model" ], "properties": { "type": { "type": "string", "enum": [ "advisor" ] }, "model": { "description": "The advisor model id.", "type": "string" } } }, "BetaManagedAgentsAgent": { "description": "A Managed Agents `agent`.", "type": "object", "additionalProperties": false, "required": [ "type", "id", "version", "name", "description", "model", "system", "tools", "mcp_servers", "skills", "metadata", "created_at", "updated_at", "archived_at", "multiagent" ], "properties": { "type": { "type": "string", "enum": [ "agent" ] }, "id": { "type": "string" }, "version": { "description": "The agent's current version. Starts at 1 and increments when the agent is modified.", "type": "integer", "format": "int32" }, "name": { "type": "string" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "model": { "$ref": "#/$defs/BetaManagedAgentsModelConfig" }, "system": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "tools": { "type": "array", "items": { "$ref": "#/$defs/BetaManagedAgentsAgentTool" } }, "mcp_servers": { "type": "array", "items": { "$ref": "#/$defs/BetaManagedAgentsMCPServer" } }, "skills": { "type": "array", "items": { "$ref": "#/$defs/BetaManagedAgentsSkill" } }, "metadata": { "type": "object", "additionalProperties": { "type": "string" } }, "created_at": { "$ref": "#/$defs/BetaTimestamp" }, "updated_at": { "$ref": "#/$defs/BetaTimestamp" }, "archived_at": { "description": "When the agent was archived. Null if not archived.", "anyOf": [ { "$ref": "#/$defs/BetaTimestamp" }, { "type": "null" } ] }, "multiagent": { "description": "Multiagent orchestration configuration. Null when the agent is single-threaded.", "anyOf": [ { "$ref": "#/$defs/BetaManagedAgentsMultiagent" }, { "type": "null" } ], "x-anthropic-beta-required": [ "managed-agents-2026-04-01" ] } } }, "BetaManagedAgentsAgentReference": { "description": "A resolved agent reference with a concrete version.", "type": "object", "additionalProperties": false, "required": [ "type", "id", "version" ], "properties": { "type": { "type": "string", "enum": [ "agent" ] }, "id": { "type": "string" }, "version": { "type": "integer", "format": "int32" } } }, "BetaManagedAgentsAgentTool": { "description": "Union type for tool configurations returned in API responses.", "type": "object", "oneOf": [ { "$ref": "#/$defs/BetaManagedAgentsAgentToolset20260401" }, { "$ref": "#/$defs/BetaManagedAgentsMCPToolset" }, { "$ref": "#/$defs/BetaManagedAgentsCustomTool" } ] }, "BetaManagedAgentsAgentToolConfigUnion": { "description": "Configuration for a specific agent tool.", "type": "object", "oneOf": [ { "$ref": "#/$defs/BetaManagedAgentsBashToolConfig" }, { "$ref": "#/$defs/BetaManagedAgentsEditToolConfig" }, { "$ref": "#/$defs/BetaManagedAgentsReadToolConfig" }, { "$ref": "#/$defs/BetaManagedAgentsWriteToolConfig" }, { "$ref": "#/$defs/BetaManagedAgentsGlobToolConfig" }, { "$ref": "#/$defs/BetaManagedAgentsGrepToolConfig" }, { "$ref": "#/$defs/BetaManagedAgentsWebFetchToolConfig" }, { "$ref": "#/$defs/BetaManagedAgentsWebSearchToolConfig" } ] }, "BetaManagedAgentsAgentToolset20260401": { "type": "object", "additionalProperties": false, "required": [ "type", "default_config", "configs" ], "properties": { "type": { "type": "string", "enum": [ "agent_toolset_20260401" ] }, "default_config": { "$ref": "#/$defs/BetaManagedAgentsAgentToolsetDefaultConfig" }, "configs": { "type": "array", "items": { "$ref": "#/$defs/BetaManagedAgentsAgentToolConfigUnion" } } } }, "BetaManagedAgentsAgentToolsetDefaultConfig": { "description": "Resolved default configuration for agent tools.", "type": "object", "additionalProperties": false, "required": [ "enabled", "permission_policy" ], "properties": { "enabled": { "type": "boolean" }, "permission_policy": { "$ref": "#/$defs/BetaManagedAgentsPermissionPolicy" } } }, "BetaManagedAgentsAlwaysAllowPolicy": { "description": "Tool calls are automatically approved without user confirmation.", "type": "object", "additionalProperties": false, "required": [ "type" ], "properties": { "type": { "type": "string", "enum": [ "always_allow" ] } } }, "BetaManagedAgentsAlwaysAskPolicy": { "description": "Tool calls require user confirmation before execution.", "type": "object", "additionalProperties": false, "required": [ "type" ], "properties": { "type": { "type": "string", "enum": [ "always_ask" ] } } }, "BetaManagedAgentsAnthropicSkill": { "description": "A resolved Anthropic-managed skill.", "type": "object", "additionalProperties": false, "required": [ "type", "skill_id", "version" ], "properties": { "type": { "type": "string", "enum": [ "anthropic" ] }, "skill_id": { "type": "string" }, "version": { "type": "string" } } }, "BetaManagedAgentsBashToolConfig": { "description": "Configuration for the bash tool.", "type": "object", "additionalProperties": false, "required": [ "type", "name", "enabled", "permission_policy" ], "properties": { "type": { "type": "string", "const": "bash" }, "name": { "type": "string", "const": "bash" }, "enabled": { "type": "boolean" }, "permission_policy": { "$ref": "#/$defs/BetaManagedAgentsPermissionPolicy" } } }, "BetaManagedAgentsCustomSkill": { "description": "A resolved user-created custom skill.", "type": "object", "additionalProperties": false, "required": [ "type", "skill_id", "version" ], "properties": { "type": { "type": "string", "enum": [ "custom" ] }, "skill_id": { "type": "string" }, "version": { "type": "string" } } }, "BetaManagedAgentsCustomTool": { "description": "A custom tool as returned in API responses.", "type": "object", "additionalProperties": false, "required": [ "type", "name", "description", "input_schema" ], "properties": { "type": { "type": "string", "enum": [ "custom" ] }, "name": { "type": "string" }, "description": { "type": "string" }, "input_schema": { "$ref": "#/$defs/BetaManagedAgentsCustomToolInputSchema" } } }, "BetaManagedAgentsCustomToolInputSchema": { "additionalProperties": true, "description": "JSON Schema for custom tool input parameters.", "properties": { "properties": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Properties", "x-stainless-skip": [ "terraform" ] }, "required": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Required" }, "type": { "const": "object", "title": "Type", "type": "string" } }, "required": [ "type" ], "type": "object" }, "BetaManagedAgentsEditToolConfig": { "description": "Configuration for the edit tool.", "type": "object", "additionalProperties": false, "required": [ "type", "name", "enabled", "permission_policy" ], "properties": { "type": { "type": "string", "const": "edit" }, "name": { "type": "string", "const": "edit" }, "enabled": { "type": "boolean" }, "permission_policy": { "$ref": "#/$defs/BetaManagedAgentsPermissionPolicy" } } }, "BetaManagedAgentsEffort": { "description": "How hard Claude works on each turn. Sets `output_config.effort` on every Messages call the session makes.", "type": "object", "oneOf": [ { "$ref": "#/$defs/BetaManagedAgentsEffortLow" }, { "$ref": "#/$defs/BetaManagedAgentsEffortMedium" }, { "$ref": "#/$defs/BetaManagedAgentsEffortHigh" }, { "$ref": "#/$defs/BetaManagedAgentsEffortXhigh" }, { "$ref": "#/$defs/BetaManagedAgentsEffortMax" } ] }, "BetaManagedAgentsEffortHigh": { "description": "High effort. Favors reasoning depth.", "type": "object", "additionalProperties": false, "required": [ "type" ], "properties": { "type": { "type": "string", "enum": [ "high" ] } } }, "BetaManagedAgentsEffortLow": { "description": "Low effort. Favors latency over reasoning depth.", "type": "object", "additionalProperties": false, "required": [ "type" ], "properties": { "type": { "type": "string", "enum": [ "low" ] } } }, "BetaManagedAgentsEffortMax": { "description": "Maximum effort. Favors reasoning depth over latency.", "type": "object", "additionalProperties": false, "required": [ "type" ], "properties": { "type": { "type": "string", "enum": [ "max" ] } } }, "BetaManagedAgentsEffortMedium": { "description": "Medium effort. Balances latency and reasoning depth.", "type": "object", "additionalProperties": false, "required": [ "type" ], "properties": { "type": { "type": "string", "enum": [ "medium" ] } } }, "BetaManagedAgentsEffortXhigh": { "description": "Extra-high effort. Not all models accept this level.", "type": "object", "additionalProperties": false, "required": [ "type" ], "properties": { "type": { "type": "string", "enum": [ "xhigh" ] } } }, "BetaManagedAgentsGlobToolConfig": { "description": "Configuration for the glob tool.", "type": "object", "additionalProperties": false, "required": [ "type", "name", "enabled", "permission_policy" ], "properties": { "type": { "type": "string", "const": "glob" }, "name": { "type": "string", "const": "glob" }, "enabled": { "type": "boolean" }, "permission_policy": { "$ref": "#/$defs/BetaManagedAgentsPermissionPolicy" } } }, "BetaManagedAgentsGrepToolConfig": { "description": "Configuration for the grep tool.", "type": "object", "additionalProperties": false, "required": [ "type", "name", "enabled", "permission_policy" ], "properties": { "type": { "type": "string", "const": "grep" }, "name": { "type": "string", "const": "grep" }, "enabled": { "type": "boolean" }, "permission_policy": { "$ref": "#/$defs/BetaManagedAgentsPermissionPolicy" } } }, "BetaManagedAgentsMCPServer": { "description": "Union type for MCP server connection definitions returned in API responses.", "type": "object", "oneOf": [ { "$ref": "#/$defs/BetaManagedAgentsMCPServerURLDefinition" } ] }, "BetaManagedAgentsMCPServerURLDefinition": { "description": "URL-based MCP server connection as returned in API responses.", "type": "object", "additionalProperties": false, "required": [ "type", "name", "url" ], "properties": { "type": { "type": "string", "enum": [ "url" ] }, "name": { "type": "string" }, "url": { "type": "string" } } }, "BetaManagedAgentsMCPToolConfig": { "description": "Resolved configuration for a specific MCP tool.", "type": "object", "additionalProperties": false, "required": [ "name", "enabled", "permission_policy" ], "properties": { "name": { "type": "string" }, "enabled": { "type": "boolean" }, "permission_policy": { "$ref": "#/$defs/BetaManagedAgentsPermissionPolicy" } } }, "BetaManagedAgentsMCPToolset": { "type": "object", "additionalProperties": false, "required": [ "type", "mcp_server_name", "default_config", "configs" ], "properties": { "type": { "type": "string", "enum": [ "mcp_toolset" ] }, "mcp_server_name": { "type": "string" }, "default_config": { "$ref": "#/$defs/BetaManagedAgentsMCPToolsetDefaultConfig" }, "configs": { "type": "array", "items": { "$ref": "#/$defs/BetaManagedAgentsMCPToolConfig" } } } }, "BetaManagedAgentsMCPToolsetDefaultConfig": { "description": "Resolved default configuration for all tools from an MCP server.", "type": "object", "additionalProperties": false, "required": [ "enabled", "permission_policy" ], "properties": { "enabled": { "type": "boolean" }, "permission_policy": { "$ref": "#/$defs/BetaManagedAgentsPermissionPolicy" } } }, "BetaManagedAgentsModel": { "title": "BetaManagedAgentsModel", "description": "The model that will power your agent.\n\nSee [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.", "anyOf": [ { "type": "string" }, { "const": "claude-sonnet-5", "description": "High-performance model for coding and agents", "x-stainless-nominal": false }, { "const": "claude-fable-5", "description": "Next generation of intelligence for the hardest knowledge work and coding problems", "x-stainless-nominal": false }, { "const": "claude-opus-5", "description": "Powerful intelligence for long-running agents and coding", "x-stainless-nominal": false }, { "const": "claude-opus-4-8", "description": "Powerful intelligence for long-running agents and coding", "x-stainless-nominal": false }, { "const": "claude-opus-4-7", "description": "Powerful intelligence for long-running agents and coding", "x-stainless-nominal": false }, { "const": "claude-opus-4-6", "description": "Powerful intelligence for long-running agents and coding", "x-stainless-nominal": false }, { "const": "claude-sonnet-4-6", "description": "Best combination of speed and intelligence", "x-stainless-nominal": false }, { "const": "claude-haiku-4-5", "description": "Fastest model with near-frontier intelligence", "x-stainless-nominal": false }, { "const": "claude-haiku-4-5-20251001", "description": "Fastest model with near-frontier intelligence", "x-stainless-nominal": false }, { "const": "claude-opus-4-5", "description": "Powerful intelligence for long-running agents and coding", "x-stainless-nominal": false }, { "const": "claude-opus-4-5-20251101", "description": "Powerful intelligence for long-running agents and coding", "x-stainless-nominal": false }, { "const": "claude-sonnet-4-5", "description": "High-performance model for agents and coding", "x-stainless-nominal": false }, { "const": "claude-sonnet-4-5-20250929", "description": "High-performance model for agents and coding", "x-stainless-nominal": false } ] }, "BetaManagedAgentsModelConfig": { "description": "Model identifier and configuration.", "type": "object", "additionalProperties": false, "required": [ "id" ], "properties": { "id": { "$ref": "#/$defs/BetaManagedAgentsModel" }, "speed": { "description": "Inference speed mode. `fast` provides significantly faster output token generation at premium pricing. Defaults to `standard`. Not all models support `fast`; invalid combinations are rejected at create time.", "allOf": [ { "$ref": "#/$defs/BetaManagedAgentsSpeed" } ], "x-anthropic-beta-required": [ "managed-agents-2026-04-01", "fast-mode-2026-02-01" ] }, "effort": { "description": "How hard Claude works on each inference call. One of `low`, `medium`, `high`, `xhigh`, `max`. Always present; resolved to the per-model default at save time when not supplied.", "allOf": [ { "$ref": "#/$defs/BetaManagedAgentsEffort" } ], "x-anthropic-beta-required": [ "managed-agents-2026-04-01" ] }, "inference_geo": { "description": "Geographic region for model inference. When unset, requests fall through to the workspace's default_inference_geo.", "type": "string", "x-anthropic-beta-required": [ "managed-agents-2026-04-01" ] } } }, "BetaManagedAgentsMultiagent": { "description": "Resolved multiagent orchestration configuration as returned in API responses.", "oneOf": [ { "$ref": "#/$defs/BetaManagedAgentsMultiagentCoordinator" } ] }, "BetaManagedAgentsMultiagentCoordinator": { "description": "Resolved coordinator topology with a concrete agent roster.", "type": "object", "additionalProperties": false, "required": [ "type", "agents" ], "properties": { "type": { "type": "string", "enum": [ "coordinator" ] }, "agents": { "description": "Agents the coordinator may spawn as session threads, each resolved to a specific version.", "type": "array", "items": { "$ref": "#/$defs/BetaManagedAgentsMultiagentRosterEntry" } } } }, "BetaManagedAgentsMultiagentRosterEntry": { "description": "A resolved multiagent roster entry.", "oneOf": [ { "$ref": "#/$defs/BetaManagedAgentsAgentReference" }, { "$ref": "#/$defs/BetaManagedAgentsAdvisor" } ] }, "BetaManagedAgentsPermissionPolicy": { "description": "Permission policy for tool execution.", "type": "object", "oneOf": [ { "$ref": "#/$defs/BetaManagedAgentsAlwaysAllowPolicy" }, { "$ref": "#/$defs/BetaManagedAgentsAlwaysAskPolicy" } ] }, "BetaManagedAgentsReadToolConfig": { "description": "Configuration for the read tool.", "type": "object", "additionalProperties": false, "required": [ "type", "name", "enabled", "permission_policy" ], "properties": { "type": { "type": "string", "const": "read" }, "name": { "type": "string", "const": "read" }, "enabled": { "type": "boolean" }, "permission_policy": { "$ref": "#/$defs/BetaManagedAgentsPermissionPolicy" } } }, "BetaManagedAgentsSkill": { "description": "Resolved skill as returned in API responses.", "oneOf": [ { "$ref": "#/$defs/BetaManagedAgentsAnthropicSkill" }, { "$ref": "#/$defs/BetaManagedAgentsCustomSkill" } ] }, "BetaManagedAgentsSpeed": { "type": "string", "description": "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.", "enum": [ "standard", "fast" ] }, "BetaManagedAgentsUserLocation": { "description": "Approximate user location for search result localization.", "type": "object", "additionalProperties": false, "required": [ "type" ], "properties": { "type": { "description": "Location precision. Only \"approximate\" is supported.", "type": "string", "const": "approximate" }, "city": { "description": "City name.", "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 255 }, { "type": "null" } ] }, "region": { "description": "Region or state name.", "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 255 }, { "type": "null" } ] }, "country": { "description": "Two-letter ISO 3166-1 country code, uppercase.", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "timezone": { "description": "IANA timezone identifier, e.g. \"America/Los_Angeles\".", "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 255 }, { "type": "null" } ] } } }, "BetaManagedAgentsWebFetchToolConfig": { "description": "Configuration for the web_fetch tool.", "type": "object", "additionalProperties": false, "required": [ "type", "name", "enabled", "permission_policy" ], "properties": { "type": { "type": "string", "const": "web_fetch" }, "name": { "type": "string", "const": "web_fetch" }, "enabled": { "type": "boolean" }, "permission_policy": { "$ref": "#/$defs/BetaManagedAgentsPermissionPolicy" }, "allowed_domains": { "type": "array", "items": { "type": "string" } }, "blocked_domains": { "type": "array", "items": { "type": "string" } }, "max_content_tokens": { "anyOf": [ { "type": "integer", "format": "int32" }, { "type": "null" } ] } } }, "BetaManagedAgentsWebSearchToolConfig": { "description": "Configuration for the web_search tool.", "type": "object", "additionalProperties": false, "required": [ "type", "name", "enabled", "permission_policy" ], "properties": { "type": { "type": "string", "const": "web_search" }, "name": { "type": "string", "const": "web_search" }, "enabled": { "type": "boolean" }, "permission_policy": { "$ref": "#/$defs/BetaManagedAgentsPermissionPolicy" }, "allowed_domains": { "type": "array", "items": { "type": "string" } }, "blocked_domains": { "type": "array", "items": { "type": "string" } }, "user_location": { "anyOf": [ { "$ref": "#/$defs/BetaManagedAgentsUserLocation" }, { "type": "null" } ] } } }, "BetaManagedAgentsWriteToolConfig": { "description": "Configuration for the write tool.", "type": "object", "additionalProperties": false, "required": [ "type", "name", "enabled", "permission_policy" ], "properties": { "type": { "type": "string", "const": "write" }, "name": { "type": "string", "const": "write" }, "enabled": { "type": "boolean" }, "permission_policy": { "$ref": "#/$defs/BetaManagedAgentsPermissionPolicy" } } }, "BetaTimestamp": { "description": "A timestamp in RFC 3339 format", "type": "string", "format": "date-time" } } }