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