Create release

Starts an async build (compiled IR, pinned entity versions, integrity hash, encrypted .ablenc bundle). source.kind="project_snapshot" captures the project’s CURRENT content — no Git integration required; source.kind="git" (or omitted) builds from a branch/tag/commit The build is environment-agnostic: it needs cicd.release.create plus project membership, NOT environment authority (authority is enforced at deploy/promote, not here).

POST /api/cicd/v1/projects/{projectId}/releases

Error

A valid request URL is required to generate request examples

200

{
  "success": true,
  "releaseId": "<string>",
  "statusUrl": "<string>",
  "reused": true,
  "status": "<string>",
  "version": "<string>",
  "requeued": true
}

Build an immutable release from Git, a project snapshot, or a cross-tenant transfer.

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

projectId · string · required

UUID v7; must be in the key/token's projectIds.

Body

application/json

source · object

Where the release content comes from. Omitted kind is the legacy Git contract.

Show child attributes

lob · string

Optional line-of-business tag.

developer · string

Optional free-text attribution.

version · string

Durable human release label (X.Y.Z), when versioning is enabled.

Response

200

application/json

An identical versioned release was reused (reused:true); a failed build may have been requeued.

success · boolean · required

releaseId · string · required

statusUrl · string · required

reused · boolean · required

status · string

version · string

requeued · boolean