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

# Unpause Deployment

> Unpause Deployment through the OMA API.

<Info>Every request requires `?beta=true`, `anthropic-version: 2023-06-01`, and `anthropic-beta: managed-agents-2026-04-01`.</Info>


## OpenAPI

````yaml /openapi/oma.en.json post /v1/deployments/{deployment_id}/unpause
openapi: 3.1.0
info:
  title: OMA API Reference
  version: 1.0.0
  description: Open Managed Agents application API reference.
servers:
  - url: http://localhost:38080
    description: Local OMA server
security:
  - omaApiKey: []
  - omaBearer: []
paths:
  /v1/deployments/{deployment_id}/unpause:
    post:
      summary: Unpause Deployment
      operationId: BetaUnpauseDeployment
      parameters:
        - name: beta
          in: query
          required: true
          description: Selects the beta API contract for this endpoint. Must be `true`.
          schema:
            type: boolean
            enum:
              - true
        - name: anthropic-version
          in: header
          required: true
          schema:
            type: string
            x-default: '2023-06-01'
        - name: anthropic-beta
          in: header
          required: true
          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'
            x-default: managed-agents-2026-04-01
        - name: deployment_id
          in: path
          required: true
          schema:
            type: string
          description: Path parameter deployment_id
          example: depl_011CZkZcDH3vPqd7xnEfwTai
      responses:
        '200':
          description: Successful response (OK)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaManagedAgentsDeployment'
        '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'
