Skip to main content

Deploy release

POST 

/api/projects/:project_id/release/deploy

Deploys one step: everything waiting on from_stage_id moves to the next stage, or only the waiting changes listed in change_ids; answers 201 with the new release, or 200 with the step's release already open; a pick of only some waiting changes answers 409 open while a release into the stage is open, state when a listed change is not waiting, and 422 no_changes for an empty list. A freeze covering now answers 409 with code frozen and until, unless scheduled_for is later, or override_reason or through_freeze (no reason typed) runs it through the freeze; the caller must be allowed to deploy to the target stage (else 403), and a step whose ticket gate asks for a ticket when pressed needs ticket (else 422 ticket_required); a sign-off stage before the target that misses waiting changes answers 409 not_signed_off with their count, and a source stage still verifying its newest change 409 verifying with a reason. untested_reason, or untested with no reason typed, ships the stage's head without waiting for its tests, with the same right as override_reason and, for a typed reason, its minimum length (403 override_forbidden, 422 reason_short), never with change_ids (422 untested_pick) and never once the step's release is running or approved (409 open).

Request​

Responses​

Created