# 웹훅 엔드포인트로 이벤트 재전송

`POST /v1/webhook-endpoints/{endpoint_id}:replay` · 권한 `webhook-endpoints:write` · 모든 요금제

최근 30일 이내에 해당하는 `[from, to)` 범위의 이벤트를 다시 큐에 넣습니다. 예를 들어 엔드포인트가 비활성화되어 있던 기간의 이벤트를 재전송할 때 사용합니다. `types`로 범위를 좁히지 않으면 엔드포인트의 이벤트 유형만 전송됩니다. 재전송된 각 전송은 이벤트의 `webhook-id`를 유지하므로, `webhook-id`로 중복을 제거하는 수신자는 각 이벤트를 한 번만 처리합니다. 전송의 `replay_no`는 1씩 증가합니다.

## 요청

| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
| `endpoint_id` | path | 예 | 웹훅 엔드포인트 ID(`whe_…`). |
| `from` | date-time | 예 | 범위의 시작(포함), 최근 30일 이내여야 합니다. |
| `to` | date-time | 예 | 범위의 끝(제외), `from` 이후여야 합니다. |
| `types` | string[] | 아니요 | 재전송할 이벤트 유형. 비어 있거나 없으면 엔드포인트의 유형을 사용합니다. |
| `Idempotency-Key` | header | 아니요 | 같은 키로 반복된 요청에 대해 응답을 재생하며, 다시 큐에 넣지 않습니다. |

```json
{
  "from": "2026-10-20T00:00:00Z",
  "to": "2026-10-21T00:00:00Z",
  "types": ["user.created"]
}
```

## 응답

`200 OK`와 큐에 추가된 전송 수입니다.

```json
{
  "enqueued": 42
}
```

## 오류

| HTTP | code | 조건 |
|---|---|---|
| 400 | `unknown_field` | 본문에 위에 나열되지 않은 필드가 있습니다. |
| 404 | `not_found` | 이 환경에 해당 엔드포인트가 없습니다. |
| 415 | `unsupported_media_type` | 본문이 없거나 `application/json`이 아닙니다. |
| 422 | `validation_failed` | `/from required`, `/to required`, 또는 범위 규칙 위반: `to`가 `from` 이후가 아니거나 30일보다 오래되었습니다. |
| 401 | `unauthenticated` | 자격 증명이 없거나 잘못되었거나 취소되었습니다. |
| 403 | `insufficient_permissions` | 자격 증명에 `webhook-endpoints:write` 권한이 없습니다. |
| 503 | `service_unavailable` | 이 리전에서는 아직 재전송을 사용할 수 없거나 웹훅 관리 기능을 일시적으로 사용할 수 없습니다. `Retry-After` 이후에 다시 시도하십시오. |

## 예제

```bash
curl -X POST https://api.eu.keenauth.com/v1/webhook-endpoints/whe_01k8a3m5q7t9v1w3x5y7z9b2c4:replay \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 7a1c3e5f-9b2d-4f6a-8c0e-2b4d6f8a0c2e" \
  -d '{"from":"2026-10-20T00:00:00Z","to":"2026-10-21T00:00:00Z"}'
```

CLI(본문은 표준 입력 또는 파일(`--data @replay.json`)에서 가져옵니다):

```bash
echo '{"from":"2026-10-20T00:00:00Z","to":"2026-10-21T00:00:00Z"}' | keenauth webhook-endpoints replay whe_01k8a3m5q7t9v1w3x5y7z9b2c4 --data -
```