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

# Fire an Automation now

> Fire an Automation manually through the same durable AutomationFiring receipt a schedule or webhook uses.



## OpenAPI

````yaml /openapi.json post /v1/automations/{id}/fire
openapi: 3.1.0
info:
  title: Checkfu API
  version: '2026-08-31'
  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-31); 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: harnessRuntime
  - name: permissionAssignments
  - name: actionPolicies
  - name: files
  - name: memoryStores
  - name: modelCredentials
  - name: modelRoutingProfiles
  - name: toolSources
  - name: skills
  - name: skillSources
  - name: agentBlueprints
  - name: skillProposals
  - name: instructionProposals
  - name: catalog
  - name: managedTools
  - name: concepts
  - name: support
  - name: connections
  - name: connectionVaults
  - name: connectionAssignments
  - name: connectedRuntimes
  - name: fileTrees
  - name: collaboration
  - name: automationGraphs
  - name: automations
  - name: actionApprovals
  - name: standingApprovals
  - name: workloadReviewPolicies
  - 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: sessionCapsules
  - name: sessionTrajectories
  - name: webhookEndpoints
  - name: integrationGateway
  - name: workEnvironments
  - name: computers
  - name: computerScreens
  - name: computerBrowserObservations
  - name: computerBrowserActions
  - name: environments
  - name: computerHeadlessOperations
  - name: vaults
  - name: apiMcp
  - name: a2a
paths:
  /v1/automations/{id}/fire:
    post:
      tags:
        - automations
      summary: Fire an Automation now
      description: >-
        Fire an Automation manually through the same durable AutomationFiring
        receipt a schedule or webhook uses. There are two 201 success shapes: an
        agent target returns the initial Run of a fresh Session, and a steps
        target returns its step-program firing. An empty body fires with the
        content-free `{"kind":"manual"}` payload. An optional `event` (bounded
        JSON, at most 1 MiB, like a webhook delivery body) is a sample trigger
        event for testing: it becomes the firing's payload, so a prompt
        template's `{{event}}` renders it and a steps program's conditions read
        it, while the firing's source stays `manual` and webhook
        AdmissionFilters are skipped. Requires a non-empty Idempotency-Key,
        unlike pause and resume, which merely accept one; the event is part of
        the request identity, so reusing a key with a different event is an
        idempotency conflict.


        Checkfu support posture: alpha; hosted. Required evidence journey:
        automation-firing. Deployment-specific readiness and the latest proven
        release are available from GET /v1/support/capabilities.
      operationId: automations.fireAutomation
      parameters:
        - name: id
          in: path
          schema:
            $ref: '#/components/schemas/AutomationId'
          required: true
        - name: checkfu-version
          in: header
          schema:
            type: string
            enum:
              - '2026-08-31'
          required: true
        - name: idempotency-key
          in: header
          schema:
            type: string
            allOf:
              - maxLength: 255
              - minLength: 1
          required: true
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FireAutomation'
        required: true
      responses:
        '201':
          description: >-
            The initial Run (agent target) or the step-program firing (steps
            target) | AutomationStepProgramFiring
          content:
            application/json:
              schema:
                anyOf:
                  - type: object
                    properties:
                      id:
                        $ref: '#/components/schemas/RunId'
                      workspace_id:
                        $ref: '#/components/schemas/WorkspaceId'
                      session_id:
                        $ref: '#/components/schemas/SessionId'
                      agent:
                        $ref: '#/components/schemas/AgentId'
                      principal:
                        $ref: '#/components/schemas/PrincipalId'
                      requested_by:
                        $ref: '#/components/schemas/Union_107'
                      acted_as:
                        $ref: '#/components/schemas/PrincipalId'
                      caused_by:
                        $ref: '#/components/schemas/Union_272'
                      agent_placement_id:
                        $ref: '#/components/schemas/Union_273'
                      collaboration_space_id:
                        $ref: '#/components/schemas/Union_274'
                      collaboration_space_kind:
                        $ref: '#/components/schemas/Union_111'
                      trigger:
                        $ref: '#/components/schemas/Union_275'
                      status:
                        $ref: '#/components/schemas/Union_276'
                      cost:
                        $ref: '#/components/schemas/Objects_139'
                      artifacts:
                        $ref: '#/components/schemas/Arrays_42'
                      stop_reason:
                        $ref: '#/components/schemas/Union_277'
                      error:
                        $ref: '#/components/schemas/Union_279'
                      created_at:
                        type: string
                      updated_at:
                        type: string
                      completed_at:
                        $ref: '#/components/schemas/Union_280'
                    required:
                      - id
                      - workspace_id
                      - session_id
                      - agent
                      - principal
                      - requested_by
                      - acted_as
                      - caused_by
                      - agent_placement_id
                      - collaboration_space_id
                      - trigger
                      - status
                      - cost
                      - artifacts
                      - stop_reason
                      - error
                      - created_at
                      - updated_at
                      - completed_at
                    additionalProperties: false
                    allOf:
                      - anyOf:
                          - properties:
                              collaboration_space_id:
                                type: 'null'
                              collaboration_space_kind: false
                          - properties:
                              collaboration_space_id:
                                type: string
                              collaboration_space_kind:
                                type: string
                                enum:
                                  - root
                                  - team
                                  - channel
                                  - personal
                            required:
                              - collaboration_space_id
                              - collaboration_space_kind
                        description: >-
                          The initial Run (agent target) or the step-program
                          firing (steps target)
                  - $ref: '#/components/schemas/AutomationStepProgramFiring'
          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:
                  - $ref: '#/components/schemas/AuthDisabledTenancyError'
                  - $ref: '#/components/schemas/PolicyDeniedError'
        '404':
          description: >-
            The requested resource does not exist in the resolved deployment
            boundary.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationNotFoundError'
        '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. | The connected runtime placement no
            longer matches the frozen execution target.
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/ValidationConflictError'
                  - $ref: '#/components/schemas/IdempotencyConflictError'
                  - $ref: '#/components/schemas/RuntimeTargetMismatchError'
        '422':
          description: >-
            No model candidate satisfies the deployment's routing constraints. |
            The harness does not satisfy the required protocol or capability
            set.
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/ModelNoEligibleModelError'
                  - $ref: '#/components/schemas/RuntimeHarnessIncompatibleError'
        '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'
        '503':
          description: >-
            The MemoryStore backend cannot serve the operation and applied no
            write. | Platform-managed model credentials are temporarily
            unavailable. | No eligible Runner can currently claim the work.
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/MemoryBackendUnavailableError'
                  - $ref: '#/components/schemas/ModelPlatformSupplyUnavailableError'
                  - $ref: '#/components/schemas/RuntimeRunnerUnavailableError'
      security:
        - bearerAuth: []
