> ## Documentation Index
> Fetch the complete documentation index at: https://checkfu.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Create an Agent

> Creates one CMA-compatible Workspace Agent and atomically creates immutable Version 1. The request carries `model`, `name`, optional `system`, tools, MCP servers, skills, coordinator roster, description, and metadata; defaults are resolved into the returned Agent. Send an `Idempotency-Key` to make retries recover the same Agent.

Checkfu support posture: alpha; hosted. Required evidence journey: agent-definition. Deployment-specific readiness and the latest proven release are available from GET /v1/support/capabilities.



## OpenAPI

````yaml /openapi.json post /v1/agents
openapi: 3.1.0
info:
  title: Checkfu API
  version: '2026-08-27'
  description: >-
    Authentication is declared per operation: API-key, runtime, or connector
    bearer; Automation signature; or credential-free pairing redemption. Every
    general Checkfu REST request requires the dated `Checkfu-Version` header
    (one of: 2026-08-27); the three MCP JSON-RPC transports use
    `MCP-Protocol-Version`, A2A uses `A2A-Version`, and the provider OAuth
    callback carries neither Checkfu header. API keys resolve one Workspace
    without a request selector; authenticated responses identify it with
    `Checkfu-Workspace-Id`.
servers:
  - url: https://api.checkfu.com
security:
  - bearerAuth: []
tags:
  - name: organizations
  - name: sourceRepositories
  - name: tenants
  - name: workspaces
  - name: principals
  - name: principalGroups
  - name: principalAccessCredentials
  - name: apiKeys
  - name: agents
  - name: harnesses
  - name: harnessRuntime
  - name: sandboxProfiles
  - name: computerProfiles
  - name: permissionAssignments
  - name: actionPolicies
  - name: files
  - name: memoryStores
  - name: dreams
  - name: modelCredentials
  - name: modelRoutingProfiles
  - name: blueprintInstallations
  - name: toolSources
  - name: skills
  - name: skillSources
  - name: agentSources
  - name: skillProposals
  - name: instructionProposals
  - name: catalog
  - name: concepts
  - name: support
  - name: connections
  - name: connectionVaults
  - name: connectionAssignments
  - name: connectedRuntimes
  - name: projects
  - name: collaboration
  - name: automationGraphs
  - name: automations
  - name: actionApprovals
  - name: standingApprovals
  - name: usage
  - name: models
  - name: outcomes
  - name: budgets
  - name: billing
  - name: sessions
  - name: audit
  - name: sessionExports
  - name: runs
  - name: runnerPools
  - name: transcripts
  - name: sessionWatches
  - name: webhookEndpoints
  - name: integrationGateway
  - name: agentDeployments
  - name: workEnvironments
  - name: computers
  - name: computerScreens
  - name: computerBrowserObservations
  - name: computerBrowserActions
  - name: environments
  - name: vaults
  - name: apiMcp
  - name: a2a
