> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getthread.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Automagically: Approving Runbooks

> Approve new or updated Automagically runbooks before they run on clients: test in staging, review the AI summary and code diff, then approve or reject from the Approvals or Runbooks page.

> [!NOTE]
>
> 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.

> [!NOTE]
>
> 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.\
\\

![Image](https://mintcdn.com/thread/26HM8H2mz9Knxnai/images/image-56.png?fit=max\&auto=format\&n=26HM8H2mz9Knxnai\&q=85\&s=a4b96df9c4e65bb9ceecebb254ec2c2e)

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.

![Approvals Side Panel](https://mintcdn.com/thread/26HM8H2mz9Knxnai/images/approvals-side-panel.gif?s=1896150a810bea657074ca97154bf911)

**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.

  ![Approvals Panel Test Staging](https://mintcdn.com/thread/26HM8H2mz9Knxnai/images/approvals-panel-test-staging.gif?s=6cc03d8a4171d155d8e2c4ff90b17605)
* Directly from the runbook table.

  ![Approvals Test Modal](https://mintcdn.com/thread/26HM8H2mz9Knxnai/images/approvals-test-modal.gif?s=089c67f9a8873a34a6fcf59a5932ce11)

**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.\
\\

![Image](https://mintcdn.com/thread/26HM8H2mz9Knxnai/images/image-57.png?fit=max\&auto=format\&n=26HM8H2mz9Knxnai\&q=85\&s=7bedbed1e1ffe9dad439511fcd29d4c4)

## 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.\


![Image](https://mintcdn.com/thread/26HM8H2mz9Knxnai/images/image-59.png?fit=max\&auto=format\&n=26HM8H2mz9Knxnai\&q=85\&s=d36128ff08b35b7f08ad89373e19044e)

### 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.

![Runbooks Review Drawer](https://mintcdn.com/thread/26HM8H2mz9Knxnai/images/runbooks-review-drawer.gif?s=ffe69356a5faf3a2ba1977dd3b978386)

### 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.

![Runbooks New Version Review](https://mintcdn.com/thread/26HM8H2mz9Knxnai/images/runbooks-new-version-review.gif?s=bdd7624107d27bfff0bb3cb280f0df1e)

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.


## Related topics

- [Automagically: Building a Runbook](https://docs.getthread.com/automagically/building-a-runbook.md)
- [Modifying a Runbook](https://docs.getthread.com/automagically/modifying-a-runbook.md)
- [Automagically: Running Runbooks](https://docs.getthread.com/automagically/automagically-running-runbooks.md)