Skip to main content
POST
Move a workflow to a stage

Authorizations

Authorization
string
header
required

OAuth 2.0 authorization code flow with PKCE (S256). See the authorization guide.

Scopes

workflows:write

Start workflows, update their names, tags and roles, and move them between stages

Path Parameters

workflow_id
string<uuid>
required

Body

application/json

stage_id must belong to the run. from_stage_id is the current stage from the last GET, required to detect a stale move.

stage_id
string<uuid>
required
from_stage_id
string<uuid>
required

Response

The committed workflow id.

The committed workflow id. Fetch GET /workflows/{id} with workflows:read for its current state. A follow-up read failure never turns a committed write into a failed response.

id
string<uuid>
required