Overview
The Runbooks page lets you manage all your runbooks — create new ones, edit YAML, and track versions.Creating a runbook
Click New Runbook
From the runbooks list, click the New Runbook button (requires Developer role or above).
Editing a runbook
From the runbook detail page, you can:- Edit YAML — Modify the runbook definition directly
- Edit steps — View and modify individual steps
- Edit variables — Add, remove, or change variable definitions
Versioning
Runbooks support versioning to track changes over time:| Action | Description |
|---|---|
| Create version | Save current state as a new version |
| Publish version | Set a version as the active production version |
| Rollback | Revert to a previous version (Business+) |
| Plan | Max versions |
|---|---|
| Team | 10 |
| Business | 50 |
| Enterprise | Unlimited |
Running a runbook
From the runbook detail page:- Click Run to execute in normal mode
- Click Self-heal to run with aggressive retry and repair suggestions
- Provide any required variables and secrets
- Monitor the job in real-time on the Jobs page
Managing runbooks
| Action | Required role | Description |
|---|---|---|
| Create | Developer+ | Create a new runbook |
| Edit | Developer+ | Modify runbook content |
| Run | Member+ | Execute the runbook |
| Verify/Publish | Admin+ | Publish a runbook version |
| Duplicate | Developer+ | Create a copy |
| Delete | Admin+ | Permanently remove |