---
title: "Delete a Webhook"
method: DELETE
path: "/api/v1/webhooks/{webhookId}"
---

# Delete a Webhook

`DELETE /api/v1/webhooks/{webhookId}`

## Request

- Base URL: `https://charm.ing`
- URL: `https://charm.ing/api/v1/webhooks/{webhookId}`
- Auth: HTTP bearer

Session-gated; requires `app:write` on the webhook's app. Removes the Webhook; its secret stops working at once.

## Response `204`

Webhook deleted.

## Other responses

- `401`: Sign-in required.
- `404`: Webhook not found, or the caller lacks `app:write` on its app.

---

[API](https://skmtc.dev/charm/apis/charming-api.md) · [All operations](https://skmtc.dev/charm/apis/charming-api/llms.txt) · [OpenAPI document](https://skmtc.dev/charm/apis/charming-api/revisions/a9d06c419b3a?raw)
