V3 Workflows
Create a workflow
Creates a draft workflow. The workflow definition is the public source of truth used by the dashboard and external clients, following the document-first pattern established by the v3 Survey API. Runtime persistence, revision creation, and version snapshotting are implementation details behind this contract.
Workflows are always created as drafts; use POST /api/v3/workflows/{workflowId}/enable to make them respond to trigger events. Graph reference failures (duplicate node ids, edges pointing at missing nodes, entryNodeId not referencing the trigger, unknown surveyId or endingCardIds in the workspace) are rejected with 400 and structured invalid_params.
post/api/v3/workflows
Request body
Response
Workflow created successfully