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

# Get an Automation firing

> Read one AutomationFiring receipt: its sanitized source (`manual`, `schedule` with `scheduled_for`, `webhook`, or `subscription`), status, operational attempt count, and, when submitted, the Session and Run it created plus the passive definition-of-done projection. A null outcome means unknown or not yet terminal, never failure.

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.



## OpenAPI

````yaml /openapi.json get /v1/automation-firings/{id}
openapi: 3.1.0
info:
  title: Checkfu API
  version: '2026-08-27'
  description: >-
    Authentication is declared per operation: API-key, runtime, or connector
    bearer; Automation signature; or credential-free pairing redemption. Every
    general Checkfu REST request requires the dated `Checkfu-Version` header
    (one of: 2026-08-27); the three MCP JSON-RPC transports use
    `MCP-Protocol-Version`, A2A uses `A2A-Version`, and the provider OAuth
    callback carries neither Checkfu header. API keys resolve one Workspace
    without a request selector; authenticated responses identify it with
    `Checkfu-Workspace-Id`.
servers:
  - url: https://api.checkfu.com
security:
  - bearerAuth: []
tags:
  - name: organizations
  - name: sourceRepositories
  - name: tenants
  - name: workspaces
  - name: principals
  - name: principalGroups
  - name: principalAccessCredentials
  - name: apiKeys
  - name: agents
  - name: harnesses
  - name: harnessRuntime
  - name: sandboxProfiles
  - name: computerProfiles
  - name: permissionAssignments
  - name: actionPolicies
  - name: files
  - name: memoryStores
  - name: dreams
  - name: modelCredentials
  - name: modelRoutingProfiles
  - name: blueprintInstallations
  - name: toolSources
  - name: skills
  - name: skillSources
  - name: agentSources
  - name: skillProposals
  - name: instructionProposals
  - name: catalog
  - name: concepts
  - name: support
  - name: connections
  - name: connectionVaults
  - name: connectionAssignments
  - name: connectedRuntimes
  - name: projects
  - name: collaboration
  - name: automationGraphs
  - name: automations
  - name: actionApprovals
  - name: standingApprovals
  - name: usage
  - name: models
  - name: outcomes
  - name: budgets
  - name: billing
  - name: sessions
  - name: audit
  - name: sessionExports
  - name: runs
  - name: runnerPools
  - name: transcripts
  - name: sessionWatches
  - name: webhookEndpoints
  - name: integrationGateway
  - name: agentDeployments
  - name: workEnvironments
  - name: computers
  - name: computerScreens
  - name: computerBrowserObservations
  - name: computerBrowserActions
  - name: environments
  - name: vaults
  - name: apiMcp
  - name: a2a
