POST /projects/{projectId}/agent-deployments

POST /api/v1/projects/{projectId}/agent-deployments on the Caveman Cloud control plane. Requires the autopilot:manage scope. Not exposed to autonomous agents: Native user registration of immutable deployment source identity; requires autopilot:manage and repo:connect. Model and workload callers cannot mint deployment attribution. Native user endpoint. Scoped agent sessions and workload credentials cannot call this operation. Organization budget edits additionally require billing:write. Interactive grants bind current membership and role; input, audit, run and outbox admission commit atomically. Reuse the same request identity, input and deadline on retries.

post/projects/{projectId}/agent-deployments

Request

  • Base URL
    https://api.caveman.so/api/v1
  • URL
    https://api.caveman.so/api/v1/projects/{projectId}/agent-deployments
  • Auth
    • OAuth 2
      Authorization code: /api/v1/oauth/authorize
      Token URL: /api/v1/oauth/token scopes: autopilot:manage
    • or HTTP bearer
    • or API key in cookie cave_access
    • or API key in cookie __Secure-cave_identity.session_token

Request body

deployment_idstring required
binding_idstring uuid required
commit_shastring required
image_sha256string
config_sha256string

Response

Native operation persisted.

deployment_idstring required
binding_idstring uuid required
repository_idstring required
commit_shastring required
image_sha256string required
config_sha256string required
created_atstring date-time required

Changes

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