Skip to main content
Automagically is currently in a closed beta.
Every new or updated runbook needs to be approved before it can be run on a client. Someone with runbook approval permission must test the runbook in staging, review the code changes, and then approve or reject it.
This is different from approving a pending execution, which is a technician approving a pre-filled run from the Triage Agent. This article is about approving the runbook itself.

Approving from the Approvals page

1

Open a runbook waiting for approval

Navigate to the Approvals page. The badge shows how many runbooks are waiting for review.
Approvals page listing runbooks waiting for review, with the pending count badge and Test and Review buttons
Click a row to open its review panel. This is where you review the changes, test the runbook in staging, and approve or reject it.
Clicking a row on the Approvals page opens the runbook review panel
2

Test the new runbook in staging

Testing runs against your staging tenant, so you don’t need to select a client or a ticket.There are two ways to test the runbook:
  • From inside the review changes panel.
    Clicking Test in staging inside the review panel runs the runbook against the staging tenant
  • Directly from the runbook table.
Clicking Test on a row in the Approvals table opens the staging test form
3

Review and approve (or reject)

Review the changes in the review panel:
  • AI summary: a plain language explanation of what changed, so you can understand it quickly without reading the code.
  • Code diff: the exact lines added, removed, or modified compared to the current version, for a closer look.
Once the test passes and you’re satisfied with the changes, approve the runbook from the review panel. If the changes aren’t right, reject it instead.
Runbook review panel with Test in staging, Reject all changes and Approve all changes buttons

Approving from the Runbooks page

You can approve runbook changes directly from the Runbooks page, either from their tile on the Runbooks page, or from the runbook details page. Navigate to the Runbooks page and find an active runbook with a “review changes” banner, or a brand new runbook in the Needs approval tab.
Runbooks page with a Changes pending banner and Review link on a runbook tile

From the runbook tile

Click Review on the banner and continue the review process from there: test the runbook in staging, review the changes, and approve or reject it, as described in the previous section.
Clicking Review on a runbook tile banner opens the review changes panel

From the runbook details page

Open the runbook to go to its details page. If a new version is waiting for approval, a banner appears at the top of the page.
Runbook details page showing the new version banner and the Review button that replaces Run
Click Go to new version to open it. On that version, the Run button at the top right becomes Review. Click Review and continue the review process from there, the same way as above.