Skip to main content
POST
Create a workflow
Only flow_name and flow_data are required in the request body. The full structure of the flow_data document, including connections and expression syntax, is described in the flow_data reference, and every node type is documented in the node types reference.

Authorizations

x-api-key
string
header
required

Lyzr API key. Studio session keys (agk_, ags_) and durable sk- keys are accepted. Required on every endpoint except GET /node-types and a webhook-triggered execute that carries X-Webhook-Secret.

Body

application/json

Workflow definition. Only flow_name and flow_data are required.

flow_id
string
flow_name
string
Example:

"Document Processing Flow"

flow_data
object

Workflow graph definition as JSON (nodes, connections, and node configuration). See the flow_data reference for the full structure and the node types reference for every node type.

Example:
version
integer
is_owner
boolean

Computed per response so the UI can distinguish owned rows from shared rows without seeing the owner's key. Not persisted.

user_id
string
org_id
string
created_at
string
updated_at
string

Response

Created

flow_id
string
Example:

"wf_9f2c1a"

issues
object[]

Validation issues found when saving. The save succeeds even when errors are present; fix them before you run the workflow.