Eliminar un endpoint de webhook
DELETE /v1/webhook-endpoints/{endpoint_id} · permiso webhook-endpoints:write · todos los planes
Elimina un endpoint. Sus entregas pendientes y en reintento se cancelan en la misma transacción; el historial de entregas se conserva durante su retención de 30 días. If-Match es obligatorio; * elimina la versión que esté almacenada.
Solicitud
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
endpoint_id |
path | sí | ID del endpoint de webhook (whe_…). |
If-Match |
header | sí | ETag actual del endpoint, o *. |
Respuesta
204 No Content.
Errores
| HTTP | código | Cuándo |
|---|---|---|
| 404 | not_found |
No existe ese endpoint en este entorno. |
| 412 | precondition_failed |
If-Match no coincide con la versión actual. |
| 428 | precondition_required |
Falta If-Match. |
| 401 | unauthenticated |
La credencial falta, no es válida o fue revocada. |
| 403 | insufficient_permissions |
La credencial no tiene webhook-endpoints:write. |
| 503 | service_unavailable |
La administración de webhooks no está disponible temporalmente; reintente después del período de Retry-After. |
Ejemplo
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"'