---
title: "Soft-delete a runbook"
method: DELETE
path: "/runbooks/{runbookId}"
tags: ["Runbooks"]
---

# Soft-delete a runbook

`DELETE /runbooks/{runbookId}`

## Request

- Base URL: `https://api.marboba.com/v1`
- URL: `https://api.marboba.com/v1/runbooks/{runbookId}`
- Auth: HTTP bearer

Sets `isDeleted=true` rather than hard-deleting so historical references in incidents and the Activity feed survive. Requires admin scope (PAT only).

## Response `204`

Soft-deleted

## Other responses

- `403` (unresolved $ref)
- `404` (unresolved $ref)

---

[API](https://skmtc.dev/marboba/apis/marboba-public-rest-api.md) · [All operations](https://skmtc.dev/marboba/apis/marboba-public-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/marboba/apis/marboba-public-rest-api/revisions/5b96d525d88d?raw)