# 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

```bash
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"'`