components:
  schemas:
    AutomationId:
      type: string
      pattern: ^auto_[0-9a-f]{32}$
    FireAutomation:
      type: object
      properties:
        event:
          $ref: '#/components/schemas/AutomationSampleEvent'
      additionalProperties: false
    RunId:
      type: string
      pattern: ^run_[0-9a-f]{32}$
    WorkspaceId:
      type: string
      pattern: ^wrkspc_[0-9a-f]{32}$
    SessionId:
      type: string
      pattern: ^sess_[0-9a-f]{32}$
    AgentId:
      type: string
      pattern: ^agent_[0-9a-f]{32}$
    PrincipalId:
      type: string
      pattern: ^prin_[0-9a-f]{32}$
    Union_107:
      anyOf:
        - type: object
          properties:
            kind:
              type: string
              enum:
                - api_key
            api_key:
              $ref: '#/components/schemas/ApiKeyId'
          required:
            - kind
            - api_key
          additionalProperties: false
        - type: object
          properties:
            kind:
              type: string
              enum:
                - principal
            principal:
              $ref: '#/components/schemas/PrincipalId'
          required:
            - kind
            - principal
          additionalProperties: false
        - type: object
          properties:
            kind:
              type: string
              enum:
                - automation
            automation:
              $ref: '#/components/schemas/AutomationId'
          required:
            - kind
            - automation
          additionalProperties: false
        - type: object
          properties:
            kind:
              type: string
              enum:
                - system
            name:
              type: string
              allOf:
                - minLength: 1
                - maxLength: 512
          required:
            - kind
            - name
          additionalProperties: false
    Union_272:
      anyOf:
        - anyOf:
            - type: object
              properties:
                kind:
                  type: string
                  enum:
                    - api
                request_id:
                  type: string
                  allOf:
                    - minLength: 1
                    - maxLength: 512
              required:
                - kind
              additionalProperties: false
            - type: object
              properties:
                kind:
                  type: string
                  enum:
                    - external_event
                external_installation_id:
                  $ref: '#/components/schemas/CollaborationInstallationId'
                collaboration_space_id:
                  $ref: '#/components/schemas/CollaborationSpaceId'
                external_event_id:
                  type: string
                  allOf:
                    - minLength: 1
                    - maxLength: 512
              required:
                - kind
                - external_installation_id
                - collaboration_space_id
                - external_event_id
              additionalProperties: false
            - type: object
              properties:
                kind:
                  type: string
                  enum:
                    - automation
                automation:
                  $ref: '#/components/schemas/AutomationId'
              required:
                - kind
                - automation
              additionalProperties: false
            - type: object
              properties:
                kind:
                  type: string
                  enum:
                    - watch
                watch:
                  $ref: '#/components/schemas/WatchId'
                source_state_hash:
                  type: string
                  allOf:
                    - minLength: 1
                    - maxLength: 512
              required:
                - kind
                - watch
                - source_state_hash
              additionalProperties: false
        - type: object
          properties:
            kind:
              type: string
              enum:
                - action_approval
            approval:
              $ref: '#/components/schemas/ActionApprovalId'
          required:
            - kind
            - approval
          additionalProperties: false
    Union_273:
      anyOf:
        - $ref: '#/components/schemas/AgentPlacementId'
        - type: 'null'
    Union_274:
      anyOf:
        - $ref: '#/components/schemas/CollaborationSpaceId'
        - type: 'null'
    Union_111:
      type: string
      enum:
        - root
        - team
        - channel
        - personal
    Union_275:
      anyOf:
        - anyOf:
            - type: object
              properties:
                kind:
                  type: string
                  enum:
                    - api
              required:
                - kind
              additionalProperties: false
            - type: object
              properties:
                kind:
                  type: string
                  enum:
                    - automation
                automation:
                  $ref: '#/components/schemas/AutomationId'
              required:
                - kind
                - automation
              additionalProperties: false
            - type: object
              properties:
                kind:
                  type: string
                  enum:
                    - question
                question:
                  $ref: '#/components/schemas/QuestionId'
              required:
                - kind
                - question
              additionalProperties: false
            - type: object
              properties:
                kind:
                  type: string
                  enum:
                    - outcome
                outcome:
                  $ref: '#/components/schemas/OutcomeId'
              required:
                - kind
                - outcome
              additionalProperties: false
            - type: object
              properties:
                kind:
                  type: string
                  enum:
                    - watch
                watch:
                  $ref: '#/components/schemas/WatchId'
                source_state_hash:
                  type: string
                  pattern: ^sha256:[0-9a-f]{64}$
              required:
                - kind
                - watch
                - source_state_hash
              additionalProperties: false
        - type: object
          properties:
            kind:
              type: string
              enum:
                - action_approval
            approval:
              $ref: '#/components/schemas/ActionApprovalId'
          required:
            - kind
            - approval
          additionalProperties: false
    Union_276:
      type: string
      enum:
        - queued
        - running
        - requires_action
        - completed
        - failed
        - canceled
    Objects_139:
      type: object
      properties:
        tokens:
          type: integer
          minimum: 0
        tool_calls:
          type: integer
          minimum: 0
        active_ms:
          type: integer
          minimum: 0
      additionalProperties: false
    Arrays_42:
      type: array
      items:
        $ref: '#/components/schemas/Objects_140'
    Union_277:
      anyOf:
        - $ref: '#/components/schemas/Union_278'
        - type: 'null'
    Union_279:
      anyOf:
        - $ref: '#/components/schemas/Objects_35'
        - type: 'null'
    Union_280:
      anyOf:
        - type: string
        - type: 'null'
    AutomationStepProgramFiring:
      type: object
      properties:
        id:
          $ref: '#/components/schemas/AutomationFiringId'
        workspace_id:
          $ref: '#/components/schemas/WorkspaceId'
        automation_id:
          $ref: '#/components/schemas/AutomationId'
        source:
          $ref: '#/components/schemas/Union_281'
        attempt_count:
          type: integer
          minimum: 0
        created_at:
          type: string
        updated_at:
          type: string
        status:
          type: string
          enum:
            - step_program
        program:
          $ref: '#/components/schemas/Objects_141'
        outcome:
          type: 'null'
        session_id:
          type: 'null'
        run_id:
          type: 'null'
        error:
          type: 'null'
      required:
        - id
        - workspace_id
        - automation_id
        - source
        - attempt_count
        - created_at
        - updated_at
        - status
        - program
        - outcome
        - session_id
        - run_id
        - error
      additionalProperties: false
    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.
    AuthDisabledTenancyError:
      type: object
      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
      required:
        - error
      additionalProperties: false
      description: >-
        The organization, tenant, or workspace backing this key is
        administratively disabled.
    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.
    ValidationNotFoundError:
      type: object
      properties:
        error:
          type: object
          properties:
            type:
              type: string
              enum:
                - validation.not_found
            message:
              type: string
            more:
              type: string
              enum:
                - https://docs.checkfu.com/reference/errors#validation-not-found
              description: Stable public documentation and remedy for this error type.
          required:
            - type
            - message
            - more
          additionalProperties: false
      required:
        - error
      additionalProperties: false
      description: >-
        The requested resource does not exist in the resolved deployment
        boundary.
    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.
    RuntimeTargetMismatchError:
      type: object
      properties:
        error:
          type: object
          properties:
            type:
              type: string
              enum:
                - runtime.target_mismatch
            message:
              type: string
            more:
              type: string
              enum:
                - >-
                  https://docs.checkfu.com/reference/errors#runtime-target-mismatch
              description: Stable public documentation and remedy for this error type.
          required:
            - type
            - message
            - more
          additionalProperties: false
      required:
        - error
      additionalProperties: false
      description: >-
        The connected runtime placement no longer matches the frozen execution
        target.
    ModelNoEligibleModelError:
      type: object
      properties:
        error:
          type: object
          properties:
            type:
              type: string
              enum:
                - model.no_eligible_model
            message:
              type: string
            more:
              type: string
              enum:
                - >-
                  https://docs.checkfu.com/reference/errors#model-no-eligible-model
              description: Stable public documentation and remedy for this error type.
          required:
            - type
            - message
            - more
          additionalProperties: false
      required:
        - error
      additionalProperties: false
      description: No model candidate satisfies the deployment's routing constraints.
    RuntimeHarnessIncompatibleError:
      type: object
      properties:
        error:
          type: object
          properties:
            type:
              type: string
              enum:
                - runtime.harness_incompatible
            message:
              type: string
            more:
              type: string
              enum:
                - >-
                  https://docs.checkfu.com/reference/errors#runtime-harness-incompatible
              description: Stable public documentation and remedy for this error type.
          required:
            - type
            - message
            - more
          additionalProperties: false
      required:
        - error
      additionalProperties: false
      description: The harness does not satisfy the required protocol or capability set.
    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.
    MemoryBackendUnavailableError:
      type: object
      properties:
        error:
          type: object
          properties:
            type:
              type: string
              enum:
                - memory.backend_unavailable
            message:
              type: string
            more:
              type: string
              enum:
                - >-
                  https://docs.checkfu.com/reference/errors#memory-backend-unavailable
              description: Stable public documentation and remedy for this error type.
          required:
            - type
            - message
            - more
          additionalProperties: false
      required:
        - error
      additionalProperties: false
      description: The MemoryStore backend cannot serve the operation and applied no write.
    ModelPlatformSupplyUnavailableError:
      type: object
      properties:
        error:
          type: object
          properties:
            type:
              type: string
              enum:
                - model.platform_supply_unavailable
            message:
              type: string
            more:
              type: string
              enum:
                - >-
                  https://docs.checkfu.com/reference/errors#model-platform-supply-unavailable
              description: Stable public documentation and remedy for this error type.
          required:
            - type
            - message
            - more
          additionalProperties: false
      required:
        - error
      additionalProperties: false
      description: Platform-managed model credentials are temporarily unavailable.
    RuntimeRunnerUnavailableError:
      type: object
      properties:
        error:
          type: object
          properties:
            type:
              type: string
              enum:
                - runtime.runner_unavailable
            message:
              type: string
            more:
              type: string
              enum:
                - >-
                  https://docs.checkfu.com/reference/errors#runtime-runner-unavailable
              description: Stable public documentation and remedy for this error type.
          required:
            - type
            - message
            - more
          additionalProperties: false
      required:
        - error
      additionalProperties: false
      description: No eligible Runner can currently claim the work.
    AutomationSampleEvent:
      x-checkfu-json-budget:
        maximumBytes: 1048576
        maximumDepth: 64
        maximumNodes: 100000
        maximumInspectionWork: 100000
      x-checkfu-unicode-scalar-values: true
      description: >-
        A sample trigger event: finite JSON of at most 1048576 bytes (1 MiB)
        with at most 64 levels and 100,000 nodes.
    ApiKeyId:
      type: string
      pattern: ^akey_[0-9a-f]{32}$
    CollaborationInstallationId:
      type: string
      pattern: ^exti_[0-9a-f]{32}$
    CollaborationSpaceId:
      type: string
      pattern: ^cspace_[0-9a-f]{32}$
    WatchId:
      type: string
      pattern: ^wch_[0-9a-f]{32}$
    ActionApprovalId:
      anyOf:
        - $ref: '#/components/schemas/NonBrowserActionApprovalId'
        - $ref: '#/components/schemas/BrowserActionApprovalId'
      description: >-
        an ActionApprovalId of the form approval_<32 hex chars> or bapproval_<32
        hex chars>
    AgentPlacementId:
      type: string
      pattern: ^aplace_[0-9a-f]{32}$
    QuestionId:
      type: string
      pattern: ^qst_[0-9a-f]{32}$
    OutcomeId:
      type: string
      pattern: ^outc_[0-9a-f]{32}$
    Objects_140:
      type: object
      properties:
        kind:
          type: string
          enum:
            - file
        file:
          $ref: '#/components/schemas/FileId'
      required:
        - kind
        - file
      additionalProperties: false
    Union_278:
      type: string
      enum:
        - end_turn
        - requires_action
        - interrupted
        - retries_exhausted
        - max_tokens
        - max_turn_requests
        - refusal
        - error
        - budget_reached
    Objects_35:
      type: object
      properties:
        type:
          $ref: '#/components/schemas/Union_74'
        message:
          type: string
        more:
          type: string
          pattern: ^https:\/\/docs\.checkfu\.com\/reference\/errors#[a-z0-9-]+$
      required:
        - type
        - message
      additionalProperties: false
    AutomationFiringId:
      type: string
      pattern: ^afire_[0-9a-f]{32}$
    Union_281:
      anyOf:
        - type: object
          properties:
            kind:
              type: string
              enum:
                - manual
          required:
            - kind
          additionalProperties: false
        - type: object
          properties:
            kind:
              type: string
              enum:
                - schedule
            scheduled_for:
              type: string
          required:
            - kind
            - scheduled_for
          additionalProperties: false
        - type: object
          properties:
            kind:
              type: string
              enum:
                - webhook
          required:
            - kind
          additionalProperties: false
        - type: object
          properties:
            kind:
              type: string
              enum:
                - subscription
          required:
            - kind
          additionalProperties: false
    Objects_141:
      type: object
      properties:
        program_fingerprint:
          type: string
          pattern: ^sha256:[0-9a-f]{64}$
        state:
          type: string
          enum:
            - pending
            - settled
            - terminal
        result:
          anyOf:
            - type: string
              enum:
                - completed
                - failed
                - denied
                - rejected
            - type: 'null'
        steps:
          type: array
          items:
            $ref: '#/components/schemas/Union_282'
        wake_at:
          anyOf:
            - type: string
            - type: 'null'
        step_attempts:
          type: array
          items:
            $ref: '#/components/schemas/AutomationStepAttempts'
        step_items:
          type: array
          items:
            $ref: '#/components/schemas/AutomationStepItems'
      required:
        - state
        - result
        - steps
        - wake_at
      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.
    NonBrowserActionApprovalId:
      type: string
      pattern: ^approval_[0-9a-f]{32}$
    BrowserActionApprovalId:
      type: string
      pattern: ^bapproval_[0-9a-f]{32}$
    FileId:
      type: string
      pattern: ^file_[0-9a-f]{32}$
    Union_74:
      type: string
      enum:
        - validation.malformed
        - validation.prompt_integrity_review_required
        - validation.not_found
        - validation.conflict
        - validation.idempotency_conflict
        - validation.idempotency_in_progress
        - validation.payload_too_large
        - validation.range_too_large
        - auth.invalid_key
        - auth.authorization_unavailable
        - auth.request_admission_unavailable
        - auth.disabled_tenancy
        - policy.denied
        - budget.exceeded
        - model.no_eligible_model
        - model.credential_rejected
        - model.platform_supply_unavailable
        - model.platform_capacity_reached
        - billing.entitlement_unavailable
        - billing.usage_limit_reached
        - billing.payment_required
        - billing.seat_activation_unavailable
        - memory.not_found
        - memory.conflict
        - memory.read_only
        - memory.invalid_path
        - memory.backend_unavailable
        - memory.curation_failed
        - runtime.invalid_transition
        - runtime.primary_thread
        - retention.zdr_unsupported
        - runtime.checkpoint_expired
        - runtime.session_history_unavailable
        - runtime.harness_unavailable
        - runtime.harness_failed
        - runtime.runner_unavailable
        - runtime.provider_host_unavailable
        - runtime.lease_lost
        - runtime.start_timeout
        - runtime.allocation_failed
        - runtime.allocation_not_ready
        - runtime.provisioning_suspended
        - runtime.computer_unavailable
        - runtime.turn_deadline_exceeded
        - runtime.observation_gap
        - runtime.observation_conflict
        - runtime.attestation_invalid
        - runtime.harness_incompatible
        - runtime.target_mismatch
        - runtime.transcript_index_unavailable
        - runtime.managed_tool_failed
        - runtime.managed_tool_canceled
        - runtime.internal
    Union_282:
      anyOf:
        - type: object
          properties:
            step:
              type: string
              allOf:
                - minLength: 1
                - maxLength: 64
                - pattern: ^[A-Za-z0-9_]+$
            kind:
              type: string
              enum:
                - completed
          required:
            - step
            - kind
          additionalProperties: false
        - type: object
          properties:
            step:
              type: string
              allOf:
                - minLength: 1
                - maxLength: 64
                - pattern: ^[A-Za-z0-9_]+$
            kind:
              type: string
              enum:
                - skipped
          required:
            - step
            - kind
          additionalProperties: false
        - type: object
          properties:
            step:
              type: string
              allOf:
                - minLength: 1
                - maxLength: 64
                - pattern: ^[A-Za-z0-9_]+$
            kind:
              type: string
              enum:
                - rejected
          required:
            - step
            - kind
          additionalProperties: false
        - type: object
          properties:
            step:
              type: string
              allOf:
                - minLength: 1
                - maxLength: 64
                - pattern: ^[A-Za-z0-9_]+$
            kind:
              type: string
              enum:
                - failed
            reason:
              $ref: '#/components/schemas/AutomationStepFailureReason'
          required:
            - step
            - kind
          additionalProperties: false
        - type: object
          properties:
            step:
              type: string
              allOf:
                - minLength: 1
                - maxLength: 64
                - pattern: ^[A-Za-z0-9_]+$
            kind:
              type: string
              enum:
                - awaiting_approval
          required:
            - step
            - kind
          additionalProperties: false
        - type: object
          properties:
            step:
              type: string
              allOf:
                - minLength: 1
                - maxLength: 64
                - pattern: ^[A-Za-z0-9_]+$
            kind:
              type: string
              enum:
                - waiting
          required:
            - step
            - kind
          additionalProperties: false
        - type: object
          properties:
            step:
              type: string
              allOf:
                - minLength: 1
                - maxLength: 64
                - pattern: ^[A-Za-z0-9_]+$
            kind:
              type: string
              enum:
                - running
          required:
            - step
            - kind
          additionalProperties: false
        - type: object
          properties:
            step:
              type: string
              allOf:
                - minLength: 1
                - maxLength: 64
                - pattern: ^[A-Za-z0-9_]+$
            kind:
              type: string
              enum:
                - denied
          required:
            - step
            - kind
          additionalProperties: false
        - type: object
          properties:
            step:
              type: string
              allOf:
                - minLength: 1
                - maxLength: 64
                - pattern: ^[A-Za-z0-9_]+$
            kind:
              type: string
              enum:
                - decision
            branch:
              type: string
              enum:
                - continue
                - otherwise
                - uncertain
                - error
          required:
            - step
            - kind
            - branch
          additionalProperties: false
    AutomationStepAttempts:
      type: object
      properties:
        step:
          type: string
          allOf:
            - minLength: 1
            - maxLength: 64
            - pattern: ^[A-Za-z0-9_]+$
        attempts:
          type: integer
          allOf:
            - minimum: 2
              maximum: 5
      required:
        - step
        - attempts
      additionalProperties: false
    AutomationStepItems:
      type: object
      properties:
        step:
          type: string
          allOf:
            - minLength: 1
            - maxLength: 64
            - pattern: ^[A-Za-z0-9_]+$
        total:
          type: integer
          minimum: 0
        started:
          type: integer
          allOf:
            - minimum: 0
              maximum: 50
        completed:
          type: integer
          allOf:
            - minimum: 0
              maximum: 50
        failed:
          type: integer
          allOf:
            - minimum: 0
              maximum: 50
        rejected:
          type: integer
          allOf:
            - minimum: 0
              maximum: 50
        refusal:
          type: string
          enum:
            - items_missing
            - items_not_array
            - too_many_items
      required:
        - step
        - total
        - started
        - completed
        - failed
        - rejected
      additionalProperties: false
    AutomationStepFailureReason:
      type: string
      pattern: ^[a-z][a-z0-9_]{0,127}$
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.