Anthropic Sessions?beta=true API

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'
    Beta

# --- truncated at 32 KB (114 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/anthropic/refs/heads/main/openapi/anthropic-sessions-beta-true-api-openapi.yml