> ## 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. > ## Agent Instructions > Base URL: https://api.checkfu.com. Current wire version: `2026-08-31` (`Checkfu-Version: 2026-08-31`). > Mutating HTTP requests require `Authorization: Bearer $CHECKFU_API_KEY`, `Checkfu-Version: 2026-08-31`, `Content-Type: application/json`, and `Idempotency-Key` on retriable writes. Ordinary API keys are Workspace-bound; do not send a Workspace selector header. > Core workflow: create an Agent (`POST /v1/agents`) and Environment (`POST /v1/environments`), grant `use_environment` (`POST /v1/permission-assignments`), create a Session (`POST /v1/sessions`), send events (`POST /v1/sessions/{id}/events`), stream progress (`GET /v1/sessions/{id}/events/stream`), and read the input result (`GET /v1/sessions/{id}/inputs/{input_id}/result`). > Domain model: an Agent is mutable configuration; a Session freezes its AgentVersion and Environment at creation and owns its private workspace and ordered event history. Vault stores secret credentials; Connection links an external account; ActionApproval records human approval before an action runs. > Capability status combines `audience`, `stability`, `availability`, evaluated prerequisites, and release evidence; check https://docs.checkfu.com/getting-started/status (`GET /v1/support/capabilities`) for live `available` status. # List an Automation's versions > List the published versions of an Automation written as blocks, newest first and one page at a time, each with its number, kind, when and by whom it was… ## OpenAPI ````yaml /openapi.json get /v1/automations/{id}/versions 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: skillProposals - name: instructionProposals - name: catalog - name: concepts - name: support - name: connections - name: connectionAssignments - name: connectedRuntimes - name: fileTrees - name: collaboration - name: automationGraphs - name: automations - name: actionApprovals - name: standingApprovals - name: workloadReviewPolicies - name: usage - name: models - 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: environments - name: vaults - name: apiMcp - name: a2a paths: /v1/automations/{id}/versions: get: tags: - automations summary: List an Automation's versions description: >- List the published versions of an Automation written as blocks, newest first and one page at a time, each with its number, kind, when and by whom it was published, and its document. Every run records the version it ran as its definition_revision. Versions are never edited. An Automation not written as blocks has none. 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.listAutomationVersions parameters: - name: id in: path schema: $ref: '#/components/schemas/AutomationId' required: true - name: checkfu-version in: header schema: type: string enum: - '2026-08-31' required: true - name: limit in: query schema: type: integer minimum: 1 required: false - name: page in: query schema: type: string pattern: ^c1_[0-9a-z]+$ required: false responses: '200': description: AutomationVersionPage content: application/json: schema: $ref: '#/components/schemas/AutomationVersionPage' headers: checkfu-workspace-id: description: The Workspace resolved from the authenticated bearer credential. required: true schema: $ref: '#/components/schemas/WorkspaceId' '400': description: Typed Checkfu wire error content: application/json: schema: $ref: '#/components/schemas/ValidationMalformedError' '401': description: Typed Checkfu wire error content: application/json: schema: type: object properties: type: type: string enum: - error error: type: object properties: type: type: string enum: - authentication_error code: 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. required: - type - code - message - more additionalProperties: false request_id: type: string allOf: - minLength: 1 required: - type - error - request_id 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 properties: type: type: string enum: - error error: type: object properties: type: type: string enum: - permission_error code: 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 - code - message - more additionalProperties: false request_id: type: string allOf: - minLength: 1 required: - type - error - request_id 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 properties: type: type: string enum: - error error: type: object properties: type: type: string enum: - rate_limit_error code: 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. required: - type - code - message - more additionalProperties: false request_id: type: string allOf: - minLength: 1 required: - type - error - request_id 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: AutomationId: type: string pattern: ^auto_[0-9a-f]{32}$ AutomationVersionPage: type: object properties: data: type: array items: $ref: '#/components/schemas/AutomationVersion' next_page: anyOf: - type: string - type: 'null' required: - data - next_page additionalProperties: false WorkspaceId: type: string pattern: ^wrkspc_[0-9a-f]{32}$ ValidationMalformedError: type: object properties: error: additionalProperties: false type: object properties: type: type: string enum: - invalid_request_error 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. code: type: string enum: - validation.malformed required: - type - message - more - code type: type: string enum: - error request_id: type: string allOf: - minLength: 1 required: - error - type - request_id additionalProperties: false description: >- The request could not be decoded or violated a declared input constraint. PolicyDeniedError: type: object properties: error: additionalProperties: false type: object properties: type: type: string enum: - permission_error 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. code: type: string enum: - policy.denied required: - type - message - more - code type: type: string enum: - error request_id: type: string allOf: - minLength: 1 required: - error - type - request_id additionalProperties: false description: Deployment governance or retention policy denied the request. ValidationNotFoundError: type: object properties: error: additionalProperties: false type: object properties: type: type: string enum: - not_found_error 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. code: type: string enum: - validation.not_found required: - type - message - more - code type: type: string enum: - error request_id: type: string allOf: - minLength: 1 required: - error - type - request_id additionalProperties: false description: >- The requested resource does not exist in the resolved deployment boundary. RuntimeInternalError: type: object properties: error: additionalProperties: false type: object properties: type: type: string enum: - api_error 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. code: type: string enum: - runtime.internal required: - type - message - more - code type: type: string enum: - error request_id: type: string allOf: - minLength: 1 required: - error - type - request_id additionalProperties: false description: >- An unexpected internal failure occurred; the message contains an opaque incident reference. AutomationVersion: type: object properties: type: type: string enum: - automation_version automation_id: type: string version: type: integer kind: type: string enum: - live - test published_at: type: string published_by: $ref: '#/components/schemas/AutomationPublisher' document: $ref: '#/components/schemas/AutomationBlockDocument_1' required: - type - automation_id - version - kind - published_at - published_by - document additionalProperties: false AutomationPublisher: anyOf: - type: object properties: type: type: string enum: - person principal_id: $ref: '#/components/schemas/PrincipalId' required: - type - principal_id additionalProperties: false - type: object properties: type: type: string enum: - api_key api_key_id: $ref: '#/components/schemas/ApiKeyId' required: - type - api_key_id additionalProperties: false AutomationBlockDocument_1: type: object properties: name: type: string allOf: - maxLength: 200 runs_as: type: string allOf: - maxLength: 128 environment_id: $ref: '#/components/schemas/EnvironmentId' blocks: $ref: '#/components/schemas/Arrays_37' wires: $ref: '#/components/schemas/Arrays_39' run_limits: type: object properties: deadline_seconds: type: integer max_concurrent_children: type: integer budget: type: object properties: limit: type: number metric: type: string enum: - model_spend - model_tokens required: - limit additionalProperties: false additionalProperties: false required: - name - runs_as - blocks - wires additionalProperties: false description: >- An automation document: a trigger block and the blocks it starts, connected by wires. PrincipalId: type: string pattern: ^prin_[0-9a-f]{32}$ ApiKeyId: type: string pattern: ^akey_[0-9a-f]{32}$ EnvironmentId: type: string pattern: ^env_[0-9a-f]{32}$ Arrays_37: type: array items: $ref: '#/components/schemas/AutomationBlock' allOf: - maxItems: 64 Arrays_39: type: array items: $ref: '#/components/schemas/AutomationBlockWire' allOf: - maxItems: 256 AutomationBlock: anyOf: - type: object properties: id: type: string allOf: - maxLength: 128 name: type: string allOf: - maxLength: 200 type: type: string enum: - trigger trigger: $ref: '#/components/schemas/AutomationBlockTrigger' required: - id - type - trigger additionalProperties: false - $ref: '#/components/schemas/Objects_216' - type: object properties: id: type: string allOf: - maxLength: 128 name: type: string allOf: - maxLength: 200 type: type: string enum: - model route: $ref: '#/components/schemas/Objects_217' prompt: type: string allOf: - maxLength: 65536 format: anyOf: - $ref: '#/components/schemas/Objects_218' - type: object properties: type: type: string enum: - pick_one options: type: array items: type: string allOf: - maxLength: 128 allOf: - maxItems: 20 required: - type - options additionalProperties: false - $ref: '#/components/schemas/Objects_219' - $ref: '#/components/schemas/Objects_220' - $ref: '#/components/schemas/Objects_221' required: - id - type - route - prompt - format additionalProperties: false - type: object properties: id: type: string allOf: - maxLength: 128 name: type: string allOf: - maxLength: 200 type: type: string enum: - if cases: type: array items: type: object properties: id: type: string allOf: - maxLength: 128 when: anyOf: - type: object properties: all: $ref: '#/components/schemas/Arrays_38' any: false required: - all additionalProperties: false - type: object properties: any: $ref: '#/components/schemas/Arrays_38' all: false required: - any additionalProperties: false required: - id - when additionalProperties: false allOf: - maxItems: 20 required: - id - type - cases additionalProperties: false - $ref: '#/components/schemas/Objects_222' AutomationBlockWire: type: object properties: from: type: string allOf: - maxLength: 128 to: type: string allOf: - maxLength: 128 port: type: string allOf: - maxLength: 128 max_attempts: type: integer required: - from - to additionalProperties: false AutomationBlockTrigger: anyOf: - $ref: '#/components/schemas/Objects_212' - $ref: '#/components/schemas/Objects_213' - type: object properties: type: type: string enum: - webhook dedupe_pointer: type: string allOf: - maxLength: 512 filter: $ref: '#/components/schemas/Arrays_38' required: - type - dedupe_pointer additionalProperties: false - $ref: '#/components/schemas/Objects_214' - $ref: '#/components/schemas/Objects_215' Objects_216: type: object properties: id: type: string allOf: - maxLength: 128 name: type: string allOf: - maxLength: 200 type: type: string enum: - agent agent: type: string allOf: - maxLength: 128 prompt: type: string allOf: - maxLength: 65536 output_schema: $ref: '#/components/schemas/AutomationBlockJsonObject' budget: type: object properties: limit: type: number metric: type: string enum: - model_tokens - model_spend - session_runtime_ms - web_search_requests - total_spend required: - limit additionalProperties: false for_each: type: object properties: items: type: string allOf: - maxLength: 1024 max_items: type: integer concurrency: type: integer required: - items - max_items additionalProperties: false required: - id - type - agent - prompt additionalProperties: false Objects_217: type: object properties: profile: type: string allOf: - maxLength: 128 tier: type: string enum: - default - planning - tool_loop required: - profile additionalProperties: false Objects_218: type: object properties: type: type: string enum: - yes_no required: - type additionalProperties: false Objects_219: type: object properties: type: type: string enum: - score levels: type: integer pass_at: type: integer required: - type - levels additionalProperties: false Objects_220: type: object properties: type: type: string enum: - extract schema: $ref: '#/components/schemas/AutomationBlockJsonObject' required: - type - schema additionalProperties: false Objects_221: type: object properties: type: type: string enum: - text required: - type additionalProperties: false Arrays_38: type: array items: $ref: '#/components/schemas/AutomationBlockComparison' allOf: - maxItems: 20 Objects_222: type: object properties: id: type: string allOf: - maxLength: 128 name: type: string allOf: - maxLength: 200 type: type: string enum: - resource resource: $ref: '#/components/schemas/AutomationBlockResource' ask_first: type: object properties: approver: type: string allOf: - maxLength: 128 required: - approver additionalProperties: false required: - id - type - resource additionalProperties: false Objects_212: type: object properties: type: type: string enum: - schedule cron: type: string allOf: - maxLength: 255 timezone: type: string allOf: - maxLength: 64 required: - type - cron - timezone additionalProperties: false Objects_213: type: object properties: type: type: string enum: - once at: type: string allOf: - maxLength: 64 required: - type - at additionalProperties: false Objects_214: type: object properties: type: type: string enum: - app_event connection_id: type: string allOf: - maxLength: 128 event: type: string allOf: - maxLength: 256 arguments: $ref: '#/components/schemas/AutomationBlockJsonObject' resource: type: string allOf: - maxLength: 512 required: - type - connection_id - event additionalProperties: false Objects_215: type: object properties: type: type: string enum: - manual required: - type additionalProperties: false AutomationBlockJsonObject: type: object additionalProperties: description: >- A value in the JSON data model: null, boolean, finite number, string, array, or object. allOf: - x-checkfu-json-budget: maximumBytes: 65536 maximumDepth: 64 maximumNodes: 5000 maximumInspectionWork: 20000 x-checkfu-unicode-scalar-values: true allOf: - x-checkfu-json-budget: maximumBytes: 65536 maximumDepth: 64 maximumNodes: 5000 maximumInspectionWork: 20000 x-checkfu-unicode-scalar-values: true - maxProperties: 5000 description: A JSON object, such as tool arguments or a JSON Schema. AutomationBlockComparison: type: object properties: field: type: string allOf: - maxLength: 1024 op: $ref: '#/components/schemas/Union_262' value: anyOf: - $ref: '#/components/schemas/Union_263' - type: array items: $ref: '#/components/schemas/Union_263' allOf: - maxItems: 50 required: - field - op additionalProperties: false AutomationBlockResource: anyOf: - type: object properties: type: type: string enum: - sessions agent: type: string allOf: - maxLength: 128 limit: type: integer required: - type - agent - limit additionalProperties: false - type: object properties: type: type: string enum: - memory_store action: type: string enum: - read id: type: string allOf: - maxLength: 128 path: type: string allOf: - maxLength: 1024 required: - type - action - id - path additionalProperties: false - type: object properties: type: type: string enum: - memory_store action: type: string enum: - write id: type: string allOf: - maxLength: 128 path: type: string allOf: - maxLength: 1024 content: type: string allOf: - maxLength: 65536 mode: type: string enum: - create - update expected_sha256: type: string allOf: - maxLength: 1024 required: - type - action - id - path - content - mode additionalProperties: false - type: object properties: type: type: string enum: - skill action: type: string enum: - read id: type: string allOf: - maxLength: 128 version: type: string allOf: - maxLength: 128 required: - type - id additionalProperties: false - type: object properties: type: type: string enum: - file action: type: string enum: - read file_id: type: string allOf: - maxLength: 1024 required: - type - action - file_id additionalProperties: false - type: object properties: type: type: string enum: - file action: type: string enum: - write filename: type: string allOf: - maxLength: 256 mime_type: type: string enum: - application/json - text/plain - text/markdown content: type: string allOf: - maxLength: 65536 required: - type - action - filename - mime_type - content additionalProperties: false - type: object properties: type: type: string enum: - connection connection_id: type: string allOf: - maxLength: 128 tool: type: string allOf: - maxLength: 256 arguments: $ref: '#/components/schemas/AutomationBlockJsonObject' required: - type - connection_id - tool additionalProperties: false Union_262: type: string enum: - equals - not_equals - contains - exists - gt - gte - lt - lte - one_of Union_263: anyOf: - type: string - type: number - type: boolean securitySchemes: bearerAuth: type: http scheme: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.