v1

latestOpenAPI 3.0.32026-07-222111928.0 KB

Revisions

Promote Revision

Promote a draft or historic revision to the live version. The live revision is the one used by triggers and new runs. Fails if the revision is already live, or if a draft revision still has an active builder run.

post/v2/revisions/{build_id}/promote

Path parameters

build_idstring uuid required

The build's unique identifier

Request body

revision_namestring

Optional display name to set on the promoted revision.

revision_descriptionstring nullable

Optional description for the promoted revision. Pass null to clear an existing description.

Response

Default Response

successboolean required