Workflow Actions
Validate Workflow Graph
Validate a node/edge graph without saving anything. Checks that the graph has exactly one trigger node, that every edge references existing nodes, and that every non-trigger node has an incoming connection.
Publish Workflow
Publish a workflow so its trigger becomes live. The graph is validated first - on failure nothing changes and the validation errors are returned with status 422. On success the version number is incremented, `publishedAt` is set, and the trigger type/configuration are re-derived from the graph.
Toggle Workflow
Toggle a workflow between `published` (trigger live) and `disabled` (trigger paused). Only workflows in one of those two states can be toggled - draft workflows must be published first.
Clone Workflow
Duplicate a workflow as a new Draft. The clone copies the graph, settings, and trigger configuration, and is named '<name> (Copy)'.
Execute Workflow
Manually run a published workflow. The run is queued asynchronously: the response returns the new execution record immediately (status `pending`) - poll Get Workflow Execution for progress and step-by-step results.
Upload File and Run Workflow
Upload a file to a published workflow that has a File Upload trigger as its entry node, and run the workflow against it. The request is a `multipart/form-data` upload with a single `file` field.