> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.ada.cx/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.ada.cx/_mcp/server.

# Playbooks API is available

The [Playbooks API](/reference/playbooks/overview) provides create, read, update, and delete access to an AI Agent's Playbooks. Playbooks are the structured, step-based workflows that guide the Agent through multi-step conversations. Manage Playbooks through code and version control instead of only through the dashboard.

## API endpoints

Five REST endpoints are available:

* **List Playbooks** (`GET /v2/playbooks/`): Returns the AI Agent's Playbooks, enabled or not, in cursor-paginated pages ordered by `id`.
* **Create a Playbook** (`POST /v2/playbooks/`): Creates a Playbook. New Playbooks default to draft.
* **Get a Playbook** (`GET /v2/playbooks/{playbook_id}`): Returns a single Playbook by its `id`.
* **Update a Playbook** (`PATCH /v2/playbooks/{playbook_id}`): Partially updates a Playbook in place; only the fields in the request body change.
* **Delete a Playbook** (`DELETE /v2/playbooks/{playbook_id}`): Deletes a Playbook, and returns `409` when another Playbook's `run` step targets it.

Each Playbook can carry an availability rule that gates when the Agent uses it. Rules reference variables by `id`.

Setting `enabled: true` validates the step graph, the variable scopes, and the condition operators before the Playbook goes live. A Playbook that fails validation is not saved.

## Get started

* [Playbooks API reference](/reference/playbooks/overview) for fields, step types, limits, pagination, and authentication.