Skip to main content

Create or replace a workflow's blueprint

PUT 
/v1/workflows/:workflow_id/blueprint

Create or replace a workflow's blueprint.

There are two modes. Attach: when workflow_id is a real workflow UUID, the blueprint is upserted onto it in place, and an unknown id returns 404. Blueprint-first: when the id is omitted or is a name rather than a UUID, a draft workflow shell is created to hold the sketch and its new workflow_id comes back — this is how you design a blueprint before any workflow exists.

The definition is accepted either as a nested blueprint object or as top-level blocks and edges, and is shape-validated either way.

Requires the workflows:author scope.

Request​

Responses​

Successful Response

Last updated on