# Elimina un endpoint webhook

`DELETE /v1/webhook-endpoints/{endpoint_id}` · permesso `webhook-endpoints:write` · tutti i piani

Elimina un endpoint. Le sue consegne in attesa e in nuovo tentativo vengono annullate nella stessa transazione; la cronologia delle consegne resta per la sua conservazione di 30 giorni. `If-Match` è obbligatorio; `*` elimina qualunque versione sia memorizzata.

## Richiesta

| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `endpoint_id` | path | sì | ID dell'endpoint webhook (`whe_…`). |
| `If-Match` | header | sì | `ETag` attuale dell'endpoint, oppure `*`. |

## Risposta

`204 No Content`.

## Errori

| HTTP | code | Quando |
|---|---|---|
| 404 | `not_found` | Nessun endpoint del genere in questo ambiente. |
| 412 | `precondition_failed` | `If-Match` non corrisponde alla versione attuale. |
| 428 | `precondition_required` | `If-Match` è mancante. |
| 401 | `unauthenticated` | La credenziale è mancante, non valida o revocata. |
| 403 | `insufficient_permissions` | La credenziale non ha `webhook-endpoints:write`. |
| 503 | `service_unavailable` | L'amministrazione dei webhook è temporaneamente non disponibile; riprova dopo il periodo di `Retry-After`. |

## Esempio

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