ウェブフックエンドポイントへイベントを再送
POST /v1/webhook-endpoints/{endpoint_id}:replay · 権限 webhook-endpoints:write · すべてのプラン
過去 30 日以内の [from, to) の期間にあるイベントを、再度キューに追加します。たとえば、エンドポイントが無効になっていた期間のイベントを再送する場合に使用します。types で絞り込まない限り、送信されるのはエンドポイントのイベントタイプのみです。再送された各配信は元のイベントの webhook-id を保持するため、webhook-id で重複を除去する受信側は各イベントを 1 回だけ処理します。配信の replay_no は 1 ずつ増加します。
リクエスト
| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
endpoint_id |
path | はい | ウェブフックエンドポイント ID(whe_…)。 |
from |
date-time | はい | 範囲の開始(含む)。過去 30 日以内である必要があります。 |
to |
date-time | はい | 範囲の終了(含まない)。from より後である必要があります。 |
types |
string[] | いいえ | 再送するイベントタイプ。空または未指定の場合は、エンドポイントのイベントタイプが対象になります。 |
Idempotency-Key |
header | いいえ | 同じキーによる繰り返しのリクエストに対して、再度キューに追加せず、レスポンスを再生します。 |
{
"from": "2026-10-20T00:00:00Z",
"to": "2026-10-21T00:00:00Z",
"types": ["user.created"]
}
レスポンス
200 OK とキューに追加された配信の件数を返します。
{
"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 の期間を待ってから再試行してください。 |
例
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)から指定します):
echo '{"from":"2026-10-20T00:00:00Z","to":"2026-10-21T00:00:00Z"}' | keenauth webhook-endpoints replay whe_01k8a3m5q7t9v1w3x5y7z9b2c4 --data -