openapi: 3.2.0
info:
  title: Anthropic Sessions?beta=true API
servers:
- url: https://api.anthropic.com
tags:
- name: Sessions?beta=true
paths:
  /v1/sessions?beta=true:
    post:
      operationId: BetaCreateSession
      summary: Create Session
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BetaManagedAgentsCreateSessionParams'
      responses:
        '200':
          description: Successful response (OK)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaManagedAgentsSession'
        '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:
      - Sessions?beta=true
    get:
      operationId: BetaListSessions
      summary: List Sessions
      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 number of results to return.
      - name: page
        in: query
        required: false
        schema:
          type: string
        description: Opaque pagination cursor from a previous response.
      - name: include_archived
        in: query
        required: false
        schema:
          type: boolean
        description: 'When true, includes archived sessions. Default: false (exclude archived).'
      - name: created_at[gte]
        in: query
        required: false
        schema:
          $ref: '#/components/schemas/BetaTimestamp'
        description: Return sessions created at or after this time (inclusive).
      - name: created_at[gt]
        in: query
        required: false
        schema:
          $ref: '#/components/schemas/BetaTimestamp'
        description: Return sessions created after this time (exclusive).
      - name: created_at[lte]
        in: query
        required: false
        schema:
          $ref: '#/components/schemas/BetaTimestamp'
        description: Return sessions created at or before this time (inclusive).
      - name: created_at[lt]
        in: query
        required: false
        schema:
          $ref: '#/components/schemas/BetaTimestamp'
        description: Return sessions created before this time (exclusive).
      - name: agent_id
        in: query
        required: false
        schema:
          type: string
        description: Filter sessions created with this agent ID.
      - name: agent_version
        in: query
        required: false
        schema:
          type: integer
          format: int32
        description: Filter by agent version. Only applies when agent_id is also set.
      - name: order
        in: query
        required: false
        schema:
          $ref: '#/components/schemas/BetaManagedAgentsListOrder'
        description: Sort direction for results, ordered by created_at. Defaults to desc (newest first).
      - name: memory_store_id
        in: query
        required: false
        schema:
          type: string
        description: Filter sessions whose resources contain a memory_store with this memory store ID.
      - name: deployment_id
        in: query
        required: false
        schema:
          type: string
        description: Filter sessions created by this deployment ID.
      - name: statuses[]
        in: query
        required: false
        style: form
        explode: true
        schema:
          type: array
          items:
            $ref: '#/components/schemas/BetaManagedAgentsSessionStatus'
        description: Filter by session status. Repeat the parameter to match any of multiple statuses.
      responses:
        '200':
          description: Successful response (OK)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaManagedAgentsListSessions'
        '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:
      - Sessions?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'
    BetaManagedAgentsSessionUsage:
      description: Cumulative token usage for a session across all turns.
      type: object
      additionalProperties: false
      properties:
        input_tokens:
          description: Total input tokens consumed across all turns.
          type: integer
          format: int32
        output_tokens:
          description: Total output tokens generated across all turns.
          type: integer
          format: int32
        cache_read_input_tokens:
          description: Total tokens read from prompt cache.
          type: integer
          format: int32
        cache_creation:
          description: Tokens used to create prompt cache entries, broken down by cache TTL.
          allOf:
          - $ref: '#/components/schemas/BetaManagedAgentsCacheCreationUsage'
        list_cost:
          description: Cumulative list cost of the session across all turns, priced at public list rates. Absent until cost tracking is available for the session.
          anyOf:
          - $ref: '#/components/schemas/BetaMonetaryAmount'
          - type: 'null'
          x-anthropic-beta-required:
          - managed-agents-2026-04-01
        server_tool_use:
          description: Cumulative server-executed tool usage across all turns. Absent until server-tool tracking is available for the session.
          anyOf:
          - $ref: '#/components/schemas/BetaManagedAgentsServerToolUsage'
          - type: 'null'
          x-anthropic-beta-required:
          - managed-agents-2026-04-01
        active_seconds:
          description: Cumulative time in seconds during which the session had at least one thread in running status. Overlapping activity from concurrent threads is counted once, unlike `stats.active_seconds`, which sums each thread's own active time. This is the duration the session's runtime cost is priced on.
          type: number
          format: double
          x-anthropic-beta-required:
          - managed-agents-2026-04-01
    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'
    BetaManagedAgentsUserMessageEventParams:
      description: Parameters for sending a user message to the session.
      type: object
      additionalProperties: false
      required:
      - type
      - content
      properties:
        type:
          type: string
          enum:
          - user.message
          examples:
          - user.message
        content:
          description: Array of content blocks for the user message.
          type: array
          items:
            $ref: '#/components/schemas/BetaManagedAgentsUserContentBlock'
          examples:
          - - type: text
              text: 'Where is my order #1234?'
      example:
        type: user.message
        content:
        - type: text
          text: 'Where is my order #1234?'
    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'
    BetaManagedAgentsDocumentBlock:
      description: Document content, either specified directly as base64 data, as text, or as a reference via a URL.
      type: object
      additionalProperties: false
      required:
      - type
      - source
      properties:
        type:
          type: string
          enum:
          - document
        source:
          description: The source of the document data.
          allOf:
          - $ref: '#/components/schemas/BetaManagedAgentsDocumentSource'
        title:
          description: The title of the document.
          anyOf:
          - type: string
          - type: 'null'
        context:
          description: Additional context about the document for the model.
          anyOf:
          - type: string
          - type: 'null'
    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'
    BetaManagedAgentsURLImageSource:
      description: Image referenced by URL.
      type: object
      additionalProperties: false
      required:
      - type
      - url
      properties:
        type:
          type: string
          enum:
          - url
        url:
          description: URL of the image to fetch.
          type: string
          minLength: 1
    BetaManagedAgentsBudget:
      description: An enforced spend ceiling on a session. Discriminated on `type`; `limit` is the only kind currently supported.
      type: object
      discriminator:
        propertyName: type
        mapping:
          limit: '#/components/schemas/BetaManagedAgentsBudgetLimit'
      oneOf:
      - $ref: '#/components/schemas/BetaManagedAgentsBudgetLimit'
    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
    BetaManagedAgentsCacheCreationUsage:
      description: Prompt-cache creation token usage broken down by cache lifetime.
      type: object
      additionalProperties: false
      properties:
        ephemeral_1h_input_tokens:
          description: Tokens used to create 1-hour ephemeral cache entries.
          type: integer
          format: int32
        ephemeral_5m_input_tokens:
          description: Tokens used to create 5-minute ephemeral cache entries.
          type: integer
          format: int32
    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'
    BetaManagedAgentsFileDocumentSource:
      description: Document referenced by file ID.
      type: object
      additionalProperties: false
      required:
      - type
      - file_id
      properties:
        type:
          type: string
          enum:
          - file
        file_id:
          description: ID of a previously uploaded file.
          type: string
          minLength: 1
    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'
    BetaManagedAgentsFileRubricParams:
      description: Rubric referenced by a file uploaded via the Files API.
      type: object
      additionalProperties: false
      required:
      - type
      - file_id
      properties:
        type:
          type: string
          enum:
          - file
          examples:
          - file
        file_id:
          description: ID of the rubric file.
          type: string
          examples:
          - file_011CNha8iCJcU1wXNR6q4V8w
      example:
        type: file
        file_id: file_011CNha8iCJcU1wXNR6q4V8w
    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'
    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'
    BetaManagedAgentsUserContentBlock:
      description: Content block in a user message. Can be `text`, `image`, or `document`.
      type: object
      discriminator:
        propertyName: type
        mapping:
          text: '#/components/schemas/BetaManagedAgentsTextBlock'
          image: '#/components/schemas/BetaManagedAgentsImageBlock'
          document: '#/components/schemas/BetaManagedAgentsDocumentBlock'
          redacted: '#/components/schemas/BetaManagedAgentsRedactedBlock'
      oneOf:
      - $ref: '#/components/schemas/BetaManagedAgentsTextBlock'
      - $ref: '#/components/schemas/BetaManagedAgentsImageBlock'
      - $ref: '#/components/schemas/BetaManagedAgentsDocumentBlock'
      - $ref: '#/components/schemas/BetaManagedAgentsRedactedBlock'
    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
    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'
    BetaManagedAgentsSessionThreadAgent:
      description: Resolved `agent` definition for a single `session_thread`. Snapshot of the agent at thread creation time. The multiagent roster is not repeated here; read it from `Session.agent`.
      type: object
      additionalProperties: false
      required:
      - type
      - id
      - version
      - name
      - description
      - model
      - system
      - tools
      - mcp_servers
      - skills
      properties:
        type:
          type: string
          enum:
          - agent
          examples:
          - agent
        id:
          type: string
          examples:
          - agent_011CZkYqphY8vELVzwCUpqiQ
        version:
          type: integer
          format: int32
          examples:
          - 1
        name:
          type: string
          examples:
          - Researcher
        description:
          anyOf:
          - type: string
          - type: 'null'
          examples:
          - A focused research subagent.
        model:
          $ref: '#/components/schemas/BetaManagedAgentsModelConfig'
          examples:
          - id: claude-opus-5
            speed: standard
        system:
          anyOf:
          - type: string
          - type: 'null'
          examples:
          - You are a research subagent that gathers and summarises sources for the coordinating agent.
        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:
          - []
        skills:
          type: array
          items:
            $ref: '#/components/schemas/BetaManagedAgentsSkill'
          examples:
          - []
      example:
        type: agent
        id: agent_011CZkYqphY8vELVzwCUpqiQ
        version: 1
        name: Researcher
        description: A focused research subagent.
        model:
          id: claude-opus-5
          speed: standard
        system: You are a research subagent that gathers and summarises sources for the coordinating agent.
        tools:
        - type: agent_toolset_20260401
          default_config:
            enabled: true
            permission_policy:
              type: always_ask
          configs: []
        mcp_servers: []
        skills: []
    BetaManagedAgentsListSessions:
      description: Paginated list of sessions.
      type: object
      additionalProperties: false
      properties:
        data:
          description: List of sessions.
          x-stainless-pagination-property:
            purpose: items
          type: array
          items:
            $ref: '#/components/schemas/BetaManagedAgentsSession'
          examples:
          - []
        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'
          examples:
          - page_MjAyNS0wNS0xNFQwMDowMDowMFo=
        prev_page:
          description: Opaque cursor for the previous page. Null when on the first page. Pass as the `page` parameter to navigate backward.
          anyOf:
          - type: string
          - type: 'null'
          x-anthropic-beta-required:
          - managed-agents-2026-04-01
          examples:
          - page_MjAyNS0wNS0xM1QwMDowMDowMFo=
      example:
        data: []
        next_page: page_MjAyNS0wNS0xNFQwMDowMDowMFo=
        prev_page: page_MjAyNS0wNS0xM1QwMDowMDowMFo=
    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'
    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
    BetaManagedAgentsSessionStats:
      description: Timing statistics for a session.
      type: object
      additionalProperties: false
      properties:
        duration_seconds:
          description: Elapsed time since session creation in seconds. For terminated sessions, frozen at the final update.
          type: number
          format: double
        active_seconds:
          description: Cumulative time in seconds the session spent in running status. Excludes idle time.
          type: number
          format: double
    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
    BetaManagedAgentsSessionAgent:
      description: Resolved `agent` definition for a `session`. Snapshot of the `agent` at `session` creation time.
      type: object
      additionalProperties: false
      required:
      - type
      - id
      - version
      - name
      - description
      - model
      - system
      - tools
      - mcp_servers
      - skills
      - multiagent
      properties:
        type:
          type: string
          enum:
          - agent
          examples:
          - agent
        id:
          type: string
          examples:
          - agent_011CZkYpogX7uDKUyvBTophP
        version:
          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'
        multiagent:
          description: Resolved multiagent orchestration configuration. Null when the agent is single-threaded.
          anyOf:
          - $ref: '#/components/schemas/BetaManagedAgentsSessionMultiagent'
          - 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
    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'
    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
    BetaManagedAgentsBranchCheckout:
      type: object
      additionalProperties: false
      required:
      - type
      - name
      properties:
        type:
          type: string
          enum:
          - branch
          examples:
          - branch
        name:
          description: Branch name to check out.
          type: string
          minLength: 1
          maxLength: 255
          examples:
          - main
      example:
        type: branch
        name: main
    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'
    BetaManagedAgentsCreateSessionParams:
      description: Request parameters for creating a `session`.
      type: object
      additionalProperties: false
      required:
      - agent
      - environment_id
      properties:
        agent:
          description: Agent identifier. Accepts the `agent` ID string, which pins the latest version for the session, or an `agent` object with both id and version specified.
          allOf:
          - $ref: '#/components/schemas/BetaManagedAgentsCreateSessionAgentUnionParams'
          examples:
          - agent_011CZkYpogX7uDKUyvBTophP
        environment_id:
          description: ID of the `environment` defining the container configuration for this session.
          type: string
          minLength: 1
          maxLength: 128
          examples:
          - env_011CZkZ9X2dpNyB7HsEFoRfW
        title:
          description: Human-readable session title.
          anyOf:
          - type: string
            maxLength: 500
          - type: 'null'
          examples:
          - 'Order #1234 inquiry'
        metadata:
          description: Arbitrary key-value metadata attached to the session. Maximum 16 pairs, keys up to 64 chars, values up to 512 chars.
          type: object
          additionalProperties:
            type: string
        resources:
          description: Resources (e.g. repositories, files) to mount into the session's container.
          type: array
          items:
            $ref: '#/components/schemas/BetaManagedAgentsSessionResourceParams'
        vault_ids:
          description: Vault IDs for stored credentials the agent can use during the session.
          type: array
          items:
            type: string
        initial_events:
          description: Initial events to send to the `session` at creation, processed in order. Supports `user.message` and `user.define_outcome` events. Maximum 50 events.
          type: array
          items:
            $ref: '#/components/schemas/BetaManagedAgentsSessionInitialEventParams'
          x-anthropic-beta-required:
          - managed-agents-2026-04-01
        budget:
          description: Enforced spend ceiling for the session. Omit to create an uncapped session. Every model the session can run — the agent's model and each callable agent's model — must have a public list price, or the request is rejected with reason `model_not_budgetable`.
          allOf:
          - $ref: '#/components/schemas/BetaManagedAgentsBudget'
          x-anthropic-beta-required:
          - managed-agents-2026-04-01
      example:
        agent: agent_011CZkYpogX7uDKUyvBTophP
        environment_id: env_011CZkZ9X2dpNyB7HsEFoRfW
        title: 'Order #1234 inquiry'
    BetaManagedAgentsBase64DocumentSource:
      description: Base64-encoded document data.
      type: object
      additionalProperties: false
      required:
      - type
      - media_type
      - data
      properties:
        type:
          type: string
          enum:
          - base64
        media_type:
          description: MIME type of the document (e.g., "application/pdf").
          type: string
          minLength: 1
        data:
          description: Base64-encoded document data.
          type: string
          minLength: 1
    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'
    BetaManagedAgentsGitHubRepositoryResourceParams:
      description: Mount a GitHub repository into the session's container.
      type: object
      additionalProperties: false
      required:
      - type
      - url
      - authorization_token
      properties:
        type:
          type: string
          enum:
          - github_repository
          examples:
          - github_repository
        url:
          description: Github URL of the repository
          type: string
          minLength: 1
          maxLength: 2048
          examples:
          - https://github.com/example-org/example-repo
        authorization_token:
          description: GitHub authorization token used to clone the repository.
          type: string
          minLength: 1
          maxLength: 4096
          examples:
          - ghp_exampletoken
        mount_path:
          description: Mount path in the container. Defaults to `/workspace/<repo-name>`.
          anyOf:
          - type: string
            minLength: 1
            maxLength: 4096
          - type: 'null'
        checkout:
          description: Branch or commit to check out. Defaults to the repository's default branch.
          anyOf:
          - $ref: '#/components/schemas/BetaManagedAgentsRepositoryCheckout'
          - type: 'null'
      example:
        type: github_repository
        url: https://github.com/example-org/example-repo
        authorization_token: ghp_exampletoken
    BetaManagedAgentsSessionMultiagentCoordinator:
      description: Resolved coordinator topology with full agent definitions for each roster member.
      type: object
      additionalProperties: false
      required:
      - type
      - agents
      properties:
        type:
          type: string
          enum:
          - coordinator
        agents:
          description: Full `agent` definitions the coordinator may spawn as session threads.
          type: array
          items:
            $ref: '#/components/schemas/BetaManagedAgentsSessionRosterEntry'
    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
    BetaManagedAgentsFileResourceParams:
      description: Mount a file uploaded via the Files API into the session.
      type: object
      additionalProperties: false
      required:
      - type
      - file_id
      properties:
        type:
          type: string
          enum:
          - file
          examples:
          - file
        file_id:
          description: ID of a previously uploaded file.
          type: string
          minLength: 1
          maxLength: 128
          examples:
          - file_011CNha8iCJcU1wXNR6q4V8w
        mount_path:
          description: Mount path in the container. Defaults to `/mnt/session/uploads/<file_id>`.
          anyOf:
          - type: string
            minLength: 1
            maxLength: 4096
          - type: 'null'
          examples:
          - /uploads/receipt.pdf
      example:
        type: file
        file_id: file_011CNha8iCJcU1wXNR6q4V8w
        mount_path: /uploads/receipt.pdf
    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'
    BetaManagedAgentsSessionMultiagent:
      description: Resolved multiagent orchestration configuration as returned on a `session`.
      discriminator:
        propertyName: type
        mapping:
          coordinator: '#/components/schemas/BetaManagedAgentsSessionMultiagentCoordinator'
      oneOf:
      - $ref: '#/components/schemas/BetaManagedAgentsSessionMultiagentCoordinator'
    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
    BetaManagedAgentsSessionResourceParams:
      description: Union of resources that can be mounted into a session.
      type: object
      discriminator:
        propertyName: type
        mapping:
          github_repository: '#/components/schemas/BetaManagedAgentsGitHubRepositoryResourceParams'
          file: '#/components/schemas/BetaManagedAgentsFileResourceParams'
          memory_store: '#/components/schemas/BetaManagedAgentsMemoryStoreResourceParam'
      oneOf:
      - $ref: '#/components/schemas/BetaManagedAgentsGitHubRepositoryResourceParams'
      - $ref: '#/components/schemas/BetaManagedAgentsFileResourceParams'
      - $ref: '#/components/schemas/BetaManagedAgentsMemoryStoreResourceParam'
      example:
        type: file
        file_id: file_011CNha8iCJcU1wXNR6q4V8w
        mount_path: /uploads/receipt.pdf
    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
    BetaManagedAgentsOutcomeEvaluationResource:
      description: Evaluation state for a single outcome defined via a define_outcome event.
      type: object
      additionalProperties: false
      required:
      - type
      - outcome_id
      - description
      - result
      - iteration
      - completed_at
      - explanation
      properties:
        type:
          type: string
          enum:
          - outcome_evaluation
          examples:
          - outcome_evaluation
        outcome_id:
          description: Server-generated outc_ ID for this outcome.
          type: string
          examples:
          - outc_011CZkZRSw2kEfs6ncTVljxP
        description:
          description: What the agent should produce.
          type: string
          examples:
          - Produce a 2-page summary as summary.md
        result:
          description: Current evaluation state. `pending` before the agent begins work; `running` while producing or revising; `evaluating` while the grader scores; `satisfied`/`max_iterations_reached`/`failed`/`interrupted` are terminal.
          type: string
          examples:
          - satisfied
        iteration:
          description: 0-indexed revision cycle the outcome is currently on.
          type: integer
          format: int32
          examples:
          - 0
        completed_at:
          description: When the outcome reached a terminal result. Null while pending/running/evaluating.
          anyOf:
          - $ref: '#/components/schemas/BetaTimestamp'
          - type: 'null'
          examples:
          - '2026-03-15T10:02:31Z'
        explanation:
          description: Grader's verdict text from the most recent evaluation. For satisfied, explains why criteria are met; for needs_revision (intermediate), what's missing; for failed, why unrecoverable.
          anyOf:
          - type: string
          - type: 'null'
          examples:
          - All five sections present with inline citations.
      example:
        type: outcome_evaluation
        outcome_id: outc_011CZkZRSw2kEfs6ncTVljxP
        description: Produce a 2-page summary as summary.md
        result: satisfied
        iteration: 0
        completed_at: '2026-03-15T10:02:31Z'
        explanation: All five sections present with inline citations.
    BetaManagedAgentsServerToolUsage:
      description: Cumulative count of server-executed tool invocations, broken down by tool.
      type: object
      additionalProperties: false
      properties:
        web_search_requests:
          description: Number of server-executed web search requests.
          type: integer
          format: int32
          examples:
          - 3
        web_fetch_requests:
          description: Number of server-executed web fetch requests.
          type: integer
          format: int32
          examples:
          - 0
      example:
        web_search_requests: 3
        web_fetch_requests: 0
    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'
    BetaManagedAgentsURLDocumentSource:
      description: Document referenced by URL.
      type: object
      additionalProperties: false
      required:
      - type
      - url
      properties:
        type:
          type: string
          enum:
          - url
        url:
          description: URL of the document to fetch.
          type: string
          minLength: 1
    BetaManagedAgentsModelParams:
      oneOf:
      - title: BetaManagedAgentsModel
        allOf:
        - $ref: '#/components/schemas/BetaManagedAgentsModel'
        x-stainless-skip:
        - go
        - cli
      - $ref: '#/components/schemas/BetaManagedAgentsModelConfigParams'
    BetaManagedAgentsCommitCheckout:
      type: object
      additionalProperties: false
      required:
      - type
      - sha
      properties:
        type:
          type: string
          enum:
          - commit
        sha:
          description: Full commit SHA to check out.
          type: string
          minLength: 7
          maxLength: 64
    BetaManagedAgentsPlainTextDocumentSource:
      description: Plain text document content.
      type: object
      additionalProperties: false
      required:
      - type
      - media_type
      - data
      properties:
        type:
          type: string
          enum:
          - text
        media_type:
          description: MIME type of the text content. Must be "text/plain".
          type: string
          enum:
          - text/plain
        data:
          description: The plain text content.
          type: string
          minLength: 1
    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'
    BetaManagedAgentsMemoryStoreResource:
      description: A memory store attached to an agent session.
      type: object
      additionalProperties: false
      required:
      - type
      - memory_store_id
      properties:
        type:
          type: string
          enum:
          - memory_store
        memory_store_id:
          description: The memory store ID (memstore_...). Must belong to the caller's organization and workspace.
          type: string
        access:
          description: Access mode for the mounted store. Defaults to read_write. read_only mounts the store as a read-only filesystem.
          anyOf:
          - $ref: '#/components/schemas/BetaManagedAgentsMountMode'
          - type: 'null'
        name:
          description: Display name of the memory store, snapshotted at attach time. Later edits to the store's name do not propagate to this resource.
          anyOf:
          - type: string
          - type: 'null'
          x-anthropic-beta-required:
          - agent-memory-2026-07-22
          - managed-agents-2026-04-01
        description:
          description: Description of the memory store, snapshotted at attach time. Rendered into the agent's system prompt. Empty string when the store has no description.
          type: string
          x-anthropic-beta-required:
          - agent-memory-2026-07-22
          - managed-agents-2026-04-01
        instructions:
          description: Per-attachment guidance for the agent on how to use this store. Rendered into the memory section of the system prompt. Max 4096 chars.
          anyOf:
          - type: string
            maxLength: 4096
          - type: 'null'
          x-anthropic-beta-required:
          - agent-memory-2026-07-22
          - managed-agents-2026-04-01
        mount_path:
          description: Filesystem path where the store is mounted in the session container, e.g. /mnt/memory/user-preferences. Derived from the store's name. Output-only.
          anyOf:
          - type: string
          - type: 'null'
          x-anthropic-beta-required:
          - agent-memory-2026-07-22
          - managed-agents-2026-04-01
    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
    BetaManagedAgentsRubricParams:
      description: Rubric for grading the quality of an outcome.
      discriminator:
        propertyName: type
        mapping:
          file: '#/components/schemas/BetaManagedAgentsFileRubricParams'
          text: '#/components/schemas/BetaManagedAgentsTextRubricParams'
      oneOf:
      - $ref: '#/components/schemas/BetaManagedAgentsFileRubricParams'
      - $ref: '#/components/schemas/BetaManagedAgentsTextRubricParams'
    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'
    BetaManagedAgentsTextRubricParams:
      description: Rubric content provided inline as text.
      type: object
      additionalProperties: false
      required:
      - type
      - content
      properties:
        type:
          type: string
          enum:
          - text
          examples:
          - text
        content:
          description: Rubric content. Plain text or markdown — the grader treats it as freeform text. Maximum 262144 characters.
          type: string
          maxLength: 262144
          examples:
          - Must cover all five sections; cite sources inline.
      example:
        type: text
        content: Must cover all five sections; cite sources inline.
    BetaManagedAgentsRedactedBlock:
      description: Placeholder for content withheld by Anthropic model policy.
      type: object
      additionalProperties: false
      required:
      - type
      properties:
        type:
          type: string
          enum:
          - redacted
    BetaManagedAgentsUserDefineOutcomeEventParams:
      description: Parameters for defining an outcome the agent should work toward. The agent begins work on receipt.
      type: object
      additionalProperties: false
      required:
      - type
      - description
      - rubric
      properties:
        type:
          type: string
          enum:
          - user.define_outcome
          examples:
          - user.define_outcome
        description:
          description: What the agent should produce. This is the task specification.
          type: string
          examples:
          - Produce a 2-page summary as summary.md
        rubric:
          description: How to grade the outcome. Text or file reference.
          allOf:
          - $ref: '#/components/schemas/BetaManagedAgentsRubricParams'
          examples:
          - type: text
            content: Must cover all five sections; cite sources inline.
        max_iterations:
          description: Eval→revision cycles before giving up. Default 3, max 20.
          anyOf:
          - type: integer
            format: int32
          - type: 'null'
          examples:
          - 3
      example:
        type: user.define_outcome
        description: Produce a 2-page summary as summary.md
        rubric:
          type: text
          content: Must cover all five sections; cite sources inline.
        max_iterations: 3
    BetaCurrency:
      type: string
      enum:
      - USD
    BetaManagedAgentsBudgetLimit:
      description: A hard spend ceiling. The session stops issuing new model requests once the tracked list cost reaches `max_list_cost`.
      type: object
      additionalProperties: false
      required:
      - type
      - max_list_cost
      properties:
        type:
          type: string
          enum:
          - limit
        max_list_cost:
          description: Maximum list cost the session may accrue. List price is used regardless of any negotiated discount, so the cap fires at or before the actual charge.
          allOf:
          - $ref: '#/components/schemas/BetaMonetaryAmount'
    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
    BetaManagedAgentsGitHubRepositoryResource:
      type: object
      additionalProperties: false
      required:
      - type
      - id
      - url
      - mount_path
      - created_at
      - updated_at
      properties:
        type:
          type: string
          enum:
          - github_repository
          examples:
          - github_repository
        id:
          type: string
          examples:
          - sesrsc_011CZkZCKr6eXyl0gWMOdQiu
        url:
          type: string
          examples:
          - https://github.com/example-org/example-repo
        mount_path:
          type: string
          examples:
          - /workspace/example-repo
        checkout:
          anyOf:
          - $ref: '#/components/schemas/BetaManagedAgentsRepositoryCheckout'
          - type: 'null'
          examples:
          - type: branch
            name: main
        created_at:
          $ref: '#/components/schemas/BetaTimestamp'
          examples:
          - '2026-03-15T10:00:00Z'
        updated_at:
          $ref: '#/components/schemas/BetaTimestamp'
          examples:
          - '2026-03-15T10:00:00Z'
      example:
        type: github_repository
        id: sesrsc_011CZkZCKr6eXyl0gWMOdQiu
        url: https://github.com/example-org/example-repo
        mount_path: /workspace/example-repo
        checkout:
          type: branch
          name: main
        created_at: '2026-03-15T10:00:00Z'
        updated_at: '2026-03-15T10:00:00Z'
    BetaManagedAgentsImageBlock:
      description: Image content specified directly as base64 data or as a reference via a URL.
      type: object
      additionalProperties: false
      required:
      - type
      - source
      properties:
        type:
          type: string
          enum:
          - image
        source:
          description: The source of the image data.
          allOf:
          - $ref: '#/components/schemas/BetaManagedAgentsImageSource'
    BetaManagedAgentsSessionInitialEventParams:
      description: An event sent to the `session` immediately after it is created. Supports `user.message` and `user.define_outcome`.
      type: object
      discriminator:
        propertyName: type
        mapping:
          user.message: '#/components/schemas/BetaManagedAgentsUserMessageEventParams'
          user.define_outcome: '#/components/schemas/BetaManagedAgentsUserDefineOutcomeEventParams'
      oneOf:
      - $ref: '#/components/schemas/BetaManagedAgentsUserMessageEventParams'
      - $ref: '#/components/schemas/BetaManagedAgentsUserDefineOutcomeEventParams'
    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
    BetaManagedAgentsFileResource:
      type: object
      additionalProperties: false
      required:
      - type
      - id
      - file_id
      - mount_path
      - created_at
      - updated_at
      properties:
        type:
          type: string
          enum:
          - file
          examples:
          - file
        id:
          type: string
          examples:
          - sesrsc_011CZkZBJq5dWxk9fVLNcPht
        file_id:
          type: string
          examples:
          - file_011CNha8iCJcU1wXNR6q4V8w
        mount_path:
          type: string
          examples:
          - /uploads/receipt.pdf
        created_at:
          $ref: '#/components/schemas/BetaTimestamp'
          examples:
          - '2026-03-15T10:00:00Z'
        updated_at:
          $ref: '#/components/schemas/BetaTimestamp'
          examples:
          - '2026-03-15T10:00:00Z'
      example:
        type: file
        id: sesrsc_011CZkZBJq5dWxk9fVLNcPht
        file_id: file_011CNha8iCJcU1wXNR6q4V8w
        mount_path: /uploads/receipt.pdf
        created_at: '2026-03-15T10:00:00Z'
        updated_at: '2026-03-15T10:00:00Z'
    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
    BetaManagedAgentsMemoryStoreResourceParam:
      description: Parameters for attaching a memory store to an agent session.
      type: object
      additionalProperties: false
      required:
      - type
      - memory_store_id
      properties:
        type:
          type: string
          enum:
          - memory_store
        memory_store_id:
          description: The memory store ID (memstore_...). Must belong to the caller's organization and workspace.
          type: string
        access:
          description: Access mode for the mounted store. Defaults to read_write. read_only mounts the store as a read-only filesystem.
          anyOf:
          - $ref: '#/components/schemas/BetaManagedAgentsMountMode'
          - type: 'null'
        instructions:
          description: Per-attachment guidance for the agent on how to use this store. Rendered into the memory section of the system prompt. Max 4096 chars.
          anyOf:
          - type: string
            maxLength: 4096
          - type: 'null'
          x-anthropic-beta-required:
          - agent-memory-2026-07-22
          - managed-agents-2026-04-01
    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'
    BetaManagedAgentsRepositoryCheckout:
      type: object
      discriminator:
        propertyName: type
        mapping:
          branch: '#/components/schemas/BetaManagedAgentsBranchCheckout'
          commit: '#/components/schemas/BetaManagedAgentsCommitCheckout'
      oneOf:
      - $ref: '#/components/schemas/BetaManagedAgentsBranchCheckout'
      - $ref: '#/components/schemas/BetaManagedAgentsCommitCheckout'
    BetaManagedAgentsAlwaysAskPolicy:
      description: Tool calls require user confirmation before execution.
      type: object
      additionalProperties: false
      required:
      - type
      properties:
        type:
          type: string
          enum:
          - always_ask
    BetaManagedAgentsSessionRosterEntry:
      description: A session-resolved multiagent roster entry.
      discriminator:
        propertyName: type
        mapping:
          agent: '#/components/schemas/BetaManagedAgentsSessionThreadAgent'
          advisor: '#/components/schemas/BetaManagedAgentsAdvisor'
      oneOf:
      - $ref: '#/components/schemas/BetaManagedAgentsSessionThreadAgent'
      - $ref: '#/components/schemas/BetaManagedAgentsAdvisor'
    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
    BetaManagedAgentsTextBlock:
      description: Regular text content.
      type: object
      additionalProperties: false
      required:
      - type
      - text
      properties:
        type:
          type: string
          enum:
          - text
          examples:
          - text
        text:
          description: The text content.
          type: string
          minLength: 1
          examples:
          - 'Where is my order #1234?'
      example:
        type: text
        text: 'Where is my order #1234?'
    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
    BetaManagedAgentsCreateSessionAgentUnionParams:
      oneOf:
      - type: string
      - oneOf:
        - $ref: '#/components/schemas/BetaManagedAgentsAgentParams'
        - $ref: '#/components/schemas/BetaManagedAgentsAgentWithOverridesParams'
        discriminator:
          propertyName: type
          mapping:
            agent: '#/components/schemas/BetaManagedAgentsAgentParams'
            agent_with_overrides: '#/components/schemas/BetaManagedAgentsAgentWithOverridesParams'
    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'
    BetaMonetaryAmount:
      description: A monetary amount in a specific currency.
      type: object
      additionalProperties: false
      required:
      - currency
      - amount
      properties:
        currency:
          description: Uppercase ISO-4217 currency code. `USD` is the only currency currently supported; the accepted set is closed and grows only when a new currency is priced.
          allOf:
          - $ref: '#/components/schemas/BetaCurrency'
          examples:
          - USD
        amount:
          description: 'Amount in minor units of the currency, as an integer decimal string with no leading zeros: "2500" is $25.00 and "50" is fifty cents. A string rather than a number so no float rounding is ever applied.'
          type: string
          examples:
          - '2500'
      example:
        currency: USD
        amount: '2500'
    BetaManagedAgentsAlwaysAllowPolicy:
      description: Tool calls are automatically approved without user confirmation.
      type: object
      additionalProperties: false
      required:
      - type
      properties:
        type:
          type: string
          enum:
          - always_allow
    BetaManagedAgentsFileImageSource:
      description: Image referenced by file ID.
      type: object
      additionalProperties: false
      required:
      - type
      - file_id
      properties:
        type:
          type: string
          enum:
          - file
        file_id:
          description: ID of a previously uploaded file.
          type: string
          minLength: 1
    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'
    BetaManagedAgentsListOrder:
      type: string
      description: ListOrder enum
      enum:
      - asc
      - desc
    BetaManagedAgentsSessionResource:
      type: object
      discriminator:
        propertyName: type
        mapping:
          github_repository: '#/components/schemas/BetaManagedAgentsGitHubRepositoryResource'
          file: '#/components/schemas/BetaManagedAgentsFileResource'
          memory_store: '#/components/schemas/BetaManagedAgentsMemoryStoreResource'
      oneOf:
      - $ref: '#/components/schemas/BetaManagedAgentsGitHubRepositoryResource'
      - $ref: '#/components/schemas/BetaManagedAgentsFileResource'
      - $ref: '#/components/schemas/BetaManagedAgentsMemoryStoreResource'
    BetaManagedAgentsMountMode:
      type: string
      description: Access mode for an attached memory store.
      enum:
      - read_write
      - read_only
    BetaManagedAgentsImageSource:
      description: Union type for image source variants.
      type: object
      discriminator:
        propertyName: type
        mapping:
          base64: '#/components/schemas/BetaManagedAgentsBase64ImageSource'
          url: '#/components/schemas/BetaManagedAgentsURLImageSource'
          file: '#/components/schemas/BetaManagedAgentsFileImageSource'
      oneOf:
      - $ref: '#/components/schemas/BetaManagedAgentsBase64ImageSource'
      - $ref: '#/components/schemas/BetaManagedAgentsURLImageSource'
      - $ref: '#/components/schemas/BetaManagedAgentsFileImageSource'
    BetaManagedAgentsDocumentSource:
      description: Union type for document source variants.
      type: object
      discriminator:
        propertyName: type
        mapping:
          base64: '#/components/schemas/BetaManagedAgentsBase64DocumentSource'
          text: '#/components/schemas/BetaManagedAgentsPlainTextDocumentSource'
          url: '#/components/schemas/BetaManagedAgentsURLDocumentSource'
          file: '#/components/schemas/BetaManagedAgentsFileDocumentSource'
      oneOf:
      - $ref: '#/components/schemas/BetaManagedAgentsBase64DocumentSource'
      - $ref: '#/components/schemas/BetaManagedAgentsPlainTextDocumentSource'
      - $ref: '#/components/schemas/BetaManagedAgentsURLDocumentSource'
      - $ref: '#/components/schemas/BetaManagedAgentsFileDocumentSource'
    BetaManagedAgentsAgentWithOverridesParams:
      description: Reference to an `agent` plus optional configuration overrides. Each provided field replaces the agent's value for the caller's use; the agent resource is unchanged.
      type: object
      additionalProperties: false
      required:
      - type
      - id
      properties:
        type:
          type: string
          enum:
          - agent_with_overrides
        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.
          type: integer
          format: int32
        model:
          description: Replacement model. Accepts the model string, e.g. `claude-opus-5`, or a `model_config` object. Omit to use the agent's model.
          allOf:
          - $ref: '#/components/schemas/BetaManagedAgentsModelParams'
        system:
          description: Replacement system prompt. Up to 100,000 characters. Set to null to clear the agent's system prompt; omit to preserve it.
          anyOf:
          - type: string
            maxLength: 100000
          - type: 'null'
        tools:
          description: 'Replacement tool list. Full replacement: the provided array becomes the tool configuration. Send an empty array to clear; omit to preserve the agent''s tools.'
          type: array
          items:
            $ref: '#/components/schemas/BetaManagedAgentsAgentToolParams'
        mcp_servers:
          description: 'Replacement MCP server list. Full replacement: the provided array becomes the MCP servers. Send an empty array to clear; omit to preserve the agent''s servers.'
          type: array
          items:
            $ref: '#/components/schemas/BetaManagedAgentsMCPServerParams'
        skills:
          description: 'Replacement skill list. Full replacement: the provided array becomes the skills. Send an empty array to clear; omit to preserve the agent''s skills.'
          type: array
          items:
            $ref: '#/components/schemas/BetaManagedAgentsSkillParams'
    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
    BetaManagedAgentsSessionStatus:
      type: string
      description: SessionStatus enum
      enum:
      - rescheduling
      - running
      - idle
      - terminated
    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'
    BetaManagedAgentsBase64ImageSource:
      description: Base64-encoded image data.
      type: object
      additionalProperties: false
      required:
      - type
      - media_type
      - data
      properties:
        type:
          type: string
          enum:
          - base64
        media_type:
          description: MIME type of the image (e.g., "image/png", "image/jpeg", "image/gif", "image/webp").
          type: string
          minLength: 1
        data:
          description: Base64-encoded image data.
          type: string
          minLength: 1
    BetaManagedAgentsSession:
      description: A Managed Agents `session`.
      type: object
      additionalProperties: false
      required:
      - type
      - id
      - status
      - created_at
      - updated_at
      - environment_id
      - title
      - metadata
      - agent
      - resources
      - vault_ids
      - outcome_evaluations
      - usage
      - stats
      - archived_at
      - budget
      properties:
        type:
          type: string
          enum:
          - session
          examples:
          - session
        id:
          type: string
          examples:
          - sesn_011CZkZAtmR3yMPDzynEDxu7
        status:
          $ref: '#/components/schemas/BetaManagedAgentsSessionStatus'
          examples:
          - idle
        created_at:
          $ref: '#/components/schemas/BetaTimestamp'
          examples:
          - '2026-03-15T10:00:00Z'
        updated_at:
          $ref: '#/components/schemas/BetaTimestamp'
          examples:
          - '2026-03-15T10:00:00Z'
        environment_id:
          type: string
          examples:
          - env_011CZkZ9X2dpNyB7HsEFoRfW
        title:
          anyOf:
          - type: string
          - type: 'null'
          examples:
          - 'Order #1234 inquiry'
        metadata:
          type: object
          additionalProperties:
            type: string
          examples:
          - key: value
        agent:
          $ref: '#/components/schemas/BetaManagedAgentsSessionAgent'
          examples:
          - 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
        resources:
          type: array
          items:
            $ref: '#/components/schemas/BetaManagedAgentsSessionResource'
          examples:
          - - type: file
              id: sesrsc_011CZkZBJq5dWxk9fVLNcPht
              file_id: file_011CNha8iCJcU1wXNR6q4V8w
              mount_path: /uploads/receipt.pdf
              created_at: '2026-03-15T10:00:00Z'
              updated_at: '2026-03-15T10:00:00Z'
            - type: github_repository
              id: sesrsc_011CZkZCKr6eXyl0gWMOdQiu
              url: https://github.com/example-org/example-repo
              mount_path: /workspace/example-repo
              checkout:
                type: branch
                name: main
              created_at: '2026-03-15T10:00:00Z'
              updated_at: '2026-03-15T10:00:00Z'
        vault_ids:
          description: Vault IDs attached to the session at creation. Empty when no vaults were supplied.
          type: array
          items:
            type: string
          examples:
          - - vlt_011CZkZDLs7fYzm1hXNPeRjv
        outcome_evaluations:
          description: Per-outcome evaluation state. One entry per define_outcome event sent to the session.
          type: array
          items:
            $ref: '#/components/schemas/BetaManagedAgentsOutcomeEvaluationResource'
          x-anthropic-beta-required:
          - managed-agents-2026-04-01
          examples:
          - - type: outcome_evaluation
              outcome_id: outc_011CZkZRSw2kEfs6ncTVljxP
              description: Produce a 2-page summary as summary.md
              result: satisfied
              iteration: 0
              completed_at: '2026-03-15T10:02:31Z'
              explanation: All five sections present with inline citations.
        usage:
          description: Cumulative token usage for the session.
          allOf:
          - $ref: '#/components/schemas/BetaManagedAgentsSessionUsage'
          examples:
          - input_tokens: 0
            output_tokens: 0
            cache_read_input_tokens: 0
        stats:
          description: Timing statistics for the session.
          allOf:
          - $ref: '#/components/schemas/BetaManagedAgentsSessionStats'
          examples:
          - duration_seconds: 0
            active_seconds: 0
        archived_at:
          description: When the session was archived. Null if not archived.
          anyOf:
          - $ref: '#/components/schemas/BetaTimestamp'
          - type: 'null'
          examples:
          - null
        deployment_id:
          description: Deployment ID when the session was created from a deployment reference. Null otherwise.
          anyOf:
          - type: string
          - type: 'null'
          x-anthropic-beta-required:
          - managed-agents-2026-04-01
        budget:
          description: The session's enforced spend ceiling, or null when no budget is set.
          anyOf:
          - $ref: '#/components/schemas/BetaManagedAgentsBudget'
          - type: 'null'
          x-anthropic-beta-required:
          - managed-agents-2026-04-01
          examples:
          - null
      example:
        type: session
        id: sesn_011CZkZAtmR3yMPDzynEDxu7
        status: idle
        created_at: '2026-03-15T10:00:00Z'
        updated_at: '2026-03-15T10:00:00Z'
        archived_at: null
        budget: null
        environment_id: env_011CZkZ9X2dpNyB7HsEFoRfW
        title: 'Order #1234 inquiry'
        metadata: {}
        agent:
          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
        resources:
        - type: file
          id: sesrsc_011CZkZBJq5dWxk9fVLNcPht
          file_id: file_011CNha8iCJcU1wXNR6q4V8w
          mount_path: /uploads/receipt.pdf
          created_at: '2026-03-15T10:00:00Z'
          updated_at: '2026-03-15T10:00:00Z'
        - type: github_repository
          id: sesrsc_011CZkZCKr6eXyl0gWMOdQiu
          url: https://github.com/example-org/example-repo
          mount_path: /workspace/example-repo
          checkout:
            type: branch
            name: main
          created_at: '2026-03-15T10:00:00Z'
          updated_at: '2026-03-15T10:00:00Z'
        vault_ids:
        - vlt_011CZkZDLs7fYzm1hXNPeRjv
        usage:
          input_tokens: 0
          output_tokens: 0
          cache_read_input_tokens: 0
        stats:
          duration_seconds: 0
          active_seconds: 0
        outcome_evaluations:
        - type: outcome_evaluation
          outcome_id: outc_011CZkZRSw2kEfs6ncTVljxP
          description: Produce a 2-page summary as summary.md
          result: satisfied
          iteration: 0
          completed_at: '2026-03-15T10:02:31Z'
          explanation: All five sections present with inline citations.
    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