components:
  schemas:
    BetaManagedAgentsDeployment:
      description: >-
        A deployment is a configured instance of an agent — it binds the agent
        to everything needed to run it autonomously: an environment,
        credentials, initial events, and an optional schedule.
      type: object
      additionalProperties: false
      required:
        - type
        - id
        - name
        - description
        - agent
        - environment_id
        - vault_ids
        - initial_events
        - resources
        - metadata
        - schedule
        - status
        - paused_reason
        - created_at
        - updated_at
        - archived_at
      properties:
        type:
          type: string
          enum:
            - deployment
          examples:
            - deployment
        id:
          description: Unique identifier for this deployment.
          type: string
          examples:
            - depl_011CZkZcDH3vPqd7xnEfwTai
        name:
          description: Human-readable name.
          type: string
          examples:
            - Daily order report
        description:
          description: Description of what the deployment does.
          type: string
          nullable: true
          examples:
            - Compiles yesterday's orders into a report every weekday morning.
        agent:
          description: >-
            Reference to the agent this deployment runs, resolved to a concrete
            version.
          allOf:
            - $ref: '#/components/schemas/BetaManagedAgentsAgentReference'
          examples:
            - type: agent
              id: agent_011CZkYpogX7uDKUyvBTophP
              version: 1
        environment_id:
          description: ID of the `environment` where sessions run.
          type: string
          examples:
            - env_011CZkZ9X2dpNyB7HsEFoRfW
        vault_ids:
          description: >-
            Vault IDs supplying stored credentials for sessions created from
            this deployment.
          type: array
          items:
            type: string
          examples:
            - - vlt_011CZkZDLs7fYzm1hXNPeRjv
        initial_events:
          description: Events sent to each session immediately after creation.
          type: array
          items:
            $ref: '#/components/schemas/BetaManagedAgentsDeploymentInitialEvent'
          examples:
            - - type: user.message
                content:
                  - type: text
                    text: Compile yesterday's orders into report.md.
        resources:
          description: >-
            Resources attached to sessions created from this deployment. Echoes
            the input minus write-only credentials.
          type: array
          items:
            $ref: '#/components/schemas/BetaManagedAgentsSessionResourceConfig'
          examples:
            - []
        metadata:
          description: Arbitrary key-value metadata. Maximum 16 pairs.
          type: object
          additionalProperties:
            type: string
          examples:
            - {}
        schedule:
          description: >-
            Recurring cron schedule. Presence enables scheduled execution; null
            means manual-only. Includes computed timestamps (next fire times,
            last run) on the cron variant.
          allOf:
            - $ref: '#/components/schemas/BetaManagedAgentsSchedule'
          nullable: true
          examples:
            - type: cron
              expression: 0 9 * * 1-5
              timezone: America/Los_Angeles
              last_run_at: '2026-03-16T16:00:09Z'
              upcoming_runs_at:
                - '2026-03-17T16:00:00Z'
                - '2026-03-18T16:00:00Z'
        status:
          description: >-
            Computed status of the deployment: `active` or `paused`. Archived
            deployments report `active` with `archived_at` set.
          allOf:
            - $ref: '#/components/schemas/BetaManagedAgentsDeploymentStatus'
          examples:
            - active
        paused_reason:
          description: >-
            Why the deployment is paused. Non-null exactly when status is
            paused; null otherwise.
          allOf:
            - $ref: '#/components/schemas/BetaManagedAgentsDeploymentPausedReason'
          nullable: true
          examples:
            - null
        budget:
          description: >-
            Spend ceiling stamped onto each session created from this
            deployment. Absent when no budget is set.
          allOf:
            - $ref: '#/components/schemas/BetaManagedAgentsBudget'
          nullable: true
        created_at:
          description: Time the deployment was created.
          allOf:
            - $ref: '#/components/schemas/BetaTimestamp'
          examples:
            - '2026-03-15T10:00:00Z'
        updated_at:
          description: Time the deployment was last updated.
          allOf:
            - $ref: '#/components/schemas/BetaTimestamp'
          examples:
            - '2026-03-15T10:00:00Z'
        archived_at:
          description: Time the deployment was archived. Null if not archived.
          allOf:
            - $ref: '#/components/schemas/BetaTimestamp'
          nullable: true
          examples:
            - null
      example:
        type: deployment
        id: depl_011CZkZcDH3vPqd7xnEfwTai
        name: Daily order report
        description: Compiles yesterday's orders into a report every weekday morning.
        agent:
          type: agent
          id: agent_011CZkYpogX7uDKUyvBTophP
          version: 1
        environment_id: env_011CZkZ9X2dpNyB7HsEFoRfW
        vault_ids:
          - vlt_011CZkZDLs7fYzm1hXNPeRjv
        initial_events:
          - type: user.message
            content:
              - type: text
                text: Compile yesterday's orders into report.md.
        resources: []
        metadata: {}
        schedule:
          type: cron
          expression: 0 9 * * 1-5
          timezone: America/Los_Angeles
          last_run_at: '2026-03-16T16:00:09Z'
          upcoming_runs_at:
            - '2026-03-17T16:00:00Z'
            - '2026-03-18T16:00:00Z'
        status: active
        paused_reason: null
        created_at: '2026-03-15T10:00:00Z'
        updated_at: '2026-03-15T10:00:00Z'
        archived_at: null
    BetaErrorResponse:
      properties:
        error:
          discriminator:
            mapping:
              api_error:
                $ref: '#/components/schemas/BetaAPIError'
              authentication_error:
                $ref: '#/components/schemas/BetaAuthenticationError'
              billing_error:
                $ref: '#/components/schemas/BetaBillingError'
              invalid_request_error:
                $ref: '#/components/schemas/BetaInvalidRequestError'
              not_found_error:
                $ref: '#/components/schemas/BetaNotFoundError'
              overloaded_error:
                $ref: '#/components/schemas/BetaOverloadedError'
              permission_error:
                $ref: '#/components/schemas/BetaPermissionError'
              rate_limit_error:
                $ref: '#/components/schemas/BetaRateLimitError'
              timeout_error:
                $ref: '#/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
    BetaManagedAgentsAgentReference:
      description: A resolved agent reference with a concrete version.
      type: object
      additionalProperties: false
      required:
        - id
        - type
        - version
      properties:
        id:
          type: string
          examples:
            - agent_011CZkYqphY8vELVzwCUpqiQ
        type:
          type: string
          enum:
            - agent
          examples:
            - agent
        version:
          type: integer
          format: int32
          examples:
            - 1
      example:
        type: agent
        id: agent_011CZkYqphY8vELVzwCUpqiQ
        version: 1
    BetaManagedAgentsDeploymentInitialEvent:
      description: >-
        An event sent to a session immediately after it is created. Supports
        `user.message`, `user.define_outcome`, and `system.message`.
      type: object
      discriminator:
        propertyName: type
        mapping:
          user.message:
            $ref: '#/components/schemas/BetaManagedAgentsDeploymentUserMessageEvent'
          user.define_outcome:
            $ref: >-
              #/components/schemas/BetaManagedAgentsDeploymentUserDefineOutcomeEvent
          system.message:
            $ref: '#/components/schemas/BetaManagedAgentsDeploymentSystemMessageEvent'
      oneOf:
        - $ref: '#/components/schemas/BetaManagedAgentsDeploymentUserMessageEvent'
        - $ref: >-
            #/components/schemas/BetaManagedAgentsDeploymentUserDefineOutcomeEvent
        - $ref: '#/components/schemas/BetaManagedAgentsDeploymentSystemMessageEvent'
    BetaManagedAgentsSessionResourceConfig:
      description: >-
        A configured session resource. Echoes the input minus write-only
        credentials.
      type: object
      discriminator:
        propertyName: type
        mapping:
          github_repository:
            $ref: >-
              #/components/schemas/BetaManagedAgentsGitHubRepositoryResourceConfig
          file:
            $ref: '#/components/schemas/BetaManagedAgentsFileResourceConfig'
          memory_store:
            $ref: '#/components/schemas/BetaManagedAgentsMemoryStoreResourceConfig'
      oneOf:
        - $ref: '#/components/schemas/BetaManagedAgentsGitHubRepositoryResourceConfig'
        - $ref: '#/components/schemas/BetaManagedAgentsFileResourceConfig'
        - $ref: '#/components/schemas/BetaManagedAgentsMemoryStoreResourceConfig'
    BetaManagedAgentsSchedule:
      description: >-
        A recurring schedule with computed runtime timestamps. Discriminated
        union — only cron is supported currently.
      type: object
      discriminator:
        propertyName: type
        mapping:
          cron:
            $ref: '#/components/schemas/BetaManagedAgentsCronSchedule'
      oneOf:
        - $ref: '#/components/schemas/BetaManagedAgentsCronSchedule'
    BetaManagedAgentsDeploymentStatus:
      type: string
      description: Lifecycle status of a deployment.
      enum:
        - active
        - paused
    BetaManagedAgentsDeploymentPausedReason:
      description: Why a deployment is paused. Non-null exactly when `status` is `paused`.
      type: object
      discriminator:
        propertyName: type
        mapping:
          manual:
            $ref: '#/components/schemas/BetaManagedAgentsManualDeploymentPausedReason'
          error:
            $ref: '#/components/schemas/BetaManagedAgentsErrorDeploymentPausedReason'
      oneOf:
        - $ref: '#/components/schemas/BetaManagedAgentsManualDeploymentPausedReason'
        - $ref: '#/components/schemas/BetaManagedAgentsErrorDeploymentPausedReason'
    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:
            $ref: '#/components/schemas/BetaManagedAgentsBudgetLimit'
      oneOf:
        - $ref: '#/components/schemas/BetaManagedAgentsBudgetLimit'
    BetaTimestamp:
      description: A timestamp in RFC 3339 format
      type: string
      format: date-time
    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
    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
    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
    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
    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
    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
    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
    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
    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
    BetaManagedAgentsDeploymentUserMessageEvent:
      description: A user message sent to the session.
      type: object
      additionalProperties: false
      required:
        - type
        - content
      properties:
        type:
          type: string
          enum:
            - user.message
        content:
          description: Array of content blocks for the user message.
          type: array
          items:
            $ref: '#/components/schemas/BetaManagedAgentsUserContentBlock'
    BetaManagedAgentsDeploymentUserDefineOutcomeEvent:
      description: >-
        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
        description:
          description: What the agent should produce. This is the task specification.
          type: string
        rubric:
          description: How to grade the outcome. Text or file reference.
          allOf:
            - $ref: '#/components/schemas/BetaManagedAgentsRubric'
        max_iterations:
          description: Eval→revision cycles before giving up. Default 3, max 20.
          type: integer
          format: int32
          nullable: true
    BetaManagedAgentsDeploymentSystemMessageEvent:
      description: >-
        Privileged context for the accompanying turn and all subsequent turns,
        appended to the session's system context as a `role: "system"` turn
        rather than replacing the top-level system prompt.
      type: object
      additionalProperties: false
      required:
        - type
        - content
      properties:
        type:
          type: string
          enum:
            - system.message
        content:
          description: System content blocks to append. Text-only.
          type: array
          items:
            $ref: '#/components/schemas/BetaManagedAgentsSystemContentBlock'
    BetaManagedAgentsGitHubRepositoryResourceConfig:
      description: >-
        A GitHub repository mounted into each session's container. The
        authorization token is write-only and never returned.
      type: object
      additionalProperties: false
      required:
        - type
        - url
      properties:
        type:
          type: string
          enum:
            - github_repository
        url:
          description: Github URL of the repository
          type: string
        mount_path:
          description: Mount path in the container. Defaults to `/workspace/<repo-name>`.
          type: string
          nullable: true
        checkout:
          description: >-
            Branch or commit to check out. Defaults to the repository's default
            branch.
          allOf:
            - $ref: '#/components/schemas/BetaManagedAgentsRepositoryCheckout'
          nullable: true
    BetaManagedAgentsFileResourceConfig:
      description: A file mounted into each session's container.
      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
        mount_path:
          description: >-
            Mount path in the container. Defaults to
            `/mnt/session/uploads/<file_id>`.
          type: string
          nullable: true
    BetaManagedAgentsMemoryStoreResourceConfig:
      description: A memory store attached to each session created from this deployment.
      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.
          allOf:
            - $ref: '#/components/schemas/BetaManagedAgentsMountMode'
          nullable: true
        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.
          type: string
          nullable: true
    BetaManagedAgentsCronSchedule:
      description: 5-field POSIX cron schedule with computed runtime timestamps.
      type: object
      additionalProperties: false
      required:
        - type
        - expression
        - timezone
      properties:
        type:
          type: string
          enum:
            - cron
          examples:
            - cron
        expression:
          description: >-
            5-field POSIX cron expression: minute hour day-of-month month
            day-of-week (e.g., "0 9 * * 1-5" for weekdays at 9am). Day-of-week
            is 0-7 where 0 and 7 both mean Sunday. Extended cron syntax -
            seconds or year fields, and the special characters L, W, #, and ? -
            is not supported, nor are predefined shortcuts (@daily).
          type: string
          minLength: 1
          maxLength: 256
          examples:
            - 0 9 * * 1-5
        timezone:
          description: IANA timezone identifier (e.g., "America/Los_Angeles", "UTC").
          type: string
          minLength: 1
          examples:
            - America/Los_Angeles
        last_run_at:
          description: >-
            Time the most recent scheduled run actually started. Null until one
            completes; preserved after the deployment is archived. Manual runs
            do not update this.
          allOf:
            - $ref: '#/components/schemas/BetaTimestamp'
          nullable: true
          examples:
            - '2026-03-16T16:00:09Z'
        upcoming_runs_at:
          description: >-
            Up to 5 timestamps of upcoming cron occurrences. Non-empty for
            active and paused deployments (reflects what the schedule would do
            if unpaused); empty once the deployment is archived (`archived_at`
            set). Each fire is offset by a small per-schedule jitter, so a run
            will actually start at or shortly after its listed time.
          type: array
          items:
            $ref: '#/components/schemas/BetaTimestamp'
          examples:
            - - '2026-03-17T16:00:00Z'
              - '2026-03-18T16:00:00Z'
      example:
        type: cron
        expression: 0 9 * * 1-5
        timezone: America/Los_Angeles
        last_run_at: '2026-03-16T16:00:09Z'
        upcoming_runs_at:
          - '2026-03-17T16:00:00Z'
          - '2026-03-18T16:00:00Z'
    BetaManagedAgentsManualDeploymentPausedReason:
      description: The caller invoked the pause endpoint on the deployment.
      type: object
      additionalProperties: false
      required:
        - type
      properties:
        type:
          type: string
          enum:
            - manual
    BetaManagedAgentsErrorDeploymentPausedReason:
      description: >-
        A scheduled fire recorded a failed run whose error auto-pauses the
        deployment.
      type: object
      additionalProperties: false
      required:
        - type
        - error
      properties:
        type:
          type: string
          enum:
            - error
        error:
          description: The failed run's error.
          allOf:
            - $ref: >-
                #/components/schemas/BetaManagedAgentsDeploymentPausedReasonError
    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'
    BetaManagedAgentsUserContentBlock:
      description: Content block in a user message. Can be `text`, `image`, or `document`.
      type: object
      discriminator:
        propertyName: type
        mapping:
          text:
            $ref: '#/components/schemas/BetaManagedAgentsTextBlock'
          image:
            $ref: '#/components/schemas/BetaManagedAgentsImageBlock'
          document:
            $ref: '#/components/schemas/BetaManagedAgentsDocumentBlock'
          redacted:
            $ref: '#/components/schemas/BetaManagedAgentsRedactedBlock'
      oneOf:
        - $ref: '#/components/schemas/BetaManagedAgentsTextBlock'
        - $ref: '#/components/schemas/BetaManagedAgentsImageBlock'
        - $ref: '#/components/schemas/BetaManagedAgentsDocumentBlock'
        - $ref: '#/components/schemas/BetaManagedAgentsRedactedBlock'
    BetaManagedAgentsRubric:
      description: Rubric for grading the quality of an outcome.
      discriminator:
        propertyName: type
        mapping:
          file:
            $ref: '#/components/schemas/BetaManagedAgentsFileRubric'
          text:
            $ref: '#/components/schemas/BetaManagedAgentsTextRubric'
      oneOf:
        - $ref: '#/components/schemas/BetaManagedAgentsFileRubric'
        - $ref: '#/components/schemas/BetaManagedAgentsTextRubric'
    BetaManagedAgentsSystemContentBlock:
      description: Content block in a mid-conversation system message. Text-only.
      type: object
      discriminator:
        propertyName: type
        mapping:
          text:
            $ref: '#/components/schemas/BetaManagedAgentsTextBlock'
      oneOf:
        - $ref: '#/components/schemas/BetaManagedAgentsTextBlock'
    BetaManagedAgentsRepositoryCheckout:
      type: object
      discriminator:
        propertyName: type
        mapping:
          branch:
            $ref: '#/components/schemas/BetaManagedAgentsBranchCheckout'
          commit:
            $ref: '#/components/schemas/BetaManagedAgentsCommitCheckout'
      oneOf:
        - $ref: '#/components/schemas/BetaManagedAgentsBranchCheckout'
        - $ref: '#/components/schemas/BetaManagedAgentsCommitCheckout'
    BetaManagedAgentsMountMode:
      type: string
      description: Access mode for an attached memory store.
      enum:
        - read_write
        - read_only
    BetaManagedAgentsDeploymentPausedReasonError:
      description: >-
        The error that triggered an auto-pause. Matches the failed run's
        `error.type`.
      type: object
      discriminator:
        propertyName: type
        mapping:
          environment_archived_error:
            $ref: >-
              #/components/schemas/BetaManagedAgentsEnvironmentArchivedDeploymentPausedReasonError
          agent_archived_error:
            $ref: >-
              #/components/schemas/BetaManagedAgentsAgentArchivedDeploymentPausedReasonError
          environment_not_found_error:
            $ref: >-
              #/components/schemas/BetaManagedAgentsEnvironmentNotFoundDeploymentPausedReasonError
          vault_not_found_error:
            $ref: >-
              #/components/schemas/BetaManagedAgentsVaultNotFoundDeploymentPausedReasonError
          file_not_found_error:
            $ref: >-
              #/components/schemas/BetaManagedAgentsFileNotFoundDeploymentPausedReasonError
          session_resource_not_found_error:
            $ref: >-
              #/components/schemas/BetaManagedAgentsSessionResourceNotFoundDeploymentPausedReasonError
          workspace_archived_error:
            $ref: >-
              #/components/schemas/BetaManagedAgentsWorkspaceArchivedDeploymentPausedReasonError
          organization_disabled_error:
            $ref: >-
              #/components/schemas/BetaManagedAgentsOrganizationDisabledDeploymentPausedReasonError
          memory_store_archived_error:
            $ref: >-
              #/components/schemas/BetaManagedAgentsMemoryStoreArchivedDeploymentPausedReasonError
          skill_not_found_error:
            $ref: >-
              #/components/schemas/BetaManagedAgentsSkillNotFoundDeploymentPausedReasonError
          vault_archived_error:
            $ref: >-
              #/components/schemas/BetaManagedAgentsVaultArchivedDeploymentPausedReasonError
          unknown_error:
            $ref: >-
              #/components/schemas/BetaManagedAgentsUnknownDeploymentPausedReasonError
          self_hosted_resources_unsupported_error:
            $ref: >-
              #/components/schemas/BetaManagedAgentsSelfHostedResourcesUnsupportedDeploymentPausedReasonError
          mcp_egress_blocked_error:
            $ref: >-
              #/components/schemas/BetaManagedAgentsMcpEgressBlockedDeploymentPausedReasonError
      oneOf:
        - $ref: >-
            #/components/schemas/BetaManagedAgentsEnvironmentArchivedDeploymentPausedReasonError
        - $ref: >-
            #/components/schemas/BetaManagedAgentsAgentArchivedDeploymentPausedReasonError
        - $ref: >-
            #/components/schemas/BetaManagedAgentsEnvironmentNotFoundDeploymentPausedReasonError
        - $ref: >-
            #/components/schemas/BetaManagedAgentsVaultNotFoundDeploymentPausedReasonError
        - $ref: >-
            #/components/schemas/BetaManagedAgentsFileNotFoundDeploymentPausedReasonError
        - $ref: >-
            #/components/schemas/BetaManagedAgentsSessionResourceNotFoundDeploymentPausedReasonError
        - $ref: >-
            #/components/schemas/BetaManagedAgentsWorkspaceArchivedDeploymentPausedReasonError
        - $ref: >-
            #/components/schemas/BetaManagedAgentsOrganizationDisabledDeploymentPausedReasonError
        - $ref: >-
            #/components/schemas/BetaManagedAgentsMemoryStoreArchivedDeploymentPausedReasonError
        - $ref: >-
            #/components/schemas/BetaManagedAgentsSkillNotFoundDeploymentPausedReasonError
        - $ref: >-
            #/components/schemas/BetaManagedAgentsVaultArchivedDeploymentPausedReasonError
        - $ref: >-
            #/components/schemas/BetaManagedAgentsUnknownDeploymentPausedReasonError
        - $ref: >-
            #/components/schemas/BetaManagedAgentsSelfHostedResourcesUnsupportedDeploymentPausedReasonError
        - $ref: >-
            #/components/schemas/BetaManagedAgentsMcpEgressBlockedDeploymentPausedReasonError
    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'
    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?'
    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'
    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.
          type: string
          nullable: true
        context:
          description: Additional context about the document for the model.
          type: string
          nullable: true
    BetaManagedAgentsRedactedBlock:
      description: Placeholder for content withheld by OMA model policy.
      type: object
      additionalProperties: false
      required:
        - type
      properties:
        type:
          type: string
          enum:
            - redacted
    BetaManagedAgentsFileRubric:
      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
        file_id:
          description: ID of the rubric file.
          type: string
    BetaManagedAgentsTextRubric:
      description: Rubric content provided inline as text.
      type: object
      additionalProperties: false
      required:
        - type
        - content
      properties:
        type:
          type: string
          enum:
            - text
        content:
          description: >-
            Rubric content. Plain text or markdown — the grader treats it as
            freeform text.
          type: string
    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
    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
    BetaManagedAgentsEnvironmentArchivedDeploymentPausedReasonError:
      description: The deployment's environment was archived.
      type: object
      additionalProperties: false
      required:
        - type
      properties:
        type:
          type: string
          enum:
            - environment_archived_error
    BetaManagedAgentsAgentArchivedDeploymentPausedReasonError:
      description: The deployment's agent was archived.
      type: object
      additionalProperties: false
      required:
        - type
      properties:
        type:
          type: string
          enum:
            - agent_archived_error
    BetaManagedAgentsEnvironmentNotFoundDeploymentPausedReasonError:
      description: The deployment's environment no longer exists.
      type: object
      additionalProperties: false
      required:
        - type
      properties:
        type:
          type: string
          enum:
            - environment_not_found_error
    BetaManagedAgentsVaultNotFoundDeploymentPausedReasonError:
      description: A vault referenced by the deployment no longer exists.
      type: object
      additionalProperties: false
      required:
        - type
      properties:
        type:
          type: string
          enum:
            - vault_not_found_error
    BetaManagedAgentsFileNotFoundDeploymentPausedReasonError:
      description: A file resource referenced by the deployment no longer exists.
      type: object
      additionalProperties: false
      required:
        - type
      properties:
        type:
          type: string
          enum:
            - file_not_found_error
    BetaManagedAgentsSessionResourceNotFoundDeploymentPausedReasonError:
      description: A referenced resource no longer exists and its kind was not reported.
      type: object
      additionalProperties: false
      required:
        - type
      properties:
        type:
          type: string
          enum:
            - session_resource_not_found_error
    BetaManagedAgentsWorkspaceArchivedDeploymentPausedReasonError:
      description: The deployment's workspace was archived.
      type: object
      additionalProperties: false
      required:
        - type
      properties:
        type:
          type: string
          enum:
            - workspace_archived_error
    BetaManagedAgentsOrganizationDisabledDeploymentPausedReasonError:
      description: The deployment's organization is disabled.
      type: object
      additionalProperties: false
      required:
        - type
      properties:
        type:
          type: string
          enum:
            - organization_disabled_error
    BetaManagedAgentsMemoryStoreArchivedDeploymentPausedReasonError:
      description: A memory store referenced by the deployment is archived.
      type: object
      additionalProperties: false
      required:
        - type
      properties:
        type:
          type: string
          enum:
            - memory_store_archived_error
    BetaManagedAgentsSkillNotFoundDeploymentPausedReasonError:
      description: A skill referenced by the deployment's agent no longer exists.
      type: object
      additionalProperties: false
      required:
        - type
      properties:
        type:
          type: string
          enum:
            - skill_not_found_error
    BetaManagedAgentsVaultArchivedDeploymentPausedReasonError:
      description: A vault referenced by the deployment is archived.
      type: object
      additionalProperties: false
      required:
        - type
      properties:
        type:
          type: string
          enum:
            - vault_archived_error
    BetaManagedAgentsUnknownDeploymentPausedReasonError:
      description: >-
        An unrecognized error auto-paused the deployment. A fallback variant;
        matches a run whose `error.type` is `unknown_error`.
      type: object
      additionalProperties: false
      required:
        - type
      properties:
        type:
          type: string
          enum:
            - unknown_error
    BetaManagedAgentsSelfHostedResourcesUnsupportedDeploymentPausedReasonError:
      description: >-
        The deployment configures resources, but its environment is self-hosted
        and cannot mount them.
      type: object
      additionalProperties: false
      required:
        - type
      properties:
        type:
          type: string
          enum:
            - self_hosted_resources_unsupported_error
    BetaManagedAgentsMcpEgressBlockedDeploymentPausedReasonError:
      description: >-
        An MCP server host used by the deployment's agent is blocked by the
        environment's network policy.
      type: object
      additionalProperties: false
      required:
        - type
      properties:
        type:
          type: string
          enum:
            - mcp_egress_blocked_error
    BetaCurrency:
      type: string
      enum:
        - USD
    BetaManagedAgentsImageSource:
      description: Union type for image source variants.
      type: object
      discriminator:
        propertyName: type
        mapping:
          base64:
            $ref: '#/components/schemas/BetaManagedAgentsBase64ImageSource'
          url:
            $ref: '#/components/schemas/BetaManagedAgentsURLImageSource'
          file:
            $ref: '#/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:
            $ref: '#/components/schemas/BetaManagedAgentsBase64DocumentSource'
          text:
            $ref: '#/components/schemas/BetaManagedAgentsPlainTextDocumentSource'
          url:
            $ref: '#/components/schemas/BetaManagedAgentsURLDocumentSource'
          file:
            $ref: '#/components/schemas/BetaManagedAgentsFileDocumentSource'
      oneOf:
        - $ref: '#/components/schemas/BetaManagedAgentsBase64DocumentSource'
        - $ref: '#/components/schemas/BetaManagedAgentsPlainTextDocumentSource'
        - $ref: '#/components/schemas/BetaManagedAgentsURLDocumentSource'
        - $ref: '#/components/schemas/BetaManagedAgentsFileDocumentSource'
    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
    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
    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
    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
    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
    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
    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
  securitySchemes:
    omaApiKey:
      type: apiKey
      in: header
      name: X-Api-Key
      description: OMA workspace API key.
      x-default: sk-ant-local-default
    omaBearer:
      type: http
      scheme: bearer
      description: OMA workspace API key sent as a bearer token.

````