> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.itential.com/itential-gateway/4/ansible-add-a-new-playbook/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.itential.com/_mcp/server.

# Add a new playbook

> How to add new playbooks to Itential Gateway.

New playbooks must be added first before they can be viewed in Itential Gateway.

## Default location to add playbooks

The default location for custom content to add a playbook is `/usr/share/automation-gateway/ansible/playbooks`, or you can customize the folder path and add it to the `Configuration/Ansible/Playbook Paths` array. Once a playbook is copied or downloaded to a folder in the **Playbook Paths** array and the playbooks in Itential Gateway are refreshed, it will display.

![](</_fern-img/910af1b899e91878cb77fb6264dc263b862d5e2e3e4351be10e48df9f3b5625b.webp>)

## Add a playbook to Itential Gateway

Once a new playbook is added to Ansible, it can be added to Gateway.

#### Navigate to the API documentation

Navigate to the API Documentation within Gateway.

#### Find and expand the endpoint

Find and expand the `POST /playbooks/refresh`.

#### Try it out

Click **Try it out!**

#### Execute

Click **Execute** to re-sync the playbooks.

#### Verify the response code

Verify the response code. Response Code 200 indicates the retrieval was successful.

#### View the new playbook

Go back to the **Playbooks** section of Gateway to view the newly added playbook.

> **Info**
>
> If the execution output of an Ansible playbook run exceeds 1MB, Gateway doesn't display the raw output in the browser. You can download the output to your local system instead.

> How to add new playbooks to Itential Gateway.