웹훅 엔드포인트 삭제
DELETE /v1/webhook-endpoints/{endpoint_id} · 권한 webhook-endpoints:write · 모든 요금제
엔드포인트를 삭제합니다. 대기 중이거나 재시도 중인 전달은 같은 트랜잭션에서 취소됩니다. 전달 기록은 30일 보관 기간 동안 유지됩니다. If-Match는 필수이며, *를 사용하면 저장된 버전과 관계없이 삭제합니다.
요청
| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
endpoint_id |
path | 예 | 웹훅 엔드포인트 ID(whe_…). |
If-Match |
header | 예 | 엔드포인트의 현재 ETag 또는 *. |
응답
204 No Content.
오류
| HTTP | code | 발생 조건 |
|---|---|---|
| 404 | not_found |
이 환경에 해당 엔드포인트가 없습니다. |
| 412 | precondition_failed |
If-Match가 현재 버전과 일치하지 않습니다. |
| 428 | precondition_required |
If-Match가 없습니다. |
| 401 | unauthenticated |
자격 증명이 없거나 잘못되었거나 취소되었습니다. |
| 403 | insufficient_permissions |
자격 증명에 webhook-endpoints:write 권한이 없습니다. |
| 503 | service_unavailable |
웹훅 관리 기능을 일시적으로 사용할 수 없습니다. Retry-After 기간 이후에 다시 시도하십시오. |
예제
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"'