CAcaveman

Read a revision with its files

GET /api/v1/code/automations/{automationId}/revisions/{revisionId} on the Caveman Cloud control plane. Requires the code:read scope. Not exposed to autonomous agents: Cloud automations are applied from a repository's .caveman/ files by the Code app, a code:run key or a push to the default branch, and a person approves wider authority (ADR 0133). An agent works inside a run's session and never applies, approves, enables or fires automations from a control-plane connection.

get/code/automations/{automationId}/revisions/{revisionId}

Request

  • Base URL
    https://api.caveman.so/api/v1
  • URL
    https://api.caveman.so/api/v1/code/automations/{automationId}/revisions/{revisionId}
  • Auth
    • OAuth 2
      Authorization code: /api/v1/oauth/authorize
      Token URL: /api/v1/oauth/token scopes: code:read
    • or HTTP bearer
    • or API key in cookie cave_access
    • or API key in cookie __Secure-cave_identity.session_token

Response

The revision

idstring uuid required
automation_idstring uuid required
sha256string required
commit_shastring required
state'active' | 'pending_approval' | 'superseded' required
source'api' | 'push' required
authorityobject required

The authority-bearing keys Cloud read: host, on, triggers, outputs, output_config (where and how each output posts), engines, agents, secrets, mcp, budget.

created_by_user_idstring uuid nullable
created_by_service_account_idstring uuid nullable
approved_by_user_idstring uuid nullable
approved_atstring date-time nullable
activated_atstring date-time nullable
created_atstring date-time required
filesobject

The revision's files by path; on a single revision read.

Changes

No recorded changes to this operation across all 1 revision of this API.