> ## 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.

# Get a firing FlowReview report

> Read the retained detailed result of one passive FlowReview from the authoritative Session log.



## OpenAPI

````yaml /openapi.json get /v1/automation-firings/{id}/flow-review
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/automation-firings/{id}/flow-review:
    get:
      tags:
        - automations
      summary: Get a firing FlowReview report
      description: >-
        Read the retained detailed result of one passive FlowReview from the
        authoritative Session log. Criterion rows cite authorized Session event
        IDs but do not duplicate source content. Pending, unavailable, expired,
        erased, and ZDR detail fails honestly while the content-free firing
        summary remains readable.


        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.getAutomationFiringFlowReview
      parameters:
        - name: id
          in: path
          schema:
            $ref: '#/components/schemas/AutomationFiringId'
          required: true
        - name: checkfu-version
          in: header
          schema:
            type: string
            enum:
              - '2026-08-31'
          required: true
      responses:
        '200':
          description: >-
            passed requires every criterion to pass; any concern or unknown
            requires concerns
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FlowReviewReport'
          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
      pattern: ^afire_[0-9a-f]{32}$
    FlowReviewReport:
      type: object
      properties:
        result:
          type: string
          enum:
            - passed
            - concerns
        criteria:
          type: array
          items:
            $ref: '#/components/schemas/Objects_142'
          allOf:
            - minItems: 1
            - maxItems: 16
        evidence_digest:
          type: string
          pattern: ^sha256:[0-9a-f]{64}$
        through_event_id:
          $ref: '#/components/schemas/EventId'
        route:
          $ref: '#/components/schemas/Objects_116'
        usage:
          $ref: '#/components/schemas/Objects_77'
        evaluated_at:
          type: string
      required:
        - result
        - criteria
        - evidence_digest
        - through_event_id
        - route
        - usage
        - evaluated_at
      additionalProperties: false
    WorkspaceId:
      type: string
      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.
    Objects_142:
      type: object
      properties:
        key:
          type: string
          allOf:
            - minLength: 1
            - maxLength: 64
            - pattern: ^[a-z][a-z0-9]*(?:_[a-z0-9]+)*$
        result:
          type: string
          enum:
            - pass
            - concern
            - unknown
        explanation:
          type: string
          allOf:
            - maxLength: 512
        event_ids:
          type: array
          items:
            $ref: '#/components/schemas/EventId'
          allOf:
            - maxItems: 16
      required:
        - key
        - result
        - explanation
        - event_ids
      additionalProperties: false
    EventId:
      type: string
      pattern: ^evt_[0-9a-f]{32}$
    Objects_116:
      type: object
      properties:
        model_routing_profile_key:
          type: string
        model:
          type: string
        tier:
          type: string
        reason:
          type: string
        access_source:
          $ref: '#/components/schemas/Union_226'
      required:
        - model_routing_profile_key
        - model
        - tier
        - reason
        - access_source
      additionalProperties: false
    Objects_77:
      type: object
      properties:
        input_tokens:
          type: integer
          minimum: 0
        cached_input_tokens:
          type: integer
          minimum: 0
        cache_write_input_tokens:
          type: integer
          minimum: 0
        output_tokens:
          type: integer
          minimum: 0
        reasoning_output_tokens:
          type: integer
          minimum: 0
        total_tokens:
          type: integer
          minimum: 0
      required:
        - input_tokens
        - cached_input_tokens
        - cache_write_input_tokens
        - output_tokens
        - reasoning_output_tokens
        - total_tokens
      additionalProperties: false
    Union_226:
      anyOf:
        - $ref: '#/components/schemas/Objects_41'
        - $ref: '#/components/schemas/Objects_42'
    Objects_41:
      type: object
      properties:
        kind:
          type: string
          enum:
            - workspace_credential
        provider:
          type: string
          pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$
        model_credential_id:
          $ref: '#/components/schemas/ModelCredentialId'
        model_credential_generation_id:
          $ref: '#/components/schemas/ModelCredentialGenerationId'
      required:
        - kind
        - provider
        - model_credential_id
        - model_credential_generation_id
      additionalProperties: false
    Objects_42:
      type: object
      properties:
        kind:
          type: string
          enum:
            - platform_supply
        provider:
          type: string
          pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$
        usage_entry_id:
          $ref: '#/components/schemas/UsageEntryId'
        supply_id:
          $ref: '#/components/schemas/PlatformSupplyId'
        credential_generation_id:
          $ref: '#/components/schemas/SupplyCredentialGenerationId'
        rate_card_id:
          $ref: '#/components/schemas/BillingRateCardId'
        customer_rate_card_id:
          $ref: '#/components/schemas/BillingRateCardId'
        rated_at:
          $ref: '#/components/schemas/PlatformModelRatedAt'
      required:
        - kind
        - provider
        - usage_entry_id
        - supply_id
        - credential_generation_id
        - rate_card_id
        - rated_at
      additionalProperties: false
    ModelCredentialId:
      type: string
      pattern: ^mcred_[0-9a-f]{32}$
    ModelCredentialGenerationId:
      type: string
      pattern: ^mcgen_[0-9a-f]{32}$
    UsageEntryId:
      type: string
      pattern: ^use_[0-9a-f]{32}$
    PlatformSupplyId:
      type: string
      pattern: ^sup_[0-9a-f]{32}$
    SupplyCredentialGenerationId:
      type: string
      pattern: ^sgen_[0-9a-f]{32}$
    BillingRateCardId:
      type: string
      pattern: ^rate_[0-9a-f]{32}$
    PlatformModelRatedAt:
      type: string
      allOf:
        - maxLength: 24
        - pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$
          x-checkfu-current-timestamp: true
          description: >-
            A canonical UTC ISO-8601 model-rating instant with millisecond
            precision.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

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