Skip to content

Replay

Replay any past event to re-deliver it to the target endpoint.

Replay Event

POST /api/v1/events/:id/replay

How It Works

  1. The original event's payload is retrieved from storage
  2. A new event is created with status QUEUED
  3. The new event records the original ID in source_event_id
  4. The original event and its attempts remain unchanged
  5. The new event goes through the normal delivery pipeline without new billable usage

Response

HTTP 200 OK
json
{
  "id": "f1e2d3c4b5a697886970615043322110",
  "status": "QUEUED",
  "source_event_id": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6"
}

Use Cases

  • Downstream recovery: Your endpoint was down and missed events — replay them once it's back up
  • Bug fixes: You fixed a bug in your webhook handler — replay events to re-process them
  • Testing: Replay production events to a staging endpoint for testing

Limitations

  • The payload is fetched from storage — if the payload was deleted, replay will fail
  • Replaying an event that is still in flight can create concurrent deliveries; use replay deliberately

Released under the MIT License.