📄️ List workflows

Lists the workflows in your organization, paginated.

📄️ Create a workflow

Creates a workflow. The request body is the definition document itself, not wrapped in any envelope.

Returns the workflow and one resolved revision: the latest by default, or the one selected with `revision` or `alias` (mutually exclusive).

Pushes a new version of the definition. The body can be the bare definition or `{ definition, mode }`, where `mode` controls versioning:

Updates record-level fields (name, description, path, metadata) without creating a revision. At least one field is required.

Deletes the workflow: it disappears from lists and reads, along with its revisions and aliases. The record is retained internally (soft delete).

Dry-run validation of a definition (graph shape plus step configs) with no writes. Always returns 200; inspect `valid` and `errors`.