Replace a flow
Replace the whole flow. To change one node without resending the graph — and without risking the rest of it — use PATCH /v1/flows/{flow_id}/config instead.
Headers
API Key for authentication
Path Parameters
Flow identifier, e.g. fl_ab12cd34
Body
Whole-flow replace. internal_version must be the value the last GET /v1/flows/{flow_id} returned.
Display name of the flow.
Flow definition: {inputs: [...], nodes: [...], output: {...}}. Copy the shape of an existing flow from GET /v1/flows/{flow_id}.
Editor-only metadata. The runtime ignores it.
Response
The updated flow
A flow plus the pieces needed to edit it. config is the graph, ui is editor-only metadata the runtime ignores, and internal_version is the concurrency token you send back on a write.
The flow definition: inputs, nodes, output.
Editor-only metadata. The runtime never reads it.
Concurrency token. Send it back on PUT (required) and on PATCH when changing config.