webhooks

Replay a webhook delivery

Changed on

Route a delivery's stored event again as a new delivery. Without targetId every current subscriber is checked against its filter again. With targetId the event goes to that one subscriber, even if its filter skipped it. A replay never resumes waiting runs. Replays start real runs, so the key needs permission to trigger every task the replay runs, and to write sessions if it reaches an agent's subscriber.

post/api/v1/webhooks/deliveries/{deliveryId}/replay

Request

Query parameters

targetIdstring

The subscriber to replay to: a webhook() task's id, or agentId:eventId for an agent's chat.event or channel. Listed in the endpoint's subscribers.

Response

Replay created

deliveryIdstring required

The new delivery. Retrieve it once it's processed to see the runs it started.

replayedFromstring required

The delivery that was replayed.

Example response

{
  "deliveryId": "whd_5678",
  "replayedFrom": "whd_1234"
}

Changes