paths:
  /v1/automation-firings/{id}:
    get:
      tags:
        - automations
      summary: Get an Automation firing
      description: >-
        Read one AutomationFiring receipt: its sanitized source (`manual`,
        `schedule` with `scheduled_for`, `webhook`, or `subscription`), status,
        operational attempt count, and, when submitted, the Session and Run it
        created plus the passive definition-of-done projection. A null outcome
        means unknown or not yet terminal, never failure.


        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.getAutomationFiring
      parameters:
        - name: id
          in: path
          schema:
            $ref: '#/components/schemas/AutomationFiringId'
          required: true
        - name: checkfu-version
          in: header
          schema:
            type: string
            enum:
              - '2026-08-27'
          required: true
      responses:
        '200':
          description: AutomationFiring
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AutomationFiring'
          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:
                type: object
                required:
                  - error
                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
                additionalProperties: false
        '401':
          description: Typed Checkfu wire error
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: object
                    required:
                      - type
                      - message
                      - more
                    properties:
                      type:
                        type: string
                        enum:
                          - auth.invalid_key
                      message:
                        type: string
                      more:
                        type: string
                        enum:
                          - >-
                            https://docs.checkfu.com/reference/errors#auth-invalid-key
                        description: >-
                          Stable public documentation and remedy for this error
                          type.
                    additionalProperties: false
                additionalProperties: false
        '403':
          description: >-
            The organization, tenant, or workspace backing this key is
            administratively disabled. | Deployment governance or retention
            policy denied the request.
          content:
            application/json:
              schema:
                anyOf:
                  - type: object
                    required:
                      - error
                    properties:
                      error:
                        type: object
                        properties:
                          type:
                            type: string
                            enum:
                              - auth.disabled_tenancy
                          message:
                            type: string
                          more:
                            type: string
                            enum:
                              - >-
                                https://docs.checkfu.com/reference/errors#auth-disabled-tenancy
                            description: >-
                              Stable public documentation and remedy for this
                              error type.
                        required:
                          - type
                          - message
                          - more
                        additionalProperties: false
                    additionalProperties: false
                  - $ref: '#/components/schemas/PolicyDeniedError'
        '404':
          description: >-
            The requested resource does not exist in the resolved deployment
            boundary.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationNotFoundError'
        '429':
          description: Typed Checkfu wire error
          headers:
            retry-after:
              description: >-
                Delay in seconds for rate limits or deployment quotas with a
                known release or UTC reset boundary
              required: false
              schema:
                type: integer
                minimum: 1
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: object
                    required:
                      - type
                      - message
                      - more
                    properties:
                      type:
                        type: string
                        enum:
                          - budget.exceeded
                      message:
                        type: string
                      more:
                        type: string
                        enum:
                          - >-
                            https://docs.checkfu.com/reference/errors#budget-exceeded
                        description: >-
                          Stable public documentation and remedy for this error
                          type.
                    additionalProperties: false
                additionalProperties: false
        '500':
          description: >-
            An unexpected internal failure occurred; the message contains an
            opaque incident reference.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RuntimeInternalError'
      security:
        - bearerAuth: []
