Skip to main content
DELETE
/
runbooks
/
{name}
Delete Runbook
curl --request DELETE \
  --url http://{host}:{port}/{basePath}/runbooks/{name} \
  --header 'Authorization: <api-key>'
{
  "apiVersion": "v1",
  "kind": "Status",
  "metadata": {
    "name": "runbook-disk-cleanup"
  },
  "status": {
    "code": 200,
    "message": "Runbook 'runbook-disk-cleanup' excluido com sucesso",
    "deletedAt": "2026-03-19T17:00:00Z",
    "deletedBy": "admin@empresa.com"
  }
}
​
name
string
required
Unique runbook name (e.g., runbook-disk-cleanup)
{
  "apiVersion": "v1",
  "kind": "Status",
  "metadata": {
    "name": "runbook-disk-cleanup"
  },
  "status": {
    "code": 200,
    "message": "Runbook 'runbook-disk-cleanup' excluido com sucesso",
    "deletedAt": "2026-03-19T17:00:00Z",
    "deletedBy": "admin@empresa.com"
  }
}

{
  "apiVersion": "v1",
  "kind": "Error",
  "error": {
    "code": 409,
    "message": "Runbook in use",
    "details": "The runbook 'runbook-oomkill-standard' is being used by incident INC-20260319-001 and cannot be deleted"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer token issued by the operator. Format: Authorization: Bearer <token>.

Path Parameters

​
name
string
required

Unique runbook name.

Example:

"runbook-disk-cleanup"

Response

Runbook deleted

​
apiVersion
string
Example:

"v1"

​
kind
string
Example:

"Status"

​
metadata
object
​
status
object