Replay a delivery

POST/v1/webhooks/deliveries/{id}/replayKey scope write

Sends the event of an earlier delivery to the same endpoint again, as a new delivery. The original delivery is left as it is. A replay to a disabled endpoint ends as failed.

Needs a key with the write scope. Authentication

curl -X POST https://api.useinfrared.com/v1/webhooks/deliveries/whd_4NNJEqwkLoeyB3ffT89sPT/replay \
  -H "Authorization: Bearer $INFRARED_KEY"

const response = await fetch("https://api.useinfrared.com/v1/webhooks/deliveries/whd_4NNJEqwkLoeyB3ffT89sPT/replay", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.INFRARED_KEY}` },
});

const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.useinfrared.com/v1/webhooks/deliveries/whd_4NNJEqwkLoeyB3ffT89sPT/replay",
    headers={"Authorization": f"Bearer {os.environ['INFRARED_KEY']}"},
)

data = response.json()

202 AcceptedResponse

{
  "object": "webhook_delivery",
  "id": "whd_7defmGCIWxc5gWCNiLCaRv",
  "endpoint_id": "whe_2HLyVEWQelwo16welH16NM",
  "event_id": "evt_776dPiJmyI8U3ftKGhZdRG",
  "event_type": "moderation.completed",
  "status": "pending",
  "attempts": 0,
  "response_status": null,
  "error": null,
  "duration_ms": null,
  "next_attempt_at": "2026-10-08T09:29:13.929Z",
  "delivered_at": null,
  "replayed_from_id": "whd_4NNJEqwkLoeyB3ffT89sPT",
  "attempt_log": [],
  "created_at": "2026-10-08T09:29:13.929Z"
}

Path parameters

idstringRequired: Id of the delivery to replay: whd_ plus 22 base62 characters.

Returns

The new delivery, with status 202. It is in the status pending and its replayed_from_id is the id of the original.

202 AcceptedA webhook delivery object

Errors

404: not_found
The key's project has no delivery with this id, or the id is malformed.

Every endpoint can also answer the errors any request can meet: a missing key, a rate limit, a malformed body. Errors

Something missing or unclear on this page? Write to support@useinfrared.com.