---
title: "Update playbook"
method: PUT
path: "/v1/playbooks/{playbook_id}"
tags: ["Playbooks"]
---

# Update playbook

`PUT /v1/playbooks/{playbook_id}`

Update an existing team playbook. Requires ManageOrgPlaybooks permission.
Only team playbooks can be updated.

## Path parameters

- `playbook_id` string, required

## Request body

- CreatePlaybookRequest — Request body for creating or updating a playbook
  - `title` string, required — The title of the playbook
  - `body` string, required — The content/instructions of the playbook
  - `macro` string, nullable — Optional macro shortcut for the playbook (e.g., !deploy)

## Response `200`

Playbook updated successfully

- object
  - `status` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized - Invalid or missing API key
- `403` — Forbidden - User does not have permission to access the resource
- `404` — Resource not found

---

[API](https://skmtc.net/devin/apis/devin-external-api.md) · [All operations](https://skmtc.net/devin/apis/devin-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/devin/devin-external-api/versions/bb0fabac5cbe/schema)