openapi: 3.2.0
info:
  title: Anthropic Agents?beta=true API
servers:
- url: https://api.anthropic.com
tags:
- name: Agents?beta=true
paths:
  /v1/agents?beta=true:
    post:
      operationId: BetaCreateAgent
      summary: Create Agent
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BetaManagedAgentsCreateAgentParams'
      responses:
        '200':
          description: Successful response (OK)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaManagedAgentsAgent'
        '400':
          description: Invalid argument - The client specified an invalid argument
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaErrorResponse'
        '401':
          description: Unauthenticated - The request does not have valid authentication credentials
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaErrorResponse'
        '403':
          description: Permission denied - The caller does not have permission to execute the specified operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaErrorResponse'
        '404':
          description: Not found - Some requested entity was not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaErrorResponse'
        '408':
          description: Deadline exceeded - The deadline expired before the operation could complete
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaErrorResponse'
        '409':
          description: Aborted - The operation was aborted due to concurrency issue
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaErrorResponse'
        '412':
          description: Failed precondition - Operation was rejected because the system is not in required state
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaErrorResponse'
        '413':
          description: Out of range - Operation was attempted past the valid range
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaErrorResponse'
        '429':
          description: Resource exhausted - Some resource has been exhausted (rate limiting)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaErrorResponse'
        '431':
          description: Request header fields too large - Request metadata was too large
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaErrorResponse'
        '499':
          description: Cancelled - The operation was cancelled by the client
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaErrorResponse'
        '500':
          description: Internal - Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaErrorResponse'
        '501':
          description: Unimplemented - The operation is not implemented or supported
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaErrorResponse'
        '503':
          description: Unavailable - The service is currently unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaErrorResponse'
        '504':
          description: Deadline exceeded - Upstream service did not respond in time
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaErrorResponse'
      x-anthropic-beta-required:
      - managed-agents-2026-04-01
      parameters:
      - name: anthropic-version
        in: header
        required: false
        schema:
          type: string
      - name: anthropic-beta
        in: header
        required: false
        schema:
          type: string
          items:
            type: string
          x-stainless-override-schema:
            x-stainless-param: betas
            x-stainless-extend-default: true
            type: array
            description: Optional header to specify the beta version(s) you want to use.
            items:
              $ref: '#/components/schemas/AnthropicBeta'
      tags:
      - Agents?beta=true
    get:
      operationId: BetaListAgents
      summary: List Agents
      parameters:
      - name: x-api-key
        in: header
        required: false
        schema:
          type: string
      - name: anthropic-version
        in: header
        required: false
        schema:
          type: string
      - name: anthropic-beta
        in: header
        required: false
        schema:
          type: string
          items:
            type: string
          x-stainless-override-schema:
            x-stainless-param: betas
            x-stainless-extend-default: true
            type: array
            description: Optional header to specify the beta version(s) you want to use.
            items:
              $ref: '#/components/schemas/AnthropicBeta'
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          format: int32
        description: Maximum results per page. Default 20, maximum 100.
      - name: page
        in: query
        required: false
        schema:
          type: string
          x-stainless-pagination-property:
            purpose: next_cursor_param
        description: Opaque pagination cursor from a previous response.
      - name: created_at[gte]
        in: query
        required: false
        schema:
          $ref: '#/components/schemas/BetaTimestamp'
        description: Return agents created at or after this time (inclusive).
      - name: created_at[lte]
        in: query
        required: false
        schema:
          $ref: '#/components/schemas/BetaTimestamp'
        description: Return agents created at or before this time (inclusive).
      - name: include_archived
        in: query
        required: false
        schema:
          type: boolean
        description: Include archived agents in results. Defaults to false.
      responses:
        '200':
          description: Successful response (OK)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaManagedAgentsListAgents'
        '400':
          description: Invalid argument - The client specified an invalid argument
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaErrorResponse'
        '401':
          description: Unauthenticated - The request does not have valid authentication credentials
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaErrorResponse'
        '403':
          description: Permission denied - The caller does not have permission to execute the specified operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaErrorResponse'
        '404':
          description: Not found - Some requested entity was not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaErrorResponse'
        '408':
          description: Deadline exceeded - The deadline expired before the operation could complete
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaErrorResponse'
        '409':
          description: Aborted - The operation was aborted due to concurrency issue
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaErrorResponse'
        '412':
          description: Failed precondition - Operation was rejected because the system is not in required state
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaErrorResponse'
        '413':
          description: Out of range - Operation was attempted past the valid range
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaErrorResponse'
        '429':
          description: Resource exhausted - Some resource has been exhausted (rate limiting)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaErrorResponse'
        '431':
          description: Request header fields too large - Request metadata was too large
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaErrorResponse'
        '499':
          description: Cancelled - The operation was cancelled by the client
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaErrorResponse'
        '500':
          description: Internal - Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaErrorResponse'
        '501':
          description: Unimplemented - The operation is not implemented or supported
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaErrorResponse'
        '503':
          description: Unavailable - The service is currently unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaErrorResponse'
        '504':
          description: Deadline exceeded - Upstream service did not respond in time
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaErrorResponse'
      x-anthropic-beta-required:
      - managed-agents-2026-04-01
      tags:
      - Agents?beta=true
