# 웹훅 엔드포인트 삭제

`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` 기간 이후에 다시 시도하십시오. |

## 예제

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