Flows
Create a flow
Create a workspace flow from a config. The config is validated exactly as the editor validates it, so an invalid graph is rejected here rather than failing later on every run.
POST
Create a flow
The config is validated exactly as the editor validates it, so an invalid graph is rejected here rather than failing later on every run. A workspace at its plan’s flow limit gets a
406.Headers
API Key for authentication
Body
application/json
Response
The created 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.