Delete Webhook

Permanently delete a webhook from your account.

Endpoint

DELETE /api/v1/webhooks/{id}
Host: api.driftguard.dev

Permanently removes a webhook from your account. Once deleted, DriftGuard will immediately stop delivering check results to that endpoint. This action is irreversible.

Unlike API keys, webhooks do not need to be deactivated before deletion. You can delete an active webhook directly.

---

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	The webhook ID to delete — from GET /api/v1/webhooks

---

Request

curl -s -X DELETE https://api.driftguard.dev/api/v1/webhooks/your_webhook_id_here \
  -H "X-API-Key: $DRIFTGUARD_KEY"

---

Response

{
  "id": "your_webhook_id_here",
  "deleted": true
}

Response Fields

Field	Type	Description
id	string	The webhook that was permanently deleted
deleted	boolean	Always true on a successful delete

---

Error Responses

Status	Meaning
401	Missing or invalid X-API-Key
404	Webhook not found, or belongs to a different user
429	Rate limit exceeded — 100 req/min per key

---

If you want to temporarily stop deliveries without losing the webhook configuration, note that a pause/deactivate endpoint is not yet available. Your options today are to delete and recreate, or to point the webhook at a URL that returns 2xx without acting on the payload.

List Webhooks

View all webhooks and their IDs before deleting.

Create Webhook

Register a new webhook after deleting the old one.