> ## 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 an Automation firing trace > Read the joined, content-free execution trace for one firing in ANY state. ## OpenAPI ````yaml /openapi.json get /v1/automation-firings/{id}/trace 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}/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-31' 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 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_77' - 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 minimum: 0 by_disposition: $ref: '#/components/schemas/Objects_138' 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 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_281' attempt_count: type: integer 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_281' attempt_count: type: integer 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' failed_run_id: $ref: '#/components/schemas/RunId' 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_281' attempt_count: type: integer 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_35' 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 pattern: ^sha256:[0-9a-f]{64}$ filtered_record: anyOf: - type: object properties: id: type: string pattern: ^afilt_[0-9a-f]{32}$ reason: $ref: '#/components/schemas/Union_271' received_at: type: string check_usage: anyOf: - $ref: '#/components/schemas/Objects_77' - type: 'null' required: - id - reason - received_at - check_usage additionalProperties: false - type: 'null' required: - applicable - payload_fingerprint - filtered_record 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 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 minimum: 0 outcomes: type: array items: $ref: '#/components/schemas/Union_282' check_results: type: array items: $ref: '#/components/schemas/AutomationStepCheckResult' call_results: type: array items: $ref: '#/components/schemas/AutomationStepCallResult' session_query_receipts: type: array items: $ref: '#/components/schemas/AutomationStepSessionQueryReceipt' allOf: - maxItems: 20 memory_write_receipts: type: array items: $ref: '#/components/schemas/AutomationStepMemoryWriteReceipt' allOf: - maxItems: 20 skill_proposal_receipts: type: array items: $ref: '#/components/schemas/AutomationStepSkillProposalReceipt' allOf: - maxItems: 20 skill_proposal_observations: type: array items: $ref: '#/components/schemas/AutomationStepSkillProposalObservation' allOf: - maxItems: 20 json_receipts: type: array items: $ref: '#/components/schemas/AutomationStepJsonReceipt' allOf: - maxItems: 20 skill_read_receipts: type: array items: $ref: '#/components/schemas/AutomationStepSkillReadReceipt' allOf: - maxItems: 20 processing_recovery_receipts: type: array items: $ref: '#/components/schemas/AutomationStepProcessingRecoveryReceipt' allOf: - maxItems: 20 step_attempts: type: array items: $ref: '#/components/schemas/AutomationStepAttempts' step_items: type: array items: $ref: '#/components/schemas/AutomationStepItems' 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' session_receipts: type: array items: $ref: '#/components/schemas/AutomationStepChildSessionPark' allOf: - maxItems: 5000 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 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 minimum: 0 passed: type: integer minimum: 0 blocked: type: integer minimum: 0 screen_failed: type: integer 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 minimum: 0 revision_count: type: integer 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_138: type: object properties: useful: type: integer minimum: 0 noisy: type: integer minimum: 0 incorrect: type: integer minimum: 0 too_late: type: integer minimum: 0 already_handled: type: integer 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 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 minimum: 0 - type: 'null' required: - status - reason - through_sequence additionalProperties: false AutomationId: type: string pattern: ^auto_[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 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 minimum: 0 unknown_count: type: integer 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_284' required: - status - review_id - reason additionalProperties: false SessionId: type: string pattern: ^sess_[0-9a-f]{32}$ RunId: type: string pattern: ^run_[0-9a-f]{32}$ 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 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_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 Union_271: type: string enum: - predicate_unmatched - check_drop - check_uncertain - check_failed 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 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 - uncertain - failed usage: anyOf: - $ref: '#/components/schemas/Objects_77' - 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 AutomationStepSessionQueryReceipt: type: object properties: step: type: string allOf: - minLength: 1 - maxLength: 64 - pattern: ^[A-Za-z0-9_]+$ agent: $ref: '#/components/schemas/AgentId' disposition: type: string enum: - empty - selected after_sequence: type: integer allOf: - minimum: 0 - maximum: 9007199254740991 through_sequence: type: integer allOf: - minimum: 0 - maximum: 9007199254740991 has_more: type: boolean sources: type: array items: type: object properties: session: $ref: '#/components/schemas/SessionId' source_sequence: type: integer allOf: - minimum: 0 - maximum: 9007199254740991 change_sequence: type: integer allOf: - minimum: 0 - maximum: 9007199254740991 range: $ref: '#/components/schemas/AutomationSessionEvidenceRange' required: - session - source_sequence - change_sequence additionalProperties: false allOf: - maxItems: 100 required: - step - agent - disposition - after_sequence - through_sequence - has_more - sources additionalProperties: false AutomationStepMemoryWriteReceipt: type: object properties: step: type: string allOf: - minLength: 1 - maxLength: 64 - pattern: ^[A-Za-z0-9_]+$ store: $ref: '#/components/schemas/MemoryStoreId' disposition: type: string enum: - applied - noop - replayed - proposed tree_hash: anyOf: - type: string pattern: ^sha256:[0-9a-f]{64}$ - type: 'null' proposal: $ref: '#/components/schemas/MemoryProposalId' changed_path_count: type: integer minimum: 0 source_queries: type: array items: type: string allOf: - minLength: 1 - maxLength: 64 - pattern: ^[A-Za-z0-9_]+$ allOf: - maxItems: 20 required: - step - store - disposition - tree_hash - changed_path_count - source_queries additionalProperties: false AutomationStepSkillProposalReceipt: type: object properties: step: type: string allOf: - minLength: 1 - maxLength: 64 - pattern: ^[A-Za-z0-9_]+$ query_step: type: string allOf: - minLength: 1 - maxLength: 64 - pattern: ^[A-Za-z0-9_]+$ result: $ref: '#/components/schemas/AutomationSkillProposalReceipt' required: - step - query_step - result additionalProperties: false AutomationStepSkillProposalObservation: type: object properties: step: type: string allOf: - minLength: 1 - maxLength: 64 - pattern: ^[A-Za-z0-9_]+$ proposal_step: type: string allOf: - minLength: 1 - maxLength: 64 - pattern: ^[A-Za-z0-9_]+$ result: $ref: '#/components/schemas/AutomationSkillProposalObservation' required: - step - proposal_step - result additionalProperties: false AutomationStepJsonReceipt: type: object properties: step: type: string allOf: - minLength: 1 - maxLength: 64 - pattern: ^[A-Za-z0-9_]+$ input_bindings: $ref: '#/components/schemas/AutomationJsonInputBindings' policy_version: type: number enum: - 1 input_sha256: type: string pattern: ^sha256:[0-9a-f]{64}$ schema_sha256: type: string pattern: ^sha256:[0-9a-f]{64}$ output_sha256: type: string pattern: ^sha256:[0-9a-f]{64}$ required: - step - input_bindings - policy_version - input_sha256 - schema_sha256 - output_sha256 additionalProperties: false AutomationStepSkillReadReceipt: type: object properties: step: type: string allOf: - minLength: 1 - maxLength: 64 - pattern: ^[A-Za-z0-9_]+$ skill: $ref: '#/components/schemas/SkillId' version: type: integer allOf: - minimum: 1 maximum: 9007199254740991 required: - step - skill - version additionalProperties: false AutomationStepProcessingRecoveryReceipt: type: object properties: query_step: type: string allOf: - minLength: 1 - maxLength: 64 - pattern: ^[A-Za-z0-9_]+$ previous_firing: $ref: '#/components/schemas/AutomationFiringId' effect_firing: $ref: '#/components/schemas/AutomationFiringId' restored_steps: type: array items: type: string allOf: - minLength: 1 - maxLength: 64 - pattern: ^[A-Za-z0-9_]+$ allOf: - maxItems: 20 required: - query_step - previous_firing - effect_firing 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 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 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 minimum: 0 required: - status - output_count - accepted_count additionalProperties: false AutomationFiringOutcomeAttempt: type: object properties: iteration: type: integer minimum: 0 started_at_seq: anyOf: - type: integer minimum: 0 - type: 'null' result: anyOf: - $ref: '#/components/schemas/Union_159' - type: 'null' completed_at_seq: anyOf: - type: integer minimum: 0 - type: 'null' required: - iteration - started_at_seq - result - completed_at_seq additionalProperties: false FlowReviewId: type: string pattern: ^flrev_[0-9a-f]{32}$ Union_284: type: string enum: - evidence_unavailable - evidence_unsupported - evidence_too_large - source_erased - reviewer_unavailable 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 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 AutomationStepFailureReason: type: string pattern: ^[a-z][a-z0-9_]{0,127}$ AgentId: type: string pattern: ^agent_[0-9a-f]{32}$ AutomationSessionEvidenceRange: type: object properties: policy_version: type: string enum: - automation-session-range-1 frontier: anyOf: - $ref: '#/components/schemas/SessionEvidenceFrontier' - type: 'null' after_sequence: type: integer allOf: - minimum: 0 - maximum: 9007199254740991 through_sequence: type: integer allOf: - minimum: 0 - maximum: 9007199254740991 complete: type: boolean evidence_sha256: type: string pattern: ^sha256:[0-9a-f]{64}$ required: - policy_version - frontier - after_sequence - through_sequence - complete - evidence_sha256 additionalProperties: false MemoryStoreId: type: string pattern: ^memstore_[0-9a-f]{32}$ MemoryProposalId: type: string pattern: ^mprop_[0-9a-f]{32}$ AutomationSkillProposalReceipt: anyOf: - type: object properties: disposition: type: string enum: - drafted proposal: $ref: '#/components/schemas/SkillProposalId' content_sha256: type: string pattern: ^sha256:[0-9a-f]{64}$ usage: $ref: '#/components/schemas/Objects_77' required: - disposition - proposal - content_sha256 - usage additionalProperties: false - type: object properties: disposition: type: string enum: - empty proposal: type: 'null' content_sha256: type: 'null' usage: type: 'null' required: - disposition - proposal - content_sha256 - usage additionalProperties: false AutomationSkillProposalObservation: anyOf: - type: object properties: disposition: type: string enum: - empty proposal: type: 'null' content_sha256: type: 'null' required: - disposition - proposal - content_sha256 additionalProperties: false - type: object properties: disposition: type: string enum: - pending proposal: $ref: '#/components/schemas/SkillProposalId' content_sha256: type: string pattern: ^sha256:[0-9a-f]{64}$ required: - disposition - proposal - content_sha256 additionalProperties: false - type: object properties: disposition: type: string enum: - evidence proposal: $ref: '#/components/schemas/SkillProposalId' content_sha256: type: string pattern: ^sha256:[0-9a-f]{64}$ skill: $ref: '#/components/schemas/SkillId' version: type: integer exclusiveMinimum: 0 association: type: string enum: - recorded - observed required: - disposition - proposal - content_sha256 - skill - version - association additionalProperties: false AutomationJsonInputBindings: type: object additionalProperties: $ref: '#/components/schemas/AutomationAgentOutputBinding' allOf: - maxProperties: 32 SkillId: type: string pattern: ^skl_[0-9a-f]{32}$ Union_159: type: string enum: - satisfied - needs_revision - max_iterations_reached - failed - interrupted SessionEvidenceFrontier: type: object properties: event: $ref: '#/components/schemas/EventId' through_sequence: type: integer allOf: - exclusiveMinimum: 0 - maximum: 9007199254740991 primary_thread: anyOf: - $ref: '#/components/schemas/SessionThreadId' - type: 'null' required: - event - through_sequence - primary_thread additionalProperties: false description: >- committed Session event identity and inclusive sequence for frozen evidence; independent of directory change watermarks SkillProposalId: type: string pattern: ^skp_[0-9a-f]{32}$ AutomationAgentOutputBinding: type: object properties: source: anyOf: - type: object properties: kind: type: string enum: - trigger_payload required: - kind additionalProperties: false - type: object properties: kind: type: string enum: - agent_output step_id: type: string allOf: - minLength: 1 - maxLength: 64 - pattern: ^[A-Za-z0-9_]+$ required: - kind - step_id additionalProperties: false - type: object properties: kind: type: string enum: - data_output step_id: type: string allOf: - minLength: 1 - maxLength: 64 - pattern: ^[A-Za-z0-9_]+$ required: - kind - step_id additionalProperties: false pointer: type: string allOf: - maxLength: 512 - pattern: ^(?:\/(?:[^~/]|~[01])*)*$ required: - source - pointer additionalProperties: false EventId: type: string pattern: ^evt_[0-9a-f]{32}$ SessionThreadId: type: string pattern: ^sthr_[0-9a-f]{32}$ securitySchemes: bearerAuth: type: http scheme: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.