---
title: "Delete a playbook by its ID"
method: DELETE
path: "/workspace/{ws_id}/playbooks/{id}"
tags: ["Workflows"]
---

# Delete a playbook by its ID

`DELETE /workspace/{ws_id}/playbooks/{id}`

Permanently delete a playbook identified by `id` from the current workspace.
If the playbook belongs to a primary shared pack, the matching linked replication playbooks are deleted as part of the same operation.
**Note**: Linked shared playbooks cannot be deleted directly; delete the corresponding primary playbook instead.

## Path parameters

- `id` string, required
- `ws_id` string, required

## Response `200`

The ID of the deleted playbook

- string

## Other responses

- `400` — Invalid request parameters or invalid delete operation
- `404` — Playbook not found

---

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