Workflows

Author, inspect and run automation workflows programmatically — the same workflows the visual builder produces. Discover node types and their schemas, compile and validate a YAML spec without saving it, create or edit workflows through the builder's own path, control their lifecycle, and debug executions node by node. Workflows are always created as drafts, so nothing you author starts firing until you activate it.

📄️ List available workflow node types

List every workflow node type available to your organization, grouped by

📄️ Get a node type's schema + output handles

Get one node type's full configuration schema: every field it accepts, which

📄️ How to write the YAML authoring spec

Return the workflow authoring specification — the reference for the YAML

📄️ Compile + validate a spec or definition (no save)

Compile and validate a workflow without saving anything.

📄️ Search marketplace workflow templates

Search the marketplace for prebuilt workflow templates to start from.

📄️ List the org's workflows

List your organization's workflows as light summaries — id, name, description,

📄️ Create a workflow from a YAML spec

Create a workflow from a YAML `spec`.

📄️ Import a marketplace template as a new workflow

Instantiate a marketplace template as a new workflow in your organization.

📄️ Run (test) a workflow by name — confirm-gated

Run a workflow immediately, looked up by `name` instead of id.

📄️ Execute one node in isolation — confirm-gated

Execute a single node in isolation, with no saved workflow involved.

📄️ Get one execution's full detail

Inspect one execution in detail: per-node status, which node failed, the

📄️ List workflows exposed as curated MCP tools

List the workflows your organization has exposed as curated MCP tools.

📄️ Read a workflow as the editable YAML spec

Read a workflow back as the editable YAML spec, together with its metadata.

📄️ Edit a workflow with granular operations

Apply granular edit operations to an existing workflow instead of

📄️ Delete a workflow

Delete a workflow permanently.

📄️ Activate a workflow (fires on its triggers)

Activate a workflow so it starts firing on its triggers.

📄️ Deactivate a workflow (stops firing)

Deactivate a workflow so it stops firing on its triggers.

📄️ Run (test) a workflow now — confirm-gated

Run a workflow immediately by id.

📄️ List a workflow's recent executions

List a workflow's recent executions, newest first, with status, trigger source

📄️ Expose/unexpose a workflow as a curated MCP tool

Expose a workflow as a curated MCP tool, or withdraw it.