--- title: "Get Agent" method: GET path: "/v1/agents/{agent_id}?beta=true" --- # Get Agent `GET /v1/agents/{agent_id}?beta=true` ## Path parameters - `agent_id` string, required ## Query parameters - `version` integer ## Headers - `x-api-key` string - `anthropic-version` string - `anthropic-beta` string ## Response `200` Successful response (OK) - BetaManagedAgentsAgent — A Managed Agents `agent`. - `type` 'agent', required - `id` string, required - `version` integer, required — The agent's current version. Starts at 1 and increments when the agent is modified. - `name` string, required - `description` string, nullable, required - `model` BetaManagedAgentsModelConfig, required — Model identifier and configuration. - `id` union, required — The model that will power your agent.\n\nSee [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options. - string - 'claude-opus-4-7' — Frontier intelligence for long-running agents and coding - 'claude-opus-4-6' — Most intelligent model for building 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' — Premium model combining maximum intelligence with practical performance - 'claude-opus-4-5-20251101' — Premium model combining maximum intelligence with practical performance - 'claude-sonnet-4-5' — High-performance model for agents and coding - 'claude-sonnet-4-5-20250929' — High-performance model for agents and coding - `speed` 'standard' | 'fast' — Inference speed mode. `fast` provides significantly faster output token generation at premium pricing. Not all models support `fast`; invalid combinations are rejected at create time. - `system` string, nullable, required - `tools` BetaManagedAgentsAgentTool[], required - union — Union type for tool configurations returned in API responses. - object - `type` 'agent_toolset_20260401', required - `default_config` BetaManagedAgentsAgentToolsetDefaultConfig, required — Resolved default configuration for agent tools. - `enabled` boolean, required - `permission_policy` union, required — Permission policy for tool execution. - object — Tool calls are automatically approved without user confirmation. - … - object — Tool calls require user confirmation before execution. - … - `configs` BetaManagedAgentsAgentToolConfig[], required - `name` 'bash' | 'edit' | 'read' | 'write' | 'glob' | 'grep' | 'web_fetch' | 'web_search', required — Built-in agent tool identifier. - `enabled` boolean, required - `permission_policy` union, required — Permission policy for tool execution. - object — Tool calls are automatically approved without user confirmation. - … - object — Tool calls require user confirmation before execution. - … - object - `type` 'mcp_toolset', required - `mcp_server_name` string, required - `default_config` BetaManagedAgentsMCPToolsetDefaultConfig, required — Resolved default configuration for all tools from an MCP server. - `enabled` boolean, required - `permission_policy` union, required — Permission policy for tool execution. - object — Tool calls are automatically approved without user confirmation. - … - object — Tool calls require user confirmation before execution. - … - `configs` BetaManagedAgentsMCPToolConfig[], required - `name` string, required - `enabled` boolean, required - `permission_policy` union, required — Permission policy for tool execution. - object — Tool calls are automatically approved without user confirmation. - … - object — Tool calls require user confirmation before execution. - … - object — A custom tool as returned in API responses. - `type` 'custom', required - `name` string, required - `description` string, required - `input_schema` BetaManagedAgentsCustomToolInputSchema, required — JSON Schema for custom tool input parameters. - `type` 'object' — Must be 'object' for tool input schemas. - `properties` BetaManagedAgentsStruct - `required` string[] — List of required property names. - `mcp_servers` BetaManagedAgentsMCPServer[], required - `type` 'url', required - `name` string, required - `url` string, required - `skills` BetaManagedAgentsSkill[], required - union — Resolved skill as returned in API responses. - BetaManagedAgentsAnthropicSkill — A resolved Anthropic-managed skill. - `type` 'anthropic', required - `skill_id` string, required - `version` string, required - BetaManagedAgentsCustomSkill — A resolved user-created custom skill. - `type` 'custom', required - `skill_id` string, required - `version` string, required - `metadata` object, required - `created_at` string, date-time, required — A timestamp in RFC 3339 format - `updated_at` string, date-time, required — A timestamp in RFC 3339 format - `archived_at` string, date-time, required — A timestamp in RFC 3339 format - `multiagent` BetaManagedAgentsMultiagent, required — Resolved coordinator topology with a concrete agent roster. - `type` 'coordinator', required - `agents` BetaManagedAgentsAgentReference[], required — Agents the coordinator may spawn as session threads, each resolved to a specific version. - `type` 'agent', required - `id` string, required - `version` integer, required ## Other responses - `400` — Invalid argument - The client specified an invalid argument - `401` — Unauthenticated - The request does not have valid authentication credentials - `403` — Permission denied - The caller does not have permission to execute the specified operation - `404` — Not found - Some requested entity was not found - `408` — Deadline exceeded - The deadline expired before the operation could complete - `409` — Aborted - The operation was aborted due to concurrency issue - `412` — Failed precondition - Operation was rejected because the system is not in required state - `413` — Out of range - Operation was attempted past the valid range - `429` — Resource exhausted - Some resource has been exhausted (rate limiting) - `431` — Request header fields too large - Request metadata was too large - `499` — Cancelled - The operation was cancelled by the client - `500` — Internal - Internal server error - `501` — Unimplemented - The operation is not implemented or supported - `503` — Unavailable - The service is currently unavailable - `504` — Deadline exceeded - Upstream service did not respond in time ## Changes - **2026-05-06** `a4186730f56c` — 1 info - added the required property `multiagent` to the response with the `200` status - **2026-04-16** `e0696f59ae07` — 1 info - added `subschema #2` to the `model/id` response property `anyOf` list for the response status `200` - **2026-04-08** `69486316563e` — 1 info - endpoint added [Change history](https://skmtc.dev/anthropics/apis/anthropic-api/changes/v1/agents/:agent_id?beta=true/get.md) --- [API](https://skmtc.dev/anthropics/apis/anthropic-api.md) · [All operations](https://skmtc.dev/anthropics/apis/anthropic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/anthropics/apis/anthropic-api/revisions/478045ff0f4f?raw)