Act on pipeline step
POST/api/projects/:project_id/pipeline/steps/:to_stage_id/act
Acts on the step into a stage: go presses it (Start, Move, Merge, or Deploy on a release, which scheduled_for schedules), approve or reject (an approver's, each with an optional comment), or cancel. A step on tasks takes subjects (task_ids, shas, or all_in_stage for every item of the stage before the step, rows never loaded included) and answers how many were done, which were refused and why, and how many wait for approvals; reject refuses an item not waiting for approvals as not_waiting. A release step acts on its release and answers a refusal with its status (403 for a caller the step does not allow, 409 not_signed_off while a sign-off stage before it misses changes, 409 verifying while the stage before it still verifies its newest change, 422 no_source for a step with no branch stage before it, and 409 no_release for approve, reject or cancel with no open release into the stage); override_reason on a go of a step that merges or deploys runs that one request through a freeze, audited (at least 10 characters, else 422 reason_short; a caller who may also edit the project, else 403 override_forbidden), and with any other verb answers 422 override_not_supported; a go on a step whose ticket gate asks when pressed needs ticket, a ticket key like OAM-123 (422 ticket_required without one, unless an open release into that stage already carries one; ticket_invalid for text that is not a key), a step that asks for none ignores it, and a field the body does not declare returns 422.
Request
Responses
- 200
- 422
OK
Unprocessable content