Replay API

Re-run a stored event—often with a tweaked payload—to confirm a fix. This is separate from ingestion.

Contract below is illustrative. Confirm paths and fields in your deployment or from the dashboard.

Modes

safe

Replay with a new payload; keep the original event.

exact

Use the captured payload as-is.

dry-run

Simulate without side effects.

Request & response (example)

Your gateway may differ; use this as a shape reference.

Request sketchhttp

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

{
  "mode": "safe",
  "payload": {
    "orderId": "ord_123",
    "amount": 49.99,
    "paymentMethod": "card_new"
  }
}

Response sketchjson

{
  "replayId": "replay_xyz789",
  "status": "success",
  "originalEventId": "evt_abc123",
  "executionTime": "856ms",
  "comparison": {
    "statusCode": { "before": 500, "after": 200 },
    "success": true
  }
}