---
title: "Delete Webhook"
method: DELETE
path: "/api/v2/webhooks/{id}"
tags: ["Webhooks"]
---

# Delete Webhook

`DELETE /api/v2/webhooks/{id}`

Deletes a webhook. Blocked with a 409 while any alert still references it — reassign or remove those alerts first — so deletion never leaves an alert pointing at a missing webhook (which would silently drop notifications). Mirrors the internal webhook delete guard.

## Path parameters

- `id` string, required

## Response `200`

Successfully deleted webhook

- EmptyResponse

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Webhook not found
- `409` — Webhook is still referenced by one or more alerts

## Changes

- **2026-07-08** `6f4381730123` — 1 info
  - endpoint added
- **2026-01-30** `ed852374c451` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/hyperdxio/apis/hyperdx-external-api/changes/api/v2/webhooks/:id/delete.md)

---

[API](https://skmtc.dev/hyperdxio/apis/hyperdx-external-api.md) · [All operations](https://skmtc.dev/hyperdxio/apis/hyperdx-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hyperdxio/hyperdx-external-api/revisions/64d5eaeb9f56/schema)