Skip to main content

Create a task

POST 
/api/v1/tasks

Creates a task bound to a workflow. By default the task is placed in the workflow's initial state; passing state places it directly in that named state instead — an alternate entry point for starting a task mid-flow (e.g. "a new recorte for an existing theme by id"), rather than re-submitting from the initial state and hoping a guard or similarity gate recognizes it. Entering the resulting state, initial or named, behaves identically: that state's on_enter automation fires and its stalled_after clock arms.

Request​

Responses​

The idempotency key already names a task created by the same request; that task is returned as it is now and no second task is created