paths:
  /v1/agents:
    post:
      tags:
        - agents
      summary: Create an Agent
      description: >-
        Creates one CMA-compatible Workspace Agent and atomically creates
        immutable Version 1. The request carries `model`, `name`, optional
        `system`, tools, MCP servers, skills, coordinator roster, description,
        and metadata; defaults are resolved into the returned Agent. Send an
        `Idempotency-Key` to make retries recover the same Agent.


        Checkfu support posture: alpha; hosted. Required evidence journey:
        agent-definition. Deployment-specific readiness and the latest proven
        release are available from GET /v1/support/capabilities.
      operationId: agents.createAgent
      parameters:
        - name: checkfu-version
          in: header
          schema:
            type: string
            enum:
              - '2026-08-27'
          required: true
        - name: checkfu-beta
          in: header
          schema:
            $ref: '#/components/schemas/ManagedAgentsBetaHeaderValue'
          required: true
        - name: idempotency-key
          in: header
          schema:
            type: string
            allOf:
              - maxLength: 255
          required: false
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AgentCreateParams'
        required: true
      responses:
        '201':
          description: BetaManagedAgentsAgent
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaManagedAgentsAgent'
          headers:
            checkfu-workspace-id:
              description: The Workspace resolved from the authenticated bearer credential.
              required: true
              schema:
                $ref: '#/components/schemas/WorkspaceId'
        '400':
          description: Typed Checkfu wire error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationMalformedError'
        '401':
          description: Typed Checkfu wire error
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: object
                    required:
                      - type
                      - message
                      - more
                    properties:
                      type:
                        type: string
                        enum:
                          - auth.invalid_key
                      message:
                        type: string
                      more:
                        type: string
                        enum:
                          - >-
                            https://docs.checkfu.com/reference/errors#auth-invalid-key
                        description: >-
                          Stable public documentation and remedy for this error
                          type.
                    additionalProperties: false
                additionalProperties: false
        '403':
          description: >-
            The organization, tenant, or workspace backing this key is
            administratively disabled. | Deployment governance or retention
            policy denied the request.
          content:
            application/json:
              schema:
                anyOf:
                  - type: object
                    required:
                      - error
                    properties:
                      error:
                        type: object
                        properties:
                          type:
                            type: string
                            enum:
                              - auth.disabled_tenancy
                          message:
                            type: string
                          more:
                            type: string
                            enum:
                              - >-
                                https://docs.checkfu.com/reference/errors#auth-disabled-tenancy
                            description: >-
                              Stable public documentation and remedy for this
                              error type.
                        required:
                          - type
                          - message
                          - more
                        additionalProperties: false
                    additionalProperties: false
                  - $ref: '#/components/schemas/PolicyDeniedError'
        '409':
          description: >-
            The request conflicts with the resource's current state. | An
            idempotent mutation conflicts with a completed or in-progress
            request for the same key.
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/ValidationConflictError'
                  - $ref: '#/components/schemas/IdempotencyConflictError'
        '429':
          description: Typed Checkfu wire error
          headers:
            retry-after:
              description: >-
                Delay in seconds for rate limits or deployment quotas with a
                known release or UTC reset boundary
              required: false
              schema:
                type: integer
                minimum: 1
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: object
                    required:
                      - type
                      - message
                      - more
                    properties:
                      type:
                        type: string
                        enum:
                          - budget.exceeded
                      message:
                        type: string
                      more:
                        type: string
                        enum:
                          - >-
                            https://docs.checkfu.com/reference/errors#budget-exceeded
                        description: >-
                          Stable public documentation and remedy for this error
                          type.
                    additionalProperties: false
                additionalProperties: false
        '500':
          description: >-
            An unexpected internal failure occurred; the message contains an
            opaque incident reference.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RuntimeInternalError'
      security:
        - bearerAuth: []
