v16

latestOpenAPI 3.1.1raw.githubusercontent.com2026-08-0124102197.4 KB
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

workspaceIdstring cuid2 required
namestring required
descriptionstring nullable
status'draft'

New workflows are created as drafts in Scope 1.

Response

Workflow created successfully