How do I run a playbook?
TL;DR: Open a playbook, go to the Play tab, fill in any required inputs, and click Run. Watch step-by-step progress on the visual graph. When the run completes, inspect logs and outputs for each step. You can also Pause a running playbook and Continue later on the same run.
Who this is for
Builders and Members with access to the playbook.
How do I start a manual run?
- Open a playbook from Collections or the Member Playbooks list.
- Switch to the Play tab.
- Enter any required inputs (parameters the playbook expects).
- Click Run.
- Watch the graph as each step executes — green for success, red for failure.
What happens during a run?
Each step runs in order. You see:
- Status — pending, running, success, failed, or Paused (
suspended) - Logs — stdout, errors, and debug output
- Outputs — data produced by each step, passed to the next
Can I pause a run?
Yes. Click Pause while a run is in progress — Ballet finishes the current step, then parks before the next one. Click Continue to resume on the same run ID. A Code step can also park mid-step with metaphor.waitForInput for human approval. See How do I pause and resume a playbook run?.
What if a step fails?
Click the failed step to read the error log. Builders can switch to the Code tab to fix the step, or ask the Console for help debugging.
Can I run the same playbook again?
Yes. Each new Run starts a new execution. Previous runs (including ones that were paused and continued) are saved in the History tab — Continue keeps the same History row.