> ## 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 trace > Read the joined, content-free execution trace for one firing in ANY state. Sections join the firing receipt, the webhook filtering decision for its exact delivery payload, admission usage, the durable step program (Check and call receipts, child Session parks), the originating Session Turn with delivery-screen counts and per-iteration Outcome attempts, and structural human feedback — each section states its own applicability and the Session sections carry the same open, truncated, expired, erased, or ZDR completeness honesty as evidence. No messages, explanations, tool payloads, or model output are copied into this view. 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}/trace 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}/trace: get: tags: - automations summary: Get an Automation firing trace description: >- Read the joined, content-free execution trace for one firing in ANY state. Sections join the firing receipt, the webhook filtering decision for its exact delivery payload, admission usage, the durable step program (Check and call receipts, child Session parks), the originating Session Turn with delivery-screen counts and per-iteration Outcome attempts, and structural human feedback — each section states its own applicability and the Session sections carry the same open, truncated, expired, erased, or ZDR completeness honesty as evidence. No messages, explanations, tool payloads, or model output are copied into this view. 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.getAutomationFiringTrace 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: AutomationFiringTrace content: application/json: schema: $ref: '#/components/schemas/AutomationFiringTrace' 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}$ AutomationFiringTrace: type: object properties: authority: type: string enum: - firing_receipt_and_session_event_log firing: $ref: '#/components/schemas/AutomationFiring' filtering: $ref: '#/components/schemas/AutomationFiringTraceFiltering' admission: type: object properties: disposition: type: string enum: - not_applicable - admitted check_configured: type: boolean check_usage: anyOf: - $ref: '#/components/schemas/Objects_69' - type: 'null' required: - disposition - check_configured - check_usage additionalProperties: false steps: $ref: '#/components/schemas/AutomationFiringTraceSteps' children: $ref: '#/components/schemas/AutomationFiringTraceChildren' execution: $ref: '#/components/schemas/AutomationFiringTraceExecution' delivery: $ref: '#/components/schemas/AutomationFiringTraceDelivery' outcome: anyOf: - $ref: '#/components/schemas/AutomationFiringOutcome' - type: 'null' outcome_attempts: $ref: '#/components/schemas/AutomationFiringTraceOutcomeAttempts' feedback: type: object properties: total: type: integer allOf: - minimum: 0 by_disposition: $ref: '#/components/schemas/Objects_142' required: - total - by_disposition additionalProperties: false completeness: $ref: '#/components/schemas/AutomationFiringTraceCompleteness' required: - authority - firing - filtering - admission - steps - children - execution - delivery - outcome - outcome_attempts - feedback - completeness additionalProperties: false 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. 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_266' 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_266' 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_266' 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' AutomationFiringTraceFiltering: anyOf: - type: object properties: applicable: type: boolean enum: - false required: - applicable additionalProperties: false - type: object properties: applicable: type: boolean enum: - true payload_fingerprint: type: string allOf: - pattern: ^sha256:[0-9a-f]{64}$ filtered_record: anyOf: - type: object properties: id: type: string allOf: - pattern: ^afilt_[0-9a-f]{32}$ reason: $ref: '#/components/schemas/Union_254' received_at: type: string check_usage: anyOf: - $ref: '#/components/schemas/Objects_69' - type: 'null' required: - id - reason - received_at - check_usage additionalProperties: false - type: 'null' required: - applicable - payload_fingerprint - filtered_record additionalProperties: false Objects_69: type: object properties: input_tokens: type: integer allOf: - minimum: 0 cached_input_tokens: type: integer allOf: - minimum: 0 cache_write_input_tokens: type: integer allOf: - minimum: 0 output_tokens: type: integer allOf: - minimum: 0 reasoning_output_tokens: type: integer allOf: - minimum: 0 total_tokens: type: integer allOf: - minimum: 0 required: - input_tokens - cached_input_tokens - cache_write_input_tokens - output_tokens - reasoning_output_tokens - total_tokens additionalProperties: false AutomationFiringTraceSteps: anyOf: - type: object properties: applicable: type: boolean enum: - false required: - applicable additionalProperties: false - type: object properties: applicable: type: boolean enum: - true state: type: string enum: - pending - settled - terminal result: anyOf: - type: string enum: - completed - failed - denied - rejected - type: 'null' attempt_count: type: integer allOf: - minimum: 0 outcomes: type: array items: $ref: '#/components/schemas/Union_267' check_results: type: array items: $ref: '#/components/schemas/AutomationStepCheckResult' call_results: type: array items: $ref: '#/components/schemas/AutomationStepCallResult' required: - applicable - state - result - attempt_count - outcomes - check_results - call_results additionalProperties: false AutomationFiringTraceChildren: anyOf: - type: object properties: applicable: type: boolean enum: - false required: - applicable additionalProperties: false - type: object properties: applicable: type: boolean enum: - true session_parks: type: array items: $ref: '#/components/schemas/AutomationStepChildSessionPark' pending_session: anyOf: - $ref: '#/components/schemas/SessionId' - type: 'null' required: - applicable - session_parks - pending_session additionalProperties: false AutomationFiringTraceExecution: anyOf: - type: object properties: applicable: type: boolean enum: - false required: - applicable additionalProperties: false - type: object properties: applicable: type: boolean enum: - true session_id: $ref: '#/components/schemas/SessionId' initial_run_id: $ref: '#/components/schemas/RunId' run_count: type: integer allOf: - minimum: 0 terminal_status: anyOf: - type: string - type: 'null' required: - applicable - session_id - initial_run_id - run_count - terminal_status additionalProperties: false AutomationFiringTraceDelivery: anyOf: - type: object properties: applicable: type: boolean enum: - false required: - applicable additionalProperties: false - type: object properties: applicable: type: boolean enum: - true screened_messages: type: integer allOf: - minimum: 0 passed: type: integer allOf: - minimum: 0 blocked: type: integer allOf: - minimum: 0 screen_failed: type: integer allOf: - minimum: 0 required: - applicable - screened_messages - passed - blocked - screen_failed 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 AutomationFiringTraceOutcomeAttempts: anyOf: - type: object properties: applicable: type: boolean enum: - false required: - applicable additionalProperties: false - type: object properties: applicable: type: boolean enum: - true attempts: type: array items: $ref: '#/components/schemas/AutomationFiringOutcomeAttempt' required: - applicable - attempts additionalProperties: false Objects_142: type: object properties: useful: type: integer allOf: - minimum: 0 noisy: type: integer allOf: - minimum: 0 incorrect: type: integer allOf: - minimum: 0 too_late: type: integer allOf: - minimum: 0 already_handled: type: integer allOf: - minimum: 0 required: - useful - noisy - incorrect - too_late - already_handled additionalProperties: false AutomationFiringTraceCompleteness: anyOf: - type: object properties: status: type: string enum: - complete through_sequence: type: integer allOf: - minimum: 0 required: - status - through_sequence additionalProperties: false - type: object properties: status: type: string enum: - incomplete reason: type: string enum: - open - truncated - expired - erased - zdr - not_applicable through_sequence: anyOf: - type: integer allOf: - minimum: 0 - type: 'null' required: - status - reason - through_sequence additionalProperties: false AutomationId: type: string allOf: - pattern: ^auto_[0-9a-f]{32}$ Union_266: 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 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_269' 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_214' 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_266' 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 Union_254: type: string enum: - predicate_unmatched - check_drop - check_failed Union_267: 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 AutomationStepCheckResult: type: object properties: step: type: string allOf: - minLength: 1 - maxLength: 64 - pattern: ^[A-Za-z0-9_]+$ operation: type: string enum: - condition - action resolution: type: string enum: - admit - deny - failed usage: anyOf: - $ref: '#/components/schemas/Objects_69' - type: 'null' required: - step - operation - resolution - usage additionalProperties: false AutomationStepCallResult: type: object properties: step: type: string allOf: - minLength: 1 - maxLength: 64 - pattern: ^[A-Za-z0-9_]+$ resolution: type: string enum: - succeeded - failed status: anyOf: - type: integer allOf: - minimum: 100 maximum: 599 - type: 'null' required: - step - resolution - status additionalProperties: false AutomationStepChildSessionPark: type: object properties: step: type: string allOf: - minLength: 1 - maxLength: 64 - pattern: ^[A-Za-z0-9_]+$ session: $ref: '#/components/schemas/SessionId' required: - step - session 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 AutomationFiringOutcomeAttempt: type: object properties: iteration: type: integer allOf: - minimum: 0 started_at_seq: anyOf: - type: integer allOf: - minimum: 0 - type: 'null' result: anyOf: - $ref: '#/components/schemas/Union_155' - type: 'null' completed_at_seq: anyOf: - type: integer allOf: - minimum: 0 - type: 'null' required: - iteration - started_at_seq - result - completed_at_seq additionalProperties: false FlowReviewId: type: string allOf: - pattern: ^flrev_[0-9a-f]{32}$ Union_269: type: string enum: - evidence_unavailable - evidence_unsupported - evidence_too_large - source_erased - reviewer_unavailable Union_214: 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: $ref: '#/components/schemas/Union_267' wake_at: anyOf: - type: string - type: 'null' required: - state - result - steps - wake_at additionalProperties: false Union_155: type: string enum: - satisfied - needs_revision - max_iterations_reached - failed - interrupted securitySchemes: bearerAuth: type: http scheme: bearer ````