Deployments

Atomic project release deployment.

Operations

Each operation lists its specific responses. See Common error responses for errors shared by every operation on this page.

Bootstrap this unclaimed instance with an issuer-owned ProjectUID

POST /api/v1/instance/project-claim

Operation ID: bootstrapProjectClaim
Effect: write
Confirmation: conditional
Required privilege: PROJECT_ADMIN
Focused reference: JSON · Markdown

Parameters

Request body

Content types: application/json.

Responses

Upload a missing immutable private-candidate source blob

PUT /api/v1/projects/{project}/candidate-sync/blobs/{digest}

Operation ID: uploadProjectCandidateSourceBlob
Effect: idempotent-write
Confirmation: conditional
Required privilege: RESOURCE_EDIT
Focused reference: JSON · Markdown

Parameters

Request body

Content types: application/octet-stream.

Responses

Plan content-addressed synchronization for the current author's private candidate

POST /api/v1/projects/{project}/candidate-sync/plan

Operation ID: planProjectCandidateSynchronization
Effect: write
Confirmation: conditional
Required privilege: RESOURCE_EDIT
Focused reference: JSON · Markdown

Parameters

Request body

Content types: application/json.

Responses

Retain an exact source snapshot without preparing a candidate

POST /api/v1/projects/{project}/candidate-sync/source

This source-only operation stores immutable bytes for a later target-owned delivery plan. It must not create a candidate, acquire physical credentials, or perform catalog work.

Operation ID: retainProjectCandidateSource
Effect: write
Confirmation: conditional
Required privilege: RESOURCE_EDIT
Focused reference: JSON · Markdown

Parameters

Request body

Content types: application/json.

Responses

Common error responses

These error responses apply to every operation on this page.