Appearance
Replay
Replay any past event to re-deliver it to the target endpoint.
Replay Event
POST /api/v1/events/:id/replayHow It Works
- The original event's payload is retrieved from storage
- A new event is created with status
QUEUED - The new event records the original ID in
source_event_id - The original event and its attempts remain unchanged
- The new event goes through the normal delivery pipeline without new billable usage
Response
HTTP 200 OKjson
{
"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