---
title: "Delete alert webhook"
method: DELETE
path: "/alerts/webhook/{webhook_id}"
---

# Delete alert webhook

`DELETE /alerts/webhook/{webhook_id}`

Delete an alert webhook by ID. Requires ownership for the authenticated customer. Returns the deleted webhook data (id, webhook_url, description, created_at). Requires admin or external-api-delete-alert-webhook-endpoint.

## Path parameters

- `webhook_id` string, uuid, required

## Headers

- `Access-Token` string, required
- `X-API-Key` string, required

## Response `200`

Webhook deleted successfully; returns deleted webhook data

- DeletedWebhookResponse — Deleted webhook data returned on successful DELETE (secret and enabled excluded)
  - `id` string, uuid, required
  - `webhook_url` string, uri, required
  - `description` string, nullable
  - `created_at` string, date-time, required
  - `deleted` boolean, required — Always true for delete response

## Other responses

- `400` — Bad Request – invalid webhook ID format
- `401` — Unauthorized – missing or invalid token
- `403` — Forbidden – insufficient permissions
- `404` — Not Found – webhook does not exist or does not belong to customer
- `500` — Internal Server Error

---

[API](https://skmtc.net/genlogs/apis/auth-api-create-token.md) · [All operations](https://skmtc.net/genlogs/apis/auth-api-create-token/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/genlogs/auth-api-create-token/versions/bf34c2431a21/schema)