Supprimer un point de terminaison webhook
DELETE /v1/webhook-endpoints/{endpoint_id} · autorisation webhook-endpoints:write · tous les forfaits
Supprime un point de terminaison. Ses livraisons en attente et en cours de nouvelle tentative sont annulées dans la même transaction ; l'historique des livraisons est conservé pendant sa durée de rétention de 30 jours. If-Match est obligatoire ; * supprime quelle que soit la version enregistrée.
Requête
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
endpoint_id |
path | oui | Identifiant du point de terminaison webhook (whe_…). |
If-Match |
header | oui | ETag actuel du point de terminaison, ou *. |
Réponse
204 No Content.
Erreurs
| HTTP | code | Quand |
|---|---|---|
| 404 | not_found |
Aucun point de terminaison de ce type dans cet environnement. |
| 412 | precondition_failed |
If-Match ne correspond pas à la version actuelle. |
| 428 | precondition_required |
If-Match est absent. |
| 401 | unauthenticated |
L'identifiant est absent, invalide ou révoqué. |
| 403 | insufficient_permissions |
L'identifiant ne dispose pas de webhook-endpoints:write. |
| 503 | service_unavailable |
L'administration des webhooks est temporairement indisponible ; réessayez après la durée indiquée par Retry-After. |
Exemple
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"'