Delete a webhook endpoint
DELETE /v1/webhook-endpoints/{endpoint_id} · permission webhook-endpoints:write · all plans
Deletes an endpoint. Its pending and retrying deliveries are cancelled in the same transaction; the delivery history stays for its 30-day retention. If-Match is required; * deletes whatever version is stored.
Request
| Field | Type | Required | Description |
|---|---|---|---|
endpoint_id |
path | yes | Webhook endpoint ID (whe_…). |
If-Match |
header | yes | Current ETag of the endpoint, or *. |
Response
204 No Content.
Errors
| HTTP | code | When |
|---|---|---|
| 404 | not_found |
No such endpoint in this environment. |
| 412 | precondition_failed |
If-Match does not match the current version. |
| 428 | precondition_required |
If-Match is missing. |
| 401 | unauthenticated |
The credential is missing, invalid or revoked. |
| 403 | insufficient_permissions |
The credential lacks webhook-endpoints:write. |
| 503 | service_unavailable |
Webhook administration is temporarily unavailable; retry after the Retry-After period. |
Example
curl -X DELETE https://api.eu.keenauth.com/v1/webhook-endpoints/whe_01k8a3m5q7t9v1w3x5y7z9b2c4 \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
-H 'If-Match: "3"'
CLI: keenauth webhook-endpoints delete whe_01k8a3m5q7t9v1w3x5y7z9b2c4 --if-match '"3"'