Playbooks

Node types

Every node in a playbook canvas represents one unit of work. Here's the full reference.

Trigger

Every playbook has exactly one Trigger. It defines how the playbook starts.

Trigger kind	How to start
Chat	Say `Run [playbook name]` in any chat thread
Manual	Click Run in the Playbooks list
Schedule	Set a cron expression in the Trigger node properties

Note

Schedule triggers run with the workspace's stored credentials — no human is in the loop. All mutation steps still issue approval requests that must be pre-approved or auto-approved in the node settings.

Action

An Action node runs one capability step — a deploy, DNS write, log read, secret rotation, or any other operation DunOps supports. Configure it by choosing the provider, then the capability key.

Action node configuration

{
  type:       "action",
  provider:   "vercel",
  capability: "vercel.create-deployment",
  params: {
    project: "{{inputs.project}}",   // parameter reference
    branch:  "{{inputs.branch}}"
  }
}

Condition

A Condition node evaluates an expression against a previous step's output and routes to the true or false branch. Use it to retry on failure, skip steps for certain environments, or fan out to different providers.

Condition expression example

{{ steps.deploy.status === "succeeded" }}

Wait

A Wait node pauses the playbook until either a condition is met (polling a step output) or a timeout expires. Use it after a deploy to wait until the deployment is healthy before continuing.

Approval

An explicit Approval node surfaces a confirm card in chat — even if all other mutations in the playbook are auto-approved. Use it for high-stakes steps like a production database migration.

Tip

Most Action nodes already gate on approval. Add a standalone Approval node when you want a human checkpoint between steps — for example, after a staging smoke test and before the production deploy.

Next steps

Canvas reference →

How to build and connect nodes in the visual canvas.

Run from chat →

Trigger this playbook from a chat thread.