components:
  schemas:
    ManagedAgentsBetaHeaderValue:
      type: string
    AgentCreateParams:
      type: object
      properties:
        model:
          $ref: '#/components/schemas/BetaManagedAgentsModelConfigParams'
        name:
          type: string
          allOf:
            - minLength: 1
            - maxLength: 255
        description:
          anyOf:
            - type: string
            - type: 'null'
        mcp_servers:
          $ref: '#/components/schemas/Arrays_2'
        metadata:
          $ref: '#/components/schemas/ResourceMetadata'
        multiagent:
          anyOf:
            - $ref: '#/components/schemas/Objects_13'
            - type: 'null'
        skills:
          type: array
          items:
            $ref: '#/components/schemas/Union_28'
        system:
          anyOf:
            - type: string
            - type: 'null'
        tools:
          $ref: '#/components/schemas/Arrays_3'
        workload_trust:
          $ref: '#/components/schemas/BetaManagedAgentsWorkloadTrustParams'
      required:
        - model
        - name
      additionalProperties: false
    BetaManagedAgentsAgent:
      type: object
      properties:
        id:
          $ref: '#/components/schemas/AgentId'
        archived_at:
          anyOf:
            - type: string
            - type: 'null'
        created_at:
          type: string
        model:
          $ref: '#/components/schemas/BetaManagedAgentsModelConfig'
        name:
          type: string
          allOf:
            - minLength: 1
            - maxLength: 255
        description:
          $ref: '#/components/schemas/Union_31'
        mcp_servers:
          $ref: '#/components/schemas/Arrays_5'
        metadata:
          $ref: '#/components/schemas/ResourceMetadata'
        multiagent:
          $ref: '#/components/schemas/Union_32'
        skills:
          $ref: '#/components/schemas/Arrays_6'
        system:
          $ref: '#/components/schemas/Union_33'
        tools:
          $ref: '#/components/schemas/Arrays_7'
        workload_trust:
          $ref: '#/components/schemas/BetaManagedAgentsWorkloadTrust'
        type:
          type: string
          enum:
            - agent
        updated_at:
          type: string
        version:
          type: integer
          allOf:
            - exclusiveMinimum: 0
      required:
        - id
        - archived_at
        - created_at
        - model
        - name
        - description
        - mcp_servers
        - metadata
        - multiagent
        - skills
        - system
        - tools
        - workload_trust
        - type
        - updated_at
        - version
      additionalProperties: false
    WorkspaceId:
      type: string
      allOf:
        - pattern: ^wrkspc_[0-9a-f]{32}$
    ValidationMalformedError:
      type: object
      properties:
        error:
          type: object
          properties:
            type:
              type: string
              enum:
                - validation.malformed
            message:
              type: string
            more:
              type: string
              enum:
                - https://docs.checkfu.com/reference/errors#validation-malformed
              description: Stable public documentation and remedy for this error type.
          required:
            - type
            - message
            - more
          additionalProperties: false
      required:
        - error
      additionalProperties: false
      description: >-
        The request could not be decoded or violated a declared input
        constraint.
    PolicyDeniedError:
      type: object
      properties:
        error:
          type: object
          properties:
            type:
              type: string
              enum:
                - policy.denied
            message:
              type: string
            more:
              type: string
              enum:
                - https://docs.checkfu.com/reference/errors#policy-denied
              description: Stable public documentation and remedy for this error type.
          required:
            - type
            - message
            - more
          additionalProperties: false
      required:
        - error
      additionalProperties: false
      description: Deployment governance or retention policy denied the request.
    ValidationConflictError:
      type: object
      properties:
        error:
          type: object
          properties:
            type:
              type: string
              enum:
                - validation.conflict
            message:
              type: string
            more:
              type: string
              enum:
                - https://docs.checkfu.com/reference/errors#validation-conflict
              description: Stable public documentation and remedy for this error type.
          required:
            - type
            - message
            - more
          additionalProperties: false
      required:
        - error
      additionalProperties: false
      description: The request conflicts with the resource's current state.
    IdempotencyConflictError:
      anyOf:
        - $ref: '#/components/schemas/ValidationIdempotencyConflictError'
        - $ref: '#/components/schemas/ValidationIdempotencyInProgressError'
      description: >-
        An idempotent mutation conflicts with a completed or in-progress request
        for the same key.
    RuntimeInternalError:
      type: object
      properties:
        error:
          type: object
          properties:
            type:
              type: string
              enum:
                - runtime.internal
            message:
              type: string
            more:
              type: string
              enum:
                - https://docs.checkfu.com/reference/errors#runtime-internal
              description: Stable public documentation and remedy for this error type.
          required:
            - type
            - message
            - more
          additionalProperties: false
      required:
        - error
      additionalProperties: false
      description: >-
        An unexpected internal failure occurred; the message contains an opaque
        incident reference.
    BetaManagedAgentsModelConfigParams:
      anyOf:
        - type: string
        - type: object
          properties:
            id:
              type: string
            effort:
              anyOf:
                - anyOf:
                    - type: string
                      enum:
                        - low
                        - medium
                        - high
                        - xhigh
                        - max
                    - $ref: '#/components/schemas/Union_24'
                - type: 'null'
            inference_geo:
              anyOf:
                - $ref: '#/components/schemas/Union_11'
                - type: 'null'
            speed:
              anyOf:
                - type: string
                  enum:
                    - standard
                    - fast
                - type: 'null'
          required:
            - id
          additionalProperties: false
    Arrays_2:
      type: array
      items:
        $ref: '#/components/schemas/Objects_12'
      allOf:
        - maxItems: 20
    ResourceMetadata:
      type: object
      additionalProperties:
        type: string
        allOf:
          - maxLength: 512
      allOf:
        - propertyNames:
            type: string
            allOf:
              - minLength: 1
              - maxLength: 64
        - maxProperties: 16
          description: at most 16 correlation pairs with keys of 1 to 64 characters
    Objects_13:
      type: object
      properties:
        type:
          type: string
          enum:
            - coordinator
        agents:
          type: array
          items:
            anyOf:
              - $ref: '#/components/schemas/AgentId'
              - $ref: '#/components/schemas/BetaManagedAgentsAgentParams'
              - type: object
                properties:
                  type:
                    type: string
                    enum:
                      - self
                required:
                  - type
                additionalProperties: false
              - $ref: '#/components/schemas/Objects_14'
          allOf:
            - minItems: 1
            - maxItems: 20
      required:
        - type
        - agents
      additionalProperties: false
    Union_28:
      anyOf:
        - type: object
          properties:
            type:
              type: string
              enum:
                - anthropic
            skill_id:
              type: string
            version:
              anyOf:
                - type: string
                - type: 'null'
          required:
            - type
            - skill_id
          additionalProperties: false
        - type: object
          properties:
            type:
              type: string
              enum:
                - custom
            skill_id:
              type: string
            version:
              anyOf:
                - type: string
                - type: 'null'
          required:
            - type
            - skill_id
          additionalProperties: false
    Arrays_3:
      type: array
      items:
        $ref: '#/components/schemas/BetaManagedAgentsToolParams'
      allOf:
        - maxItems: 128
    BetaManagedAgentsWorkloadTrustParams:
      type: object
      properties:
        value:
          $ref: '#/components/schemas/WorkloadTrust'
      required:
        - value
      additionalProperties: false
    AgentId:
      type: string
      allOf:
        - pattern: ^agent_[0-9a-f]{32}$
    BetaManagedAgentsModelConfig:
      type: object
      properties:
        id:
          type: string
        effort:
          anyOf:
            - type: object
              properties:
                type:
                  type: string
                  enum:
                    - low
              required:
                - type
              additionalProperties: false
            - type: object
              properties:
                type:
                  type: string
                  enum:
                    - medium
              required:
                - type
              additionalProperties: false
            - type: object
              properties:
                type:
                  type: string
                  enum:
                    - high
              required:
                - type
              additionalProperties: false
            - type: object
              properties:
                type:
                  type: string
                  enum:
                    - xhigh
              required:
                - type
              additionalProperties: false
            - type: object
              properties:
                type:
                  type: string
                  enum:
                    - max
              required:
                - type
              additionalProperties: false
        inference_geo:
          type: string
          enum:
            - global
            - us
        speed:
          type: string
          enum:
            - standard
            - fast
      required:
        - id
      additionalProperties: false
    Union_31:
      anyOf:
        - type: string
        - type: 'null'
    Arrays_5:
      type: array
      items:
        $ref: '#/components/schemas/Objects_12'
    Union_32:
      anyOf:
        - type: object
          properties:
            type:
              type: string
              enum:
                - coordinator
            agents:
              type: array
              items:
                anyOf:
                  - type: object
                    properties:
                      type:
                        type: string
                        enum:
                          - agent
                      id:
                        $ref: '#/components/schemas/AgentId'
                      version:
                        type: integer
                        allOf:
                          - exclusiveMinimum: 0
                    required:
                      - type
                      - id
                      - version
                    additionalProperties: false
                  - $ref: '#/components/schemas/Objects_14'
          required:
            - type
            - agents
          additionalProperties: false
        - type: 'null'
    Arrays_6:
      type: array
      items:
        anyOf:
          - type: object
            properties:
              type:
                type: string
                enum:
                  - anthropic
              skill_id:
                type: string
              version:
                type: string
            required:
              - type
              - skill_id
              - version
            additionalProperties: false
          - type: object
            properties:
              type:
                type: string
                enum:
                  - custom
              skill_id:
                type: string
              version:
                type: string
            required:
              - type
              - skill_id
              - version
            additionalProperties: false
    Union_33:
      anyOf:
        - type: string
        - type: 'null'
    Arrays_7:
      type: array
      items:
        $ref: '#/components/schemas/BetaManagedAgentsTool'
    BetaManagedAgentsWorkloadTrust:
      type: object
      properties:
        declaration:
          $ref: '#/components/schemas/Union_34'
        facts:
          $ref: '#/components/schemas/WorkloadTrustFacts'
        effective:
          $ref: '#/components/schemas/WorkloadTrust'
      required:
        - declaration
        - facts
        - effective
      additionalProperties: false
    ValidationIdempotencyConflictError:
      type: object
      properties:
        error:
          type: object
          properties:
            type:
              type: string
              enum:
                - validation.idempotency_conflict
            message:
              type: string
            more:
              type: string
              enum:
                - >-
                  https://docs.checkfu.com/reference/errors#validation-idempotency-conflict
              description: Stable public documentation and remedy for this error type.
          required:
            - type
            - message
            - more
          additionalProperties: false
      required:
        - error
      additionalProperties: false
      description: The Idempotency-Key is already bound to a different request.
    ValidationIdempotencyInProgressError:
      type: object
      properties:
        error:
          type: object
          properties:
            type:
              type: string
              enum:
                - validation.idempotency_in_progress
            message:
              type: string
            more:
              type: string
              enum:
                - >-
                  https://docs.checkfu.com/reference/errors#validation-idempotency-in-progress
              description: Stable public documentation and remedy for this error type.
          required:
            - type
            - message
            - more
          additionalProperties: false
      required:
        - error
      additionalProperties: false
      description: >-
        An identical idempotent request is still in progress and may be retried
        later.
    Union_24:
      anyOf:
        - type: object
          properties:
            type:
              type: string
              enum:
                - low
          required:
            - type
          additionalProperties: false
        - type: object
          properties:
            type:
              type: string
              enum:
                - medium
          required:
            - type
          additionalProperties: false
        - type: object
          properties:
            type:
              type: string
              enum:
                - high
          required:
            - type
          additionalProperties: false
        - type: object
          properties:
            type:
              type: string
              enum:
                - xhigh
          required:
            - type
          additionalProperties: false
        - type: object
          properties:
            type:
              type: string
              enum:
                - max
          required:
            - type
          additionalProperties: false
    Union_11:
      type: string
      enum:
        - global
        - us
    Objects_12:
      type: object
      properties:
        type:
          type: string
          enum:
            - url
        name:
          type: string
          allOf:
            - minLength: 1
            - maxLength: 255
        url:
          type: string
          allOf:
            - minLength: 1
            - maxLength: 2048
      required:
        - type
        - name
        - url
      additionalProperties: false
    BetaManagedAgentsAgentParams:
      type: object
      properties:
        type:
          type: string
          enum:
            - agent
        id:
          $ref: '#/components/schemas/AgentId'
        version:
          type: integer
          allOf:
            - exclusiveMinimum: 0
      required:
        - type
        - id
      additionalProperties: false
    Objects_14:
      type: object
      properties:
        type:
          type: string
          enum:
            - advisor
        model:
          type: string
      required:
        - type
        - model
      additionalProperties: false
    BetaManagedAgentsToolParams:
      anyOf:
        - type: object
          properties:
            type:
              type: string
              enum:
                - agent_toolset_20260401
            configs:
              type: array
              items:
                $ref: '#/components/schemas/BetaManagedAgentsAgentToolConfigParams'
            default_config:
              anyOf:
                - $ref: '#/components/schemas/Objects_16'
                - type: 'null'
          required:
            - type
          additionalProperties: false
        - type: object
          properties:
            type:
              type: string
              enum:
                - mcp_toolset
            mcp_server_name:
              type: string
              allOf:
                - minLength: 1
                - maxLength: 255
            configs:
              type: array
              items:
                type: object
                properties:
                  name:
                    type: string
                    allOf:
                      - minLength: 1
                      - maxLength: 128
                  enabled:
                    type: boolean
                  permission_policy:
                    $ref: '#/components/schemas/BetaManagedAgentsPermissionPolicy'
                required:
                  - name
                additionalProperties: false
            default_config:
              anyOf:
                - $ref: '#/components/schemas/Objects_16'
                - type: 'null'
          required:
            - type
            - mcp_server_name
          additionalProperties: false
        - $ref: '#/components/schemas/Objects_17'
    WorkloadTrust:
      type: string
      enum:
        - trusted
        - adversarial
    BetaManagedAgentsTool:
      anyOf:
        - type: object
          properties:
            type:
              type: string
              enum:
                - agent_toolset_20260401
            configs:
              type: array
              items:
                anyOf:
                  - type: object
                    properties:
                      name:
                        type: string
                        enum:
                          - bash
                      type:
                        type: string
                        enum:
                          - bash
                      enabled:
                        type: boolean
                      permission_policy:
                        $ref: '#/components/schemas/BetaManagedAgentsPermissionPolicy'
                    required:
                      - name
                      - type
                      - enabled
                      - permission_policy
                    additionalProperties: false
                  - type: object
                    properties:
                      name:
                        type: string
                        enum:
                          - edit
                      type:
                        type: string
                        enum:
                          - edit
                      enabled:
                        type: boolean
                      permission_policy:
                        $ref: '#/components/schemas/BetaManagedAgentsPermissionPolicy'
                    required:
                      - name
                      - type
                      - enabled
                      - permission_policy
                    additionalProperties: false
                  - type: object
                    properties:
                      name:
                        type: string
                        enum:
                          - glob
                      type:
                        type: string
                        enum:
                          - glob
                      enabled:
                        type: boolean
                      permission_policy:
                        $ref: '#/components/schemas/BetaManagedAgentsPermissionPolicy'
                    required:
                      - name
                      - type
                      - enabled
                      - permission_policy
                    additionalProperties: false
                  - type: object
                    properties:
                      name:
                        type: string
                        enum:
                          - grep
                      type:
                        type: string
                        enum:
                          - grep
                      enabled:
                        type: boolean
                      permission_policy:
                        $ref: '#/components/schemas/BetaManagedAgentsPermissionPolicy'
                    required:
                      - name
                      - type
                      - enabled
                      - permission_policy
                    additionalProperties: false
                  - type: object
                    properties:
                      name:
                        type: string
                        enum:
                          - read
                      type:
                        type: string
                        enum:
                          - read
                      enabled:
                        type: boolean
                      permission_policy:
                        $ref: '#/components/schemas/BetaManagedAgentsPermissionPolicy'
                    required:
                      - name
                      - type
                      - enabled
                      - permission_policy
                    additionalProperties: false
                  - type: object
                    properties:
                      name:
                        type: string
                        enum:
                          - web_fetch
                      type:
                        type: string
                        enum:
                          - web_fetch
                      enabled:
                        type: boolean
                      permission_policy:
                        $ref: '#/components/schemas/BetaManagedAgentsPermissionPolicy'
                      allowed_domains:
                        $ref: '#/components/schemas/Arrays_4'
                      blocked_domains:
                        $ref: '#/components/schemas/Arrays_4'
                      max_content_tokens:
                        anyOf:
                          - type: integer
                            allOf:
                              - exclusiveMinimum: 0
                          - type: 'null'
                    required:
                      - name
                      - type
                      - enabled
                      - permission_policy
                    additionalProperties: false
                  - type: object
                    properties:
                      name:
                        type: string
                        enum:
                          - web_search
                      type:
                        type: string
                        enum:
                          - web_search
                      enabled:
                        type: boolean
                      permission_policy:
                        $ref: '#/components/schemas/BetaManagedAgentsPermissionPolicy'
                      allowed_domains:
                        $ref: '#/components/schemas/Arrays_4'
                      blocked_domains:
                        $ref: '#/components/schemas/Arrays_4'
                      user_location:
                        anyOf:
                          - $ref: '#/components/schemas/Objects_15'
                          - type: 'null'
                    required:
                      - name
                      - type
                      - enabled
                      - permission_policy
                    additionalProperties: false
                  - type: object
                    properties:
                      name:
                        type: string
                        enum:
                          - write
                      type:
                        type: string
                        enum:
                          - write
                      enabled:
                        type: boolean
                      permission_policy:
                        $ref: '#/components/schemas/BetaManagedAgentsPermissionPolicy'
                    required:
                      - name
                      - type
                      - enabled
                      - permission_policy
                    additionalProperties: false
            default_config:
              $ref: '#/components/schemas/Objects_18'
          required:
            - type
            - configs
            - default_config
          additionalProperties: false
        - type: object
          properties:
            type:
              type: string
              enum:
                - mcp_toolset
            mcp_server_name:
              type: string
              allOf:
                - minLength: 1
                - maxLength: 255
            configs:
              type: array
              items:
                type: object
                properties:
                  name:
                    type: string
                  enabled:
                    type: boolean
                  permission_policy:
                    $ref: '#/components/schemas/BetaManagedAgentsPermissionPolicy'
                required:
                  - name
                  - enabled
                  - permission_policy
                additionalProperties: false
            default_config:
              $ref: '#/components/schemas/Objects_18'
          required:
            - type
            - mcp_server_name
            - configs
            - default_config
          additionalProperties: false
        - $ref: '#/components/schemas/Objects_17'
    Union_34:
      anyOf:
        - type: object
          properties:
            value:
              $ref: '#/components/schemas/WorkloadTrust'
            recorded_at:
              $ref: '#/components/schemas/CurrentTimestamp'
          required:
            - value
            - recorded_at
          additionalProperties: false
        - type: 'null'
    WorkloadTrustFacts:
      type: object
      properties:
        authorship:
          type: string
          enum:
            - organization_engineer
            - end_user
            - third_party
            - unknown
        source_review:
          type: string
          enum:
            - workspace_controlled
            - unreviewed
            - unknown
        execution_plane:
          type: string
          enum:
            - organization_local
            - organization_single_tenant
            - shared_or_third_party
            - unknown
        input_exposure:
          type: object
          properties:
            source_build:
              $ref: '#/components/schemas/WorkloadInputControl'
            ingress:
              $ref: '#/components/schemas/WorkloadInputControl'
            mounts:
              $ref: '#/components/schemas/WorkloadInputControl'
            installations:
              $ref: '#/components/schemas/WorkloadInputControl'
            content_capabilities:
              $ref: '#/components/schemas/WorkloadInputControl'
          required:
            - source_build
            - ingress
            - mounts
            - installations
            - content_capabilities
          additionalProperties: false
      required:
        - authorship
        - source_review
        - execution_plane
        - input_exposure
      additionalProperties: false
    BetaManagedAgentsAgentToolConfigParams:
      anyOf:
        - type: object
          properties:
            name:
              type: string
              enum:
                - bash
            type:
              type: string
              enum:
                - bash
            enabled:
              anyOf:
                - type: boolean
                - type: 'null'
            permission_policy:
              anyOf:
                - $ref: '#/components/schemas/BetaManagedAgentsPermissionPolicy'
                - type: 'null'
          required:
            - name
          additionalProperties: false
        - type: object
          properties:
            name:
              type: string
              enum:
                - edit
            type:
              type: string
              enum:
                - edit
            enabled:
              anyOf:
                - type: boolean
                - type: 'null'
            permission_policy:
              anyOf:
                - $ref: '#/components/schemas/BetaManagedAgentsPermissionPolicy'
                - type: 'null'
          required:
            - name
          additionalProperties: false
        - type: object
          properties:
            name:
              type: string
              enum:
                - glob
            type:
              type: string
              enum:
                - glob
            enabled:
              anyOf:
                - type: boolean
                - type: 'null'
            permission_policy:
              anyOf:
                - $ref: '#/components/schemas/BetaManagedAgentsPermissionPolicy'
                - type: 'null'
          required:
            - name
          additionalProperties: false
        - type: object
          properties:
            name:
              type: string
              enum:
                - grep
            type:
              type: string
              enum:
                - grep
            enabled:
              anyOf:
                - type: boolean
                - type: 'null'
            permission_policy:
              anyOf:
                - $ref: '#/components/schemas/BetaManagedAgentsPermissionPolicy'
                - type: 'null'
          required:
            - name
          additionalProperties: false
        - type: object
          properties:
            name:
              type: string
              enum:
                - read
            type:
              type: string
              enum:
                - read
            enabled:
              anyOf:
                - type: boolean
                - type: 'null'
            permission_policy:
              anyOf:
                - $ref: '#/components/schemas/BetaManagedAgentsPermissionPolicy'
                - type: 'null'
          required:
            - name
          additionalProperties: false
        - type: object
          properties:
            name:
              type: string
              enum:
                - web_fetch
            type:
              type: string
              enum:
                - web_fetch
            enabled:
              anyOf:
                - type: boolean
                - type: 'null'
            permission_policy:
              anyOf:
                - $ref: '#/components/schemas/BetaManagedAgentsPermissionPolicy'
                - type: 'null'
            allowed_domains:
              $ref: '#/components/schemas/Arrays_4'
            blocked_domains:
              $ref: '#/components/schemas/Arrays_4'
            max_content_tokens:
              anyOf:
                - type: integer
                  allOf:
                    - exclusiveMinimum: 0
                - type: 'null'
          required:
            - name
          additionalProperties: false
        - type: object
          properties:
            name:
              type: string
              enum:
                - web_search
            type:
              type: string
              enum:
                - web_search
            enabled:
              anyOf:
                - type: boolean
                - type: 'null'
            permission_policy:
              anyOf:
                - $ref: '#/components/schemas/BetaManagedAgentsPermissionPolicy'
                - type: 'null'
            allowed_domains:
              $ref: '#/components/schemas/Arrays_4'
            blocked_domains:
              $ref: '#/components/schemas/Arrays_4'
            user_location:
              anyOf:
                - $ref: '#/components/schemas/Objects_15'
                - type: 'null'
          required:
            - name
          additionalProperties: false
        - type: object
          properties:
            name:
              type: string
              enum:
                - write
            type:
              type: string
              enum:
                - write
            enabled:
              anyOf:
                - type: boolean
                - type: 'null'
            permission_policy:
              anyOf:
                - $ref: '#/components/schemas/BetaManagedAgentsPermissionPolicy'
                - type: 'null'
          required:
            - name
          additionalProperties: false
    Objects_16:
      type: object
      properties:
        enabled:
          anyOf:
            - type: boolean
            - type: 'null'
        permission_policy:
          anyOf:
            - $ref: '#/components/schemas/BetaManagedAgentsPermissionPolicy'
            - type: 'null'
      additionalProperties: false
    BetaManagedAgentsPermissionPolicy:
      anyOf:
        - type: object
          properties:
            type:
              type: string
              enum:
                - always_allow
          required:
            - type
          additionalProperties: false
        - type: object
          properties:
            type:
              type: string
              enum:
                - always_ask
          required:
            - type
          additionalProperties: false
    Objects_17:
      type: object
      properties:
        type:
          type: string
          enum:
            - custom
        name:
          type: string
          allOf:
            - minLength: 1
            - maxLength: 128
            - pattern: ^[A-Za-z0-9_-]+$
        description:
          type: string
          allOf:
            - minLength: 1
        input_schema:
          $ref: '#/components/schemas/BetaManagedAgentsCustomToolInputSchema'
      required:
        - type
        - name
        - description
        - input_schema
      additionalProperties: false
    Arrays_4:
      type: array
      items:
        type: string
        allOf:
          - minLength: 1
          - maxLength: 255
      allOf:
        - minItems: 1
        - maxItems: 64
    Objects_15:
      type: object
      properties:
        type:
          type: string
          enum:
            - approximate
        city:
          anyOf:
            - type: string
            - type: 'null'
        country:
          anyOf:
            - $ref: '#/components/schemas/BetaManagedAgentsIsoCountryCode'
            - type: 'null'
        region:
          anyOf:
            - type: string
            - type: 'null'
        timezone:
          anyOf:
            - $ref: '#/components/schemas/BetaManagedAgentsIanaTimeZone'
            - type: 'null'
      required:
        - type
      additionalProperties: false
    Objects_18:
      type: object
      properties:
        enabled:
          type: boolean
        permission_policy:
          $ref: '#/components/schemas/BetaManagedAgentsPermissionPolicy'
      required:
        - enabled
        - permission_policy
      additionalProperties: false
    CurrentTimestamp:
      type: string
      allOf:
        - maxLength: 24
        - pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$
          description: A canonical UTC ISO-8601 timestamp with millisecond precision.
    WorkloadInputControl:
      type: string
      enum:
        - controlled
        - third_party
        - unknown
    BetaManagedAgentsCustomToolInputSchema:
      type: object
      properties:
        type:
          type: string
          enum:
            - object
        properties:
          anyOf:
            - type: object
              additionalProperties:
                $ref: '#/components/schemas/JsonValue'
            - type: 'null'
        required:
          anyOf:
            - type: array
              items:
                type: string
            - type: 'null'
      required:
        - type
      additionalProperties:
        $ref: '#/components/schemas/JsonValue'
      description: JSON Schema for custom tool input parameters.
    BetaManagedAgentsIsoCountryCode:
      type: string
      allOf:
        - pattern: ^[A-Z]{2}$
    BetaManagedAgentsIanaTimeZone:
      type: string
      allOf:
        - minLength: 1
        - maxLength: 255
    JsonValue:
      description: >-
        A value in the JSON data model: null, boolean, finite number, string,
        array, or object.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````