Promote deployment

Moves the SAME immutable, environment-agnostic release artifact into targetEnvironment, re-checking that environment’s qualification gate. Requires cicd.promote plus authority on the target environment; the source deployment must be “active”. This is the step the ticket’s “Current Behavior” section says has no reachable public path once content arrived via the Import API instead of Artemis Git — reachable here because the release was built with source.kind=“project_snapshot”.

POST /api/cicd/v1/projects/{projectId}/deployments/{deploymentId}/promote

Error

A valid request URL is required to generate request examples

202

{
  "success": true,
  "deploymentId": "<string>",
  "jobId": "<string>",
  "statusUrl": "<string>",
  "jobStatusUrl": "<string>"
}

Promote an active deployment’s release to a higher environment.

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.

deploymentId · string · required

Body

application/json

targetEnvironment · enum<string> · required

Available options: dev, staging, production

bypassQualificationGate · boolean

Requires scope cicd.gate.bypass.

bypassReason · string

Response

202

application/json

Promotion started

success · boolean · required

deploymentId · string · required

Id of the (new) deployment this action created.

jobId · string · required

cicd-deploy-<deploymentId>.

statusUrl · string

jobStatusUrl · string