components:
  schemas:
    AutomationFiringId:
      type: string
      allOf:
        - pattern: ^afire_[0-9a-f]{32}$
    AutomationFiring:
      anyOf:
        - 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_265'
            attempt_count:
              type: integer
              allOf:
                - minimum: 0
            created_at:
              type: string
            updated_at:
              type: string
            status:
              type: string
              enum:
                - pending
            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
            - outcome
            - session_id
            - run_id
            - error
          additionalProperties: false
        - 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_265'
            attempt_count:
              type: integer
              allOf:
                - minimum: 0
            created_at:
              type: string
            updated_at:
              type: string
            status:
              type: string
              enum:
                - submitted
            outcome:
              anyOf:
                - $ref: '#/components/schemas/AutomationFiringOutcome'
                - type: 'null'
            flow_review:
              anyOf:
                - $ref: '#/components/schemas/AutomationFiringFlowReview'
                - type: 'null'
            session_id:
              $ref: '#/components/schemas/SessionId'
            run_id:
              $ref: '#/components/schemas/RunId'
            error:
              type: 'null'
          required:
            - id
            - workspace_id
            - automation_id
            - source
            - attempt_count
            - created_at
            - updated_at
            - status
            - outcome
            - flow_review
            - session_id
            - run_id
            - error
          additionalProperties: false
        - 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_265'
            attempt_count:
              type: integer
              allOf:
                - minimum: 0
            created_at:
              type: string
            updated_at:
              type: string
            status:
              type: string
              enum:
                - failed
            outcome:
              type: 'null'
            session_id:
              type: 'null'
            run_id:
              type: 'null'
            error:
              $ref: '#/components/schemas/Objects_144'
          required:
            - id
            - workspace_id
            - automation_id
            - source
            - attempt_count
            - created_at
            - updated_at
            - status
            - outcome
            - session_id
            - run_id
            - error
          additionalProperties: false
        - $ref: '#/components/schemas/AutomationStepProgramFiring_1'
    WorkspaceId:
      type: string
      allOf:
        - pattern: ^wrkspc_[0-9a-f]{32}$
    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.
    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.
    AutomationId:
      type: string
      allOf:
        - pattern: ^auto_[0-9a-f]{32}$
    Union_265:
      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
    AutomationFiringOutcome:
      type: object
      properties:
        outcome_id:
          $ref: '#/components/schemas/OutcomeId'
        result:
          type: string
          enum:
            - satisfied
            - max_iterations_reached
            - failed
            - interrupted
        evaluation_count:
          type: integer
          allOf:
            - minimum: 0
        revision_count:
          type: integer
          allOf:
            - minimum: 0
        report:
          anyOf:
            - $ref: '#/components/schemas/OutcomeReportSummaryCounts'
            - type: 'null'
      required:
        - outcome_id
        - result
        - evaluation_count
        - revision_count
        - report
      additionalProperties: false
    AutomationFiringFlowReview:
      anyOf:
        - type: object
          properties:
            status:
              type: string
              enum:
                - pending
            review_id:
              $ref: '#/components/schemas/FlowReviewId'
          required:
            - status
            - review_id
          additionalProperties: false
        - type: object
          properties:
            status:
              type: string
              enum:
                - completed
            review_id:
              $ref: '#/components/schemas/FlowReviewId'
            result:
              type: string
              enum:
                - passed
                - concerns
            concern_count:
              type: integer
              allOf:
                - minimum: 0
            unknown_count:
              type: integer
              allOf:
                - minimum: 0
            max_severity:
              type: string
              enum:
                - none
                - low
                - medium
                - high
          required:
            - status
            - review_id
            - result
            - concern_count
            - unknown_count
            - max_severity
          additionalProperties: false
        - type: object
          properties:
            status:
              type: string
              enum:
                - unavailable
            review_id:
              $ref: '#/components/schemas/FlowReviewId'
            reason:
              $ref: '#/components/schemas/Union_267'
          required:
            - status
            - review_id
            - reason
          additionalProperties: false
    SessionId:
      type: string
      allOf:
        - pattern: ^sess_[0-9a-f]{32}$
    RunId:
      type: string
      allOf:
        - pattern: ^run_[0-9a-f]{32}$
    Objects_144:
      type: object
      properties:
        type:
          $ref: '#/components/schemas/Union_213'
        message:
          type: string
        more:
          type: string
          allOf:
            - pattern: ^https:\/\/docs\.checkfu\.com\/reference\/errors#[a-z0-9-]+$
      required:
        - type
        - message
      additionalProperties: false
    AutomationStepProgramFiring_1:
      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_265'
        attempt_count:
          type: integer
          allOf:
            - minimum: 0
        created_at:
          type: string
        updated_at:
          type: string
        status:
          type: string
          enum:
            - step_program
        program:
          $ref: '#/components/schemas/Objects_145'
        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
    OutcomeId:
      type: string
      allOf:
        - pattern: ^outc_[0-9a-f]{32}$
    OutcomeReportSummaryCounts:
      type: object
      properties:
        status:
          type: string
          enum:
            - accepted
            - rejected
        output_count:
          type: integer
          allOf:
            - exclusiveMinimum: 0
            - maximum: 32
        accepted_count:
          type: integer
          allOf:
            - minimum: 0
      required:
        - status
        - output_count
        - accepted_count
      additionalProperties: false
    FlowReviewId:
      type: string
      allOf:
        - pattern: ^flrev_[0-9a-f]{32}$
    Union_267:
      type: string
      enum:
        - evidence_unavailable
        - evidence_unsupported
        - evidence_too_large
        - source_erased
        - reviewer_unavailable
    Union_213:
      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.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
        - runtime.checkpoint_expired
        - runtime.session_history_unavailable
        - runtime.harness_unavailable
        - runtime.harness_failed
        - runtime.runner_unavailable
        - runtime.lease_lost
        - runtime.start_timeout
        - runtime.provisioning_suspended
        - runtime.turn_deadline_exceeded
        - runtime.observation_gap
        - runtime.observation_conflict
        - runtime.attestation_invalid
        - runtime.harness_incompatible
        - runtime.internal
    Objects_145:
      type: object
      properties:
        state:
          type: string
          enum:
            - pending
            - settled
            - terminal
        result:
          anyOf:
            - type: string
              enum:
                - completed
                - failed
                - denied
                - rejected
            - type: 'null'
        steps:
          type: array
          items:
            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
                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
        wake_at:
          anyOf:
            - type: string
            - type: 'null'
      required:
        - state
        - result
        - steps
        - wake_at
      additionalProperties: false
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````