Webhooks
Webhookを再配信
POST
/api/v1alpha1/webhooks/{webhook_id}/deliveries/{delivery_id}/redeliver過去の配信を1件、もう一度送信するようqueueに入れます。endpoint側の問題を解消した後に使います。
- アクセス: alphaを有効にしたAPI keyと
MANAGE_WEBHOOKS権限。 - 動作: 試行回数が0に戻り、recordは最終状態ではなくなるため、新規の配信として扱われます。
- 応答: 202。新しい試行の実行前に返ります。
- 再試行: callerがPOSTを再送する可能性がある場合は
Idempotency-Keyを指定してください。
新しい試行の結果はGET /api/v1alpha1/webhooks/{webhook_id}/deliveriesで確認してください。
認証
apiKey 認証Bearer <token>
場所: header
パスパラメーター
webhook_id*string
登録済みWebhook endpointの識別子です。
delivery_id*string
個々の配信試行の識別子です。delivery historyで返ります。
ヘッダーパラメーター
Idempotency-Key?string
このPOSTを安全にretryするための任意のkeyです。keyは24時間保持され、request payloadと具体的なpath parameterと比較されます。
長さ
length <= 255レスポンスボディ
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://example.com/api/v1alpha1/webhooks/wh_0190b5d4-7e1f-7a2b-9c3d-1234567890ab/deliveries/delivery_0190b5d4-7e1f-7a2b-9c3d-1234567890ab/redeliver" \ -H "Authorization: Bearer $DEEPFRAME_API_KEY"{ "attempts": 2, "created_at": "2026-08-08T10:00:01.000Z", "endpoint_id": "wh_0190b5d4-7e1f-7a2b-9c3d-1234567890ab", "event_id": "evt_0190b5d4-7e1f-7a2b-9c3d-1234567890ab", "event_type": "video.indexed", "id": "delivery_0190b5d4-7e1f-7a2b-9c3d-1234567890ab", "next_attempt_at": "2026-08-08T10:10:00.000Z", "response_status": 202, "status": "delivered"}