Skip to main content
POST
Create flow

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
folderId
string | null
required

Folder id (numeric string) to create the flow in, or null for no folder.

Pattern: ^\d+$
name
string
required

Flow name.

Required string length: 1 - 255
spec
object

Flow-spec DSL document compiled server-side into the draft's nodes/edges (see GET /v1/schemas/flow-spec). Mutually exclusive with nodes/edges.

nodes
object[]

Raw node graph. position/measured are optional — omitted positions are laid out automatically — and each node's id is a request-scoped token for wiring edges, remapped to a real persisted id server-side. Mutually exclusive with spec.

Minimum array length: 1
edges
object[]

Edges between nodes. Requires nodes.

publish
boolean

Validate the supplied graph exactly like flows.publish and create the flow's first version immediately. Requires spec or nodes.

Response

OK

id
string
required
nodeIds
object

Authored node id → persisted node id, present only when the request sent raw nodes (omitted for spec input, which has no authored ids).