components:
  schemas:
    BetaManagedAgentsMCPToolsetParams:
      description: Configuration for tools from an MCP server defined in `mcp_servers`.
      type: object
      additionalProperties: false
      required:
      - type
      - mcp_server_name
      properties:
        type:
          type: string
          enum:
          - mcp_toolset
        mcp_server_name:
          description: Name of the MCP server. Must match a server name from the mcp_servers array. 1-255 characters.
          type: string
          minLength: 1
          maxLength: 255
        default_config:
          description: Default configuration for all tools from this server.
          anyOf:
          - $ref: '#/components/schemas/BetaManagedAgentsMCPToolsetDefaultConfigParams'
          - type: 'null'
        configs:
          description: Per-tool configuration overrides.
          type: array
          items:
            $ref: '#/components/schemas/BetaManagedAgentsMCPToolConfigParams'
    BetaManagedAgentsMultiagentRosterEntryParams:
      description: 'An entry in a multiagent roster: an agent ID string, a versioned agent reference, or `self`.'
      oneOf:
      - type: string
      - oneOf:
        - $ref: '#/components/schemas/BetaManagedAgentsAgentParams'
        - $ref: '#/components/schemas/BetaManagedAgentsMultiagentSelfParams'
        - $ref: '#/components/schemas/BetaManagedAgentsAdvisorParams'
        discriminator:
          propertyName: type
          mapping:
            agent: '#/components/schemas/BetaManagedAgentsAgentParams'
            self: '#/components/schemas/BetaManagedAgentsMultiagentSelfParams'
            advisor: '#/components/schemas/BetaManagedAgentsAdvisorParams'
    BetaManagedAgentsAdvisorParams:
      description: 'Platform advisor roster entry: a model the session''s primary thread may consult mid-turn. At most one per roster; the entry occupies the roster name `anthropic.advisor`.'
      type: object
      additionalProperties: false
      required:
      - type
      - model
      properties:
        type:
          type: string
          enum:
          - advisor
          examples:
          - advisor
        model:
          description: A Claude model id. The model must be permitted as an advisor for this agent's model — see the sessions/threads/advisor spec.
          type: string
          minLength: 1
          maxLength: 256
          examples:
          - claude-fable-5
      example:
        type: advisor
        model: claude-fable-5
    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: '#/components/schemas/BetaManagedAgentsPermissionPolicy'
    BetaManagedAgentsAgentReference:
      description: A resolved agent reference with a concrete version.
      type: object
      additionalProperties: false
      required:
      - type
      - id
      - version
      properties:
        type:
          type: string
          enum:
          - agent
          examples:
          - agent
        id:
          type: string
          examples:
          - agent_011CZkYqphY8vELVzwCUpqiQ
        version:
          type: integer
          format: int32
          examples:
          - 1
      example:
        type: agent
        id: agent_011CZkYqphY8vELVzwCUpqiQ
        version: 1
    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: '#/components/schemas/BetaManagedAgentsPermissionPolicy'
    BetaManagedAgentsEffortHigh:
      description: High effort. Favors reasoning depth.
      type: object
      additionalProperties: false
      required:
      - type
      properties:
        type:
          type: string
          enum:
          - high
    BetaManagedAgentsCustomToolParams:
      description: A custom tool that is executed by the API client rather than the agent. When the agent calls this tool, an `agent.custom_tool_use` event is emitted and the session goes idle, waiting for the client to provide the result via a `user.custom_tool_result` event.
      type: object
      additionalProperties: false
      required:
      - type
      - name
      - description
      - input_schema
      properties:
        type:
          type: string
          enum:
          - custom
        name:
          description: Unique name for the tool. 1-128 characters; letters, digits, underscores, and hyphens.
          type: string
          minLength: 1
          maxLength: 128
        description:
          description: Description of what the tool does, shown to the agent to help it decide when to use the tool.
          type: string
          minLength: 1
        input_schema:
          description: JSON Schema defining the expected input parameters for the tool.
          allOf:
          - $ref: '#/components/schemas/BetaManagedAgentsCustomToolInputSchema'
    BetaManagedAgentsMultiagentCoordinatorParams:
      description: 'A coordinator topology: the session''s primary thread orchestrates work by spawning session threads, each running an agent drawn from the `agents` roster.'
      type: object
      additionalProperties: false
      required:
      - type
      - agents
      properties:
        type:
          type: string
          enum:
          - coordinator
          examples:
          - coordinator
        agents:
          description: 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).
          type: array
          items:
            $ref: '#/components/schemas/BetaManagedAgentsMultiagentRosterEntryParams'
          examples:
          - - agent_011CZkYqphY8vELVzwCUpqiQ
            - type: self
      example:
        type: coordinator
        agents:
        - agent_011CZkYqphY8vELVzwCUpqiQ
        - type: self
    BetaManagedAgentsAgentToolset20260401Params:
      description: Configuration for built-in agent tools. Use this to enable or disable groups of tools available to the agent.
      type: object
      additionalProperties: false
      required:
      - type
      properties:
        type:
          type: string
          enum:
          - agent_toolset_20260401
        default_config:
          description: Default configuration applied to all tools in this set.
          anyOf:
          - $ref: '#/components/schemas/BetaManagedAgentsAgentToolsetDefaultConfigParams'
          - type: 'null'
        configs:
          description: Per-tool configuration overrides.
          type: array
          items:
            $ref: '#/components/schemas/BetaManagedAgentsAgentToolConfigUnionParams'
    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: '#/components/schemas/BetaManagedAgentsPermissionPolicy'
    BetaManagedAgentsModelConfig:
      description: Model identifier and configuration.
      type: object
      additionalProperties: false
      required:
      - id
      properties:
        id:
          $ref: '#/components/schemas/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: '#/components/schemas/BetaManagedAgentsSpeed'
          x-anthropic-beta-required:
          - managed-agents-2026-04-01
          - fast-mode-2026-02-01
          examples:
          - standard
        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: '#/components/schemas/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
      example:
        id: claude-opus-5
        speed: standard
    BetaManagedAgentsMultiagentSelfParams:
      description: Sentinel roster entry meaning "the agent that owns this configuration". Resolved server-side to a concrete agent reference.
      type: object
      additionalProperties: false
      required:
      - type
      properties:
        type:
          type: string
          enum:
          - self
          examples:
          - self
      example:
        type: self
    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: '#/components/schemas/BetaManagedAgentsMultiagentRosterEntry'
    BetaManagedAgentsPermissionPolicy:
      description: Permission policy for tool execution.
      type: object
      discriminator:
        propertyName: type
        mapping:
          always_allow: '#/components/schemas/BetaManagedAgentsAlwaysAllowPolicy'
          always_ask: '#/components/schemas/BetaManagedAgentsAlwaysAskPolicy'
      oneOf:
      - $ref: '#/components/schemas/BetaManagedAgentsAlwaysAllowPolicy'
      - $ref: '#/components/schemas/BetaManagedAgentsAlwaysAskPolicy'
    BetaManagedAgentsCustomSkillParams:
      description: A user-created custom skill.
      type: object
      additionalProperties: false
      required:
      - type
      - skill_id
      properties:
        type:
          type: string
          enum:
          - custom
          examples:
          - custom
        skill_id:
          description: Tagged ID of the custom skill (e.g., "skill_01XJ5...").
          type: string
          minLength: 1
          maxLength: 64
          examples:
          - skill_011CZkZFNu9hAbo3jZPRgTlx
        version:
          description: Version to pin. Defaults to latest if omitted.
          anyOf:
          - type: string
            minLength: 1
            maxLength: 64
          - type: 'null'
          examples:
          - '2'
      example:
        type: custom
        skill_id: skill_011CZkZFNu9hAbo3jZPRgTlx
        version: '2'
    BetaManagedAgentsModelConfigParams:
      description: An object that defines additional configuration control over model use
      type: object
      additionalProperties: false
      required:
      - id
      properties:
        id:
          $ref: '#/components/schemas/BetaManagedAgentsModel'
        speed:
          description: Inference speed mode. Defaults to `standard`.
          anyOf:
          - $ref: '#/components/schemas/BetaManagedAgentsSpeed'
          - type: 'null'
        effort:
          description: '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.'
          anyOf:
          - $ref: '#/components/schemas/BetaManagedAgentsEffortParams'
          - type: 'null'
          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. On update, `model` is whole-object replacement — omitting inference_geo clears it.
          anyOf:
          - type: string
          - type: 'null'
          x-anthropic-beta-required:
          - managed-agents-2026-04-01
      example:
        id: claude-opus-5
    BetaManagedAgentsAgentToolConfigUnion:
      description: Configuration for a specific agent tool.
      type: object
      discriminator:
        propertyName: type
        mapping:
          bash: '#/components/schemas/BetaManagedAgentsBashToolConfig'
          edit: '#/components/schemas/BetaManagedAgentsEditToolConfig'
          read: '#/components/schemas/BetaManagedAgentsReadToolConfig'
          write: '#/components/schemas/BetaManagedAgentsWriteToolConfig'
          glob: '#/components/schemas/BetaManagedAgentsGlobToolConfig'
          grep: '#/components/schemas/BetaManagedAgentsGrepToolConfig'
          web_fetch: '#/components/schemas/BetaManagedAgentsWebFetchToolConfig'
          web_search: '#/components/schemas/BetaManagedAgentsWebSearchToolConfig'
      oneOf:
      - $ref: '#/components/schemas/BetaManagedAgentsBashToolConfig'
      - $ref: '#/components/schemas/BetaManagedAgentsEditToolConfig'
      - $ref: '#/components/schemas/BetaManagedAgentsReadToolConfig'
      - $ref: '#/components/schemas/BetaManagedAgentsWriteToolConfig'
      - $ref: '#/components/schemas/BetaManagedAgentsGlobToolConfig'
      - $ref: '#/components/schemas/BetaManagedAgentsGrepToolConfig'
      - $ref: '#/components/schemas/BetaManagedAgentsWebFetchToolConfig'
      - $ref: '#/components/schemas/BetaManagedAgentsWebSearchToolConfig'
    BetaManagedAgentsCustomSkill:
      description: A resolved user-created custom skill.
      type: object
      additionalProperties: false
      required:
      - type
      - skill_id
      - version
      properties:
        type:
          type: string
          enum:
          - custom
          examples:
          - custom
        skill_id:
          type: string
          examples:
          - skill_011CZkZFNu9hAbo3jZPRgTlx
        version:
          type: string
          examples:
          - '2'
      example:
        type: custom
        skill_id: skill_011CZkZFNu9hAbo3jZPRgTlx
        version: '2'
    BetaManagedAgentsMultiagentParams:
      description: Multiagent orchestration configuration. Currently supports the `coordinator` topology.
      discriminator:
        propertyName: type
        mapping:
          coordinator: '#/components/schemas/BetaManagedAgentsMultiagentCoordinatorParams'
      oneOf:
      - $ref: '#/components/schemas/BetaManagedAgentsMultiagentCoordinatorParams'
    BetaManagedAgentsMCPToolConfigParams:
      description: Configuration override for a specific MCP tool.
      type: object
      additionalProperties: false
      required:
      - name
      properties:
        name:
          description: Name of the MCP tool to configure. 1-128 characters.
          type: string
          minLength: 1
          maxLength: 128
        enabled:
          description: Whether this tool is enabled. Overrides the `default_config` setting.
          anyOf:
          - type: boolean
          - type: 'null'
        permission_policy:
          description: Permission policy for this tool. Overrides the `default_config` setting.
          anyOf:
          - $ref: '#/components/schemas/BetaManagedAgentsPermissionPolicy'
          - type: 'null'
    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: '#/components/schemas/BetaManagedAgentsPermissionPolicy'
    BetaManagedAgentsReadToolConfigParams:
      description: Configuration override for the read tool.
      type: object
      additionalProperties: false
      required:
      - name
      properties:
        type:
          type: string
          const: read
        name:
          description: Must be "read".
          type: string
          const: read
        enabled:
          description: Whether this tool is enabled and available to Claude. Overrides the default_config setting.
          anyOf:
          - type: boolean
          - type: 'null'
        permission_policy:
          description: Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
          anyOf:
          - $ref: '#/components/schemas/BetaManagedAgentsPermissionPolicy'
          - type: 'null'
    BetaGatewayTimeoutError:
      properties:
        message:
          default: Request timeout
          title: Message
          type: string
        type:
          const: timeout_error
          default: timeout_error
          title: Type
          type: string
      required:
      - message
      - type
      title: GatewayTimeoutError
      type: object
    BetaManagedAgentsMultiagentRosterEntry:
      description: A resolved multiagent roster entry.
      discriminator:
        propertyName: type
        mapping:
          agent: '#/components/schemas/BetaManagedAgentsAgentReference'
          advisor: '#/components/schemas/BetaManagedAgentsAdvisor'
      oneOf:
      - $ref: '#/components/schemas/BetaManagedAgentsAgentReference'
      - $ref: '#/components/schemas/BetaManagedAgentsAdvisor'
    BetaManagedAgentsAgentToolsetDefaultConfigParams:
      description: Default configuration for all tools in a toolset.
      type: object
      additionalProperties: false
      properties:
        enabled:
          description: Whether tools are enabled and available to Claude by default. Defaults to true if not specified.
          anyOf:
          - type: boolean
          - type: 'null'
        permission_policy:
          description: Default permission policy for tools. Controls whether tool calls are auto-approved or require confirmation.
          anyOf:
          - $ref: '#/components/schemas/BetaManagedAgentsPermissionPolicy'
          - type: 'null'
    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: '#/components/schemas/BetaManagedAgentsPermissionPolicy'
    BetaManagedAgentsModel:
      title: BetaManagedAgentsModel
      description: 'The model that will power your agent.


        See [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
    BetaManagedAgentsWebFetchToolConfigParams:
      description: Configuration override for the web_fetch tool.
      type: object
      additionalProperties: false
      required:
      - name
      properties:
        type:
          type: string
          const: web_fetch
        name:
          description: Must be "web_fetch".
          type: string
          const: web_fetch
        enabled:
          description: Whether this tool is enabled and available to Claude. Overrides the default_config setting.
          anyOf:
          - type: boolean
          - type: 'null'
        permission_policy:
          description: Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
          anyOf:
          - $ref: '#/components/schemas/BetaManagedAgentsPermissionPolicy'
          - type: 'null'
        allowed_domains:
          description: 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.
          type: array
          items:
            type: string
        blocked_domains:
          description: 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.
          type: array
          items:
            type: string
        max_content_tokens:
          description: Maximum number of tokens of fetched text content to include in context per call. Does not apply to binary content such as PDFs.
          anyOf:
          - type: integer
            format: int32
          - type: 'null'
    BetaManagedAgentsAnthropicSkill:
      description: A resolved Anthropic-managed skill.
      type: object
      additionalProperties: false
      required:
      - type
      - skill_id
      - version
      properties:
        type:
          type: string
          enum:
          - anthropic
          examples:
          - anthropic
        skill_id:
          type: string
          examples:
          - xlsx
        version:
          type: string
          examples:
          - '1'
      example:
        type: anthropic
        skill_id: xlsx
        version: '1'
    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
    BetaManagedAgentsAgentToolset20260401:
      type: object
      additionalProperties: false
      required:
      - type
      - default_config
      - configs
      properties:
        type:
          type: string
          enum:
          - agent_toolset_20260401
        default_config:
          $ref: '#/components/schemas/BetaManagedAgentsAgentToolsetDefaultConfig'
        configs:
          type: array
          items:
            $ref: '#/components/schemas/BetaManagedAgentsAgentToolConfigUnion'
    BetaManagedAgentsCreateAgentParams:
      description: Request parameters for creating an `agent`.
      type: object
      additionalProperties: false
      required:
      - name
      - model
      properties:
        name:
          description: Human-readable name for the agent.
          type: string
          minLength: 1
          maxLength: 256
          examples:
          - My First Agent
        model:
          description: Model identifier. Accepts the [model string](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison), e.g. `claude-opus-5`, or a `model_config` object for additional configuration control
          allOf:
          - $ref: '#/components/schemas/BetaManagedAgentsModelParams'
          examples:
          - claude-opus-5
        description:
          description: Description of what the agent does.
          anyOf:
          - type: string
            maxLength: 2048
          - type: 'null'
          examples:
          - A general-purpose starter agent.
        system:
          description: System prompt for the agent.
          anyOf:
          - type: string
            maxLength: 100000
          - type: 'null'
          examples:
          - You are a general-purpose agent that can research, write code, run commands, and use connected tools to complete the user's task end to end.
        tools:
          description: Tool configurations available to the agent. Maximum of 128 tools across all toolsets allowed.
          type: array
          items:
            $ref: '#/components/schemas/BetaManagedAgentsAgentToolParams'
          examples:
          - - type: agent_toolset_20260401
        mcp_servers:
          description: MCP servers this agent connects to. Maximum 20. Names must be unique within the array. Every server must be referenced by an `mcp_toolset` in `tools`; unreferenced servers are rejected. See the [MCP connector guide](https://platform.claude.com/docs/en/managed-agents/mcp-connector).
          type: array
          items:
            $ref: '#/components/schemas/BetaManagedAgentsMCPServerParams'
        skills:
          description: Skills available to the agent.
          type: array
          items:
            $ref: '#/components/schemas/BetaManagedAgentsSkillParams'
        metadata:
          description: Arbitrary key-value metadata. Maximum 16 pairs, keys up to 64 chars, values up to 512 chars.
          type: object
          additionalProperties:
            type: string
          examples:
          - foo: bar
        multiagent:
          description: Multiagent orchestration configuration. Currently supports the `coordinator` topology with a roster of 1-20 agents.
          anyOf:
          - $ref: '#/components/schemas/BetaManagedAgentsMultiagentParams'
          - type: 'null'
          x-anthropic-beta-required:
          - managed-agents-2026-04-01
      example:
        name: My First Agent
        model: claude-opus-5
        description: A general-purpose starter agent.
        system: You are a general-purpose agent that can research, write code, run commands, and use connected tools to complete the user's task end to end.
        tools:
        - type: agent_toolset_20260401
        metadata:
          foo: bar
    BetaManagedAgentsAnthropicSkillParams:
      description: An Anthropic-managed skill.
      type: object
      additionalProperties: false
      required:
      - type
      - skill_id
      properties:
        type:
          type: string
          enum:
          - anthropic
          examples:
          - anthropic
        skill_id:
          description: Identifier of the Anthropic skill (e.g., "xlsx").
          type: string
          minLength: 1
          maxLength: 64
          examples:
          - xlsx
        version:
          description: Version to pin. Defaults to latest if omitted.
          anyOf:
          - type: string
            minLength: 1
            maxLength: 64
          - type: 'null'
          examples:
          - '1'
      example:
        type: anthropic
        skill_id: xlsx
        version: '1'
    BetaManagedAgentsEffortXhigh:
      description: Extra-high effort. Not all models accept this level.
      type: object
      additionalProperties: false
      required:
      - type
      properties:
        type:
          type: string
          enum:
          - xhigh
    BetaManagedAgentsGrepToolConfigParams:
      description: Configuration override for the grep tool.
      type: object
      additionalProperties: false
      required:
      - name
      properties:
        type:
          type: string
          const: grep
        name:
          description: Must be "grep".
          type: string
          const: grep
        enabled:
          description: Whether this tool is enabled and available to Claude. Overrides the default_config setting.
          anyOf:
          - type: boolean
          - type: 'null'
        permission_policy:
          description: Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
          anyOf:
          - $ref: '#/components/schemas/BetaManagedAgentsPermissionPolicy'
          - type: 'null'
    BetaManagedAgentsAgentToolParams:
      description: Union type for tool configurations in the tools array.
      type: object
      discriminator:
        propertyName: type
        mapping:
          agent_toolset_20260401: '#/components/schemas/BetaManagedAgentsAgentToolset20260401Params'
          mcp_toolset: '#/components/schemas/BetaManagedAgentsMCPToolsetParams'
          custom: '#/components/schemas/BetaManagedAgentsCustomToolParams'
      oneOf:
      - $ref: '#/components/schemas/BetaManagedAgentsAgentToolset20260401Params'
      - $ref: '#/components/schemas/BetaManagedAgentsMCPToolsetParams'
      - $ref: '#/components/schemas/BetaManagedAgentsCustomToolParams'
    BetaManagedAgentsMCPServer:
      description: Union type for MCP server connection definitions returned in API responses.
      type: object
      discriminator:
        propertyName: type
        mapping:
          url: '#/components/schemas/BetaManagedAgentsMCPServerURLDefinition'
      oneOf:
      - $ref: '#/components/schemas/BetaManagedAgentsMCPServerURLDefinition'
    BetaManagedAgentsAgentToolConfigUnionParams:
      description: Configuration override for a specific tool within a toolset.
      type: object
      discriminator:
        propertyName: type
        mapping:
          bash: '#/components/schemas/BetaManagedAgentsBashToolConfigParams'
          edit: '#/components/schemas/BetaManagedAgentsEditToolConfigParams'
          read: '#/components/schemas/BetaManagedAgentsReadToolConfigParams'
          write: '#/components/schemas/BetaManagedAgentsWriteToolConfigParams'
          glob: '#/components/schemas/BetaManagedAgentsGlobToolConfigParams'
          grep: '#/components/schemas/BetaManagedAgentsGrepToolConfigParams'
          web_fetch: '#/components/schemas/BetaManagedAgentsWebFetchToolConfigParams'
          web_search: '#/components/schemas/BetaManagedAgentsWebSearchToolConfigParams'
      oneOf:
      - $ref: '#/components/schemas/BetaManagedAgentsBashToolConfigParams'
      - $ref: '#/components/schemas/BetaManagedAgentsEditToolConfigParams'
      - $ref: '#/components/schemas/BetaManagedAgentsReadToolConfigParams'
      - $ref: '#/components/schemas/BetaManagedAgentsWriteToolConfigParams'
      - $ref: '#/components/schemas/BetaManagedAgentsGlobToolConfigParams'
      - $ref: '#/components/schemas/BetaManagedAgentsGrepToolConfigParams'
      - $ref: '#/components/schemas/BetaManagedAgentsWebFetchToolConfigParams'
      - $ref: '#/components/schemas/BetaManagedAgentsWebSearchToolConfigParams'
    BetaManagedAgentsAgentParams:
      description: Specification for an Agent. Provide a specific `version` or use the short-form `agent="agent_id"` for the most recent version
      type: object
      additionalProperties: false
      required:
      - type
      - id
      properties:
        type:
          type: string
          enum:
          - agent
        id:
          description: The `agent` ID.
          type: string
          minLength: 1
          maxLength: 128
        version:
          description: The specific `agent` version to use. Omit to use the latest version. Must be at least 1 if specified.
          type: integer
          format: int32
    BetaManagedAgentsBashToolConfigParams:
      description: Configuration override for the bash tool.
      type: object
      additionalProperties: false
      required:
      - name
      properties:
        type:
          type: string
          const: bash
        name:
          description: Must be "bash".
          type: string
          const: bash
        enabled:
          description: Whether this tool is enabled and available to Claude. Overrides the default_config setting.
          anyOf:
          - type: boolean
          - type: 'null'
        permission_policy:
          description: Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
          anyOf:
          - $ref: '#/components/schemas/BetaManagedAgentsPermissionPolicy'
          - type: 'null'
    BetaManagedAgentsMCPServerParams:
      description: Union type for MCP server connection definitions.
      type: object
      discriminator:
        propertyName: type
        mapping:
          url: '#/components/schemas/BetaManagedAgentsURLMCPServerParams'
      oneOf:
      - $ref: '#/components/schemas/BetaManagedAgentsURLMCPServerParams'
    BetaAPIError:
      properties:
        message:
          default: Internal server error
          title: Message
          type: string
        type:
          const: api_error
          default: api_error
          title: Type
          type: string
      required:
      - message
      - type
      title: APIError
      type: object
    BetaManagedAgentsWebSearchToolConfigParams:
      description: Configuration override for the web_search tool.
      type: object
      additionalProperties: false
      required:
      - name
      properties:
        type:
          type: string
          const: web_search
        name:
          description: Must be "web_search".
          type: string
          const: web_search
        enabled:
          description: Whether this tool is enabled and available to Claude. Overrides the default_config setting.
          anyOf:
          - type: boolean
          - type: 'null'
        permission_policy:
          description: Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
          anyOf:
          - $ref: '#/components/schemas/BetaManagedAgentsPermissionPolicy'
          - type: 'null'
        allowed_domains:
          description: 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.
          type: array
          items:
            type: string
        blocked_domains:
          description: 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.
          type: array
          items:
            type: string
        user_location:
          description: Approximate user location for search result localization.
          anyOf:
          - $ref: '#/components/schemas/BetaManagedAgentsUserLocation'
          - type: 'null'
    BetaManagedAgentsEffortLevel:
      type: string
      description: How hard Claude works on each turn. Higher levels favor reasoning depth over latency. Not all models accept every level; invalid combinations are rejected at create time.
      enum:
      - low
      - medium
      - high
      - xhigh
      - max
    BetaManagedAgentsWriteToolConfigParams:
      description: Configuration override for the write tool.
      type: object
      additionalProperties: false
      required:
      - name
      properties:
        type:
          type: string
          const: write
        name:
          description: Must be "write".
          type: string
          const: write
        enabled:
          description: Whether this tool is enabled and available to Claude. Overrides the default_config setting.
          anyOf:
          - type: boolean
          - type: 'null'
        permission_policy:
          description: Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
          anyOf:
          - $ref: '#/components/schemas/BetaManagedAgentsPermissionPolicy'
          - type: 'null'
    BetaRateLimitError:
      properties:
        message:
          default: Rate limited
          title: Message
          type: string
        type:
          const: rate_limit_error
          default: rate_limit_error
          title: Type
          type: string
      required:
      - message
      - type
      title: RateLimitError
      type: object
    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
          examples:
          - url
        name:
          type: string
          examples:
          - example-mcp
        url:
          type: string
          examples:
          - https://example-server.modelcontextprotocol.io/sse
      example:
        type: url
        name: example-mcp
        url: https://example-server.modelcontextprotocol.io/sse
    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'
    BetaManagedAgentsModelParams:
      oneOf:
      - title: BetaManagedAgentsModel
        allOf:
        - $ref: '#/components/schemas/BetaManagedAgentsModel'
        x-stainless-skip:
        - go
        - cli
      - $ref: '#/components/schemas/BetaManagedAgentsModelConfigParams'
    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: '#/components/schemas/BetaManagedAgentsPermissionPolicy'
    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
    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: '#/components/schemas/BetaManagedAgentsMCPToolsetDefaultConfig'
        configs:
          type: array
          items:
            $ref: '#/components/schemas/BetaManagedAgentsMCPToolConfig'
    BetaInvalidRequestError:
      properties:
        message:
          default: Invalid request
          title: Message
          type: string
        type:
          const: invalid_request_error
          default: invalid_request_error
          title: Type
          type: string
      required:
      - message
      - type
      title: InvalidRequestError
      type: object
    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: '#/components/schemas/BetaManagedAgentsPermissionPolicy'
        allowed_domains:
          type: array
          items:
            type: string
        blocked_domains:
          type: array
          items:
            type: string
        user_location:
          anyOf:
          - $ref: '#/components/schemas/BetaManagedAgentsUserLocation'
          - type: 'null'
    BetaManagedAgentsAgentTool:
      description: Union type for tool configurations returned in API responses.
      type: object
      discriminator:
        propertyName: type
        mapping:
          agent_toolset_20260401: '#/components/schemas/BetaManagedAgentsAgentToolset20260401'
          mcp_toolset: '#/components/schemas/BetaManagedAgentsMCPToolset'
          custom: '#/components/schemas/BetaManagedAgentsCustomTool'
      oneOf:
      - $ref: '#/components/schemas/BetaManagedAgentsAgentToolset20260401'
      - $ref: '#/components/schemas/BetaManagedAgentsMCPToolset'
      - $ref: '#/components/schemas/BetaManagedAgentsCustomTool'
    BetaManagedAgentsEffortMedium:
      description: Medium effort. Balances latency and reasoning depth.
      type: object
      additionalProperties: false
      required:
      - type
      properties:
        type:
          type: string
          enum:
          - medium
    BetaManagedAgentsEffortLow:
      description: Low effort. Favors latency over reasoning depth.
      type: object
      additionalProperties: false
      required:
      - type
      properties:
        type:
          type: string
          enum:
          - low
    BetaManagedAgentsGlobToolConfigParams:
      description: Configuration override for the glob tool.
      type: object
      additionalProperties: false
      required:
      - name
      properties:
        type:
          type: string
          const: glob
        name:
          description: Must be "glob".
          type: string
          const: glob
        enabled:
          description: Whether this tool is enabled and available to Claude. Overrides the default_config setting.
          anyOf:
          - type: boolean
          - type: 'null'
        permission_policy:
          description: Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
          anyOf:
          - $ref: '#/components/schemas/BetaManagedAgentsPermissionPolicy'
          - type: 'null'
    BetaManagedAgentsEffortParams:
      oneOf:
      - $ref: '#/components/schemas/BetaManagedAgentsEffortLevel'
      - $ref: '#/components/schemas/BetaManagedAgentsEffort'
    BetaManagedAgentsURLMCPServerParams:
      description: URL-based MCP server connection.
      type: object
      additionalProperties: false
      required:
      - type
      - name
      - url
      properties:
        type:
          type: string
          enum:
          - url
          examples:
          - url
        name:
          description: Unique name for this server, referenced by mcp_toolset configurations. 1-255 characters.
          type: string
          minLength: 1
          maxLength: 255
          examples:
          - example-mcp
        url:
          description: Endpoint URL for the MCP server.
          type: string
          maxLength: 2048
          examples:
          - https://example-server.modelcontextprotocol.io/sse
      example:
        type: url
        name: example-mcp
        url: https://example-server.modelcontextprotocol.io/sse
    BetaManagedAgentsListAgents:
      description: Paginated list of agents.
      type: object
      additionalProperties: false
      required:
      - data
      properties:
        data:
          description: List of agents.
          x-stainless-pagination-property:
            purpose: items
          type: array
          items:
            $ref: '#/components/schemas/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'
    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
          examples:
          - agent
        id:
          type: string
          examples:
          - agent_011CZkYpogX7uDKUyvBTophP
        version:
          description: The agent's current version. Starts at 1 and increments when the agent is modified.
          type: integer
          format: int32
          examples:
          - 1
        name:
          type: string
          examples:
          - My First Agent
        description:
          anyOf:
          - type: string
          - type: 'null'
          examples:
          - A general-purpose starter agent.
        model:
          $ref: '#/components/schemas/BetaManagedAgentsModelConfig'
          examples:
          - id: claude-opus-5
            speed: standard
        system:
          anyOf:
          - type: string
          - type: 'null'
          examples:
          - You are a general-purpose agent that can research, write code, run commands, and use connected tools to complete the user's task end to end.
        tools:
          type: array
          items:
            $ref: '#/components/schemas/BetaManagedAgentsAgentTool'
          examples:
          - - type: agent_toolset_20260401
              default_config:
                enabled: true
                permission_policy:
                  type: always_ask
              configs: []
        mcp_servers:
          type: array
          items:
            $ref: '#/components/schemas/BetaManagedAgentsMCPServer'
          examples:
          - - type: url
              name: example-mcp
              url: https://example-server.modelcontextprotocol.io/sse
        skills:
          type: array
          items:
            $ref: '#/components/schemas/BetaManagedAgentsSkill'
          examples:
          - - type: anthropic
              skill_id: xlsx
              version: '1'
            - type: custom
              skill_id: skill_011CZkZFNu9hAbo3jZPRgTlx
              version: '2'
        metadata:
          type: object
          additionalProperties:
            type: string
          examples:
          - foo: bar
        created_at:
          $ref: '#/components/schemas/BetaTimestamp'
          examples:
          - '2026-03-15T10:00:00Z'
        updated_at:
          $ref: '#/components/schemas/BetaTimestamp'
          examples:
          - '2026-03-15T10:00:00Z'
        archived_at:
          description: When the agent was archived. Null if not archived.
          anyOf:
          - $ref: '#/components/schemas/BetaTimestamp'
          - type: 'null'
          examples:
          - null
        multiagent:
          description: Multiagent orchestration configuration. Null when the agent is single-threaded.
          anyOf:
          - $ref: '#/components/schemas/BetaManagedAgentsMultiagent'
          - type: 'null'
          x-anthropic-beta-required:
          - managed-agents-2026-04-01
          examples:
          - null
      example:
        type: agent
        id: agent_011CZkYpogX7uDKUyvBTophP
        version: 1
        name: My First Agent
        description: A general-purpose starter agent.
        model:
          id: claude-opus-5
          speed: standard
        system: You are a general-purpose agent that can research, write code, run commands, and use connected tools to complete the user's task end to end.
        tools:
        - type: agent_toolset_20260401
          default_config:
            enabled: true
            permission_policy:
              type: always_ask
          configs: []
        mcp_servers:
        - type: url
          name: example-mcp
          url: https://example-server.modelcontextprotocol.io/sse
        skills:
        - type: anthropic
          skill_id: xlsx
          version: '1'
        - type: custom
          skill_id: skill_011CZkZFNu9hAbo3jZPRgTlx
          version: '2'
        multiagent: null
        metadata:
          foo: bar
        created_at: '2026-03-15T10:00:00Z'
        updated_at: '2026-03-15T10:00:00Z'
        archived_at: null
    BetaTimestamp:
      description: A timestamp in RFC 3339 format
      type: string
      format: date-time
    BetaOverloadedError:
      properties:
        message:
          default: Overloaded
          title: Message
          type: string
        type:
          const: overloaded_error
          default: overloaded_error
          title: Type
          type: string
      required:
      - message
      - type
      title: OverloadedError
      type: object
    BetaBillingError:
      properties:
        message:
          default: Billing error
          title: Message
          type: string
        type:
          const: billing_error
          default: billing_error
          title: Type
          type: string
      required:
      - message
      - type
      title: BillingError
      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: '#/components/schemas/BetaManagedAgentsPermissionPolicy'
    BetaManagedAgentsEffortMax:
      description: Maximum effort. Favors reasoning depth over latency.
      type: object
      additionalProperties: false
      required:
      - type
      properties:
        type:
          type: string
          enum:
          - max
    BetaManagedAgentsEditToolConfigParams:
      description: Configuration override for the edit tool.
      type: object
      additionalProperties: false
      required:
      - name
      properties:
        type:
          type: string
          const: edit
        name:
          description: Must be "edit".
          type: string
          const: edit
        enabled:
          description: Whether this tool is enabled and available to Claude. Overrides the default_config setting.
          anyOf:
          - type: boolean
          - type: 'null'
        permission_policy:
          description: Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
          anyOf:
          - $ref: '#/components/schemas/BetaManagedAgentsPermissionPolicy'
          - type: 'null'
    BetaManagedAgentsAlwaysAskPolicy:
      description: Tool calls require user confirmation before execution.
      type: object
      additionalProperties: false
      required:
      - type
      properties:
        type:
          type: string
          enum:
          - always_ask
    BetaAuthenticationError:
      properties:
        message:
          default: Authentication error
          title: Message
          type: string
        type:
          const: authentication_error
          default: authentication_error
          title: Type
          type: string
      required:
      - message
      - type
      title: AuthenticationError
      type: object
    BetaNotFoundError:
      properties:
        message:
          default: Not found
          title: Message
          type: string
        type:
          const: not_found_error
          default: not_found_error
          title: Type
          type: string
      required:
      - message
      - type
      title: NotFoundError
      type: object
    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
    BetaManagedAgentsSkillParams:
      description: Skill to load in the session container.
      discriminator:
        propertyName: type
        mapping:
          anthropic: '#/components/schemas/BetaManagedAgentsAnthropicSkillParams'
          custom: '#/components/schemas/BetaManagedAgentsCustomSkillParams'
      oneOf:
      - $ref: '#/components/schemas/BetaManagedAgentsAnthropicSkillParams'
      - $ref: '#/components/schemas/BetaManagedAgentsCustomSkillParams'
    BetaManagedAgentsEffort:
      description: How hard Claude works on each turn. Sets `output_config.effort` on every Messages call the session makes.
      type: object
      discriminator:
        propertyName: type
        mapping:
          low: '#/components/schemas/BetaManagedAgentsEffortLow'
          medium: '#/components/schemas/BetaManagedAgentsEffortMedium'
          high: '#/components/schemas/BetaManagedAgentsEffortHigh'
          xhigh: '#/components/schemas/BetaManagedAgentsEffortXhigh'
          max: '#/components/schemas/BetaManagedAgentsEffortMax'
      oneOf:
      - $ref: '#/components/schemas/BetaManagedAgentsEffortLow'
      - $ref: '#/components/schemas/BetaManagedAgentsEffortMedium'
      - $ref: '#/components/schemas/BetaManagedAgentsEffortHigh'
      - $ref: '#/components/schemas/BetaManagedAgentsEffortXhigh'
      - $ref: '#/components/schemas/BetaManagedAgentsEffortMax'
    BetaPermissionError:
      properties:
        message:
          default: Permission denied
          title: Message
          type: string
        type:
          const: permission_error
          default: permission_error
          title: Type
          type: string
      required:
      - message
      - type
      title: PermissionError
      type: object
    BetaManagedAgentsAgentToolsetDefaultConfig:
      description: Resolved default configuration for agent tools.
      type: object
      additionalProperties: false
      required:
      - enabled
      - permission_policy
      properties:
        enabled:
          type: boolean
        permission_policy:
          $ref: '#/components/schemas/BetaManagedAgentsPermissionPolicy'
    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: '#/components/schemas/BetaManagedAgentsPermissionPolicy'
    BetaManagedAgentsSkill:
      description: Resolved skill as returned in API responses.
      discriminator:
        propertyName: type
        mapping:
          anthropic: '#/components/schemas/BetaManagedAgentsAnthropicSkill'
          custom: '#/components/schemas/BetaManagedAgentsCustomSkill'
      oneOf:
      - $ref: '#/components/schemas/BetaManagedAgentsAnthropicSkill'
      - $ref: '#/components/schemas/BetaManagedAgentsCustomSkill'
    BetaManagedAgentsAlwaysAllowPolicy:
      description: Tool calls are automatically approved without user confirmation.
      type: object
      additionalProperties: false
      required:
      - type
      properties:
        type:
          type: string
          enum:
          - always_allow
    BetaManagedAgentsMultiagent:
      description: Resolved multiagent orchestration configuration as returned in API responses.
      discriminator:
        propertyName: type
        mapping:
          coordinator: '#/components/schemas/BetaManagedAgentsMultiagentCoordinator'
      oneOf:
      - $ref: '#/components/schemas/BetaManagedAgentsMultiagentCoordinator'
    BetaManagedAgentsMCPToolsetDefaultConfigParams:
      description: Default configuration for all tools from an MCP server.
      type: object
      additionalProperties: false
      properties:
        enabled:
          description: Whether tools are enabled by default. Defaults to true if not specified.
          anyOf:
          - type: boolean
          - type: 'null'
        permission_policy:
          description: Default permission policy for tools from this server.
          anyOf:
          - $ref: '#/components/schemas/BetaManagedAgentsPermissionPolicy'
          - type: 'null'
    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: '#/components/schemas/BetaManagedAgentsCustomToolInputSchema'
    BetaErrorResponse:
      properties:
        error:
          discriminator:
            mapping:
              api_error: '#/components/schemas/BetaAPIError'
              authentication_error: '#/components/schemas/BetaAuthenticationError'
              billing_error: '#/components/schemas/BetaBillingError'
              invalid_request_error: '#/components/schemas/BetaInvalidRequestError'
              not_found_error: '#/components/schemas/BetaNotFoundError'
              overloaded_error: '#/components/schemas/BetaOverloadedError'
              permission_error: '#/components/schemas/BetaPermissionError'
              rate_limit_error: '#/components/schemas/BetaRateLimitError'
              timeout_error: '#/components/schemas/BetaGatewayTimeoutError'
            propertyName: type
          oneOf:
          - $ref: '#/components/schemas/BetaInvalidRequestError'
          - $ref: '#/components/schemas/BetaAuthenticationError'
          - $ref: '#/components/schemas/BetaBillingError'
          - $ref: '#/components/schemas/BetaPermissionError'
          - $ref: '#/components/schemas/BetaNotFoundError'
          - $ref: '#/components/schemas/BetaRateLimitError'
          - $ref: '#/components/schemas/BetaGatewayTimeoutError'
          - $ref: '#/components/schemas/BetaAPIError'
          - $ref: '#/components/schemas/BetaOverloadedError'
          title: Error
        request_id:
          anyOf:
          - type: string
          - type: 'null'
          default: null
          title: Request Id
        type:
          const: error
          default: error
          title: Type
          type: string
      required:
      - error
      - request_id
      - type
      title: ErrorResponse
      type: object
    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: '#/components/schemas/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'
    AnthropicBeta:
      anyOf:
      - type: string
      - type: string
        enum:
        - message-batches-2024-09-24
        - prompt-caching-2024-07-31
        - computer-use-2024-10-22
        - computer-use-2025-01-24
        - pdfs-2024-09-25
        - token-counting-2024-11-01
        - token-efficient-tools-2025-02-19
        - output-128k-2025-02-19
        - files-api-2025-04-14
        - mcp-client-2025-04-04
        - mcp-client-2025-11-20
        - dev-full-thinking-2025-05-14
        - interleaved-thinking-2025-05-14
        - code-execution-2025-05-22
        - extended-cache-ttl-2025-04-11
        - context-1m-2025-08-07
        - context-management-2025-06-27
        - model-context-window-exceeded-2025-08-26
        - skills-2025-10-02
        - fast-mode-2026-02-01
        - output-300k-2026-03-24
        - user-profiles-2026-03-24
        - user-profiles-2026-08-18
        - advisor-tool-2026-03-01
        - managed-agents-2026-04-01
        - cache-diagnosis-2026-04-07
        - dreaming-2026-04-21
        - thinking-token-count-2026-05-13
        - server-side-fallback-2026-06-01
        - server-side-fallback-2026-07-01
        - fallback-credit-2026-06-01
        - fallback-credit-2026-07-01
        - agent-memory-2026-07-22
        - mid-conversation-tool-changes-2026-07-01
        - compact-2026-01-12
        - computer-use-2025-11-24
        - mcp-tunnels-2026-06-22
        - structured-outputs-2025-11-13
        - task-budgets-2026-03-13
        - thinking-display-updates-2026-08-18
        - ce-user-management-2026-07-13
        x-stainless-nominal: false