Event Replay

The event replay tool lets you inspect, search, and re-publish past events — a time-travel debugger for your realtime system.

Accessing the Replay Timeline

Open your app dashboard and navigate to Event Replay. You'll see a chronological timeline of every event published in the last 7 days (30 days on Pro plans).

Searching Events

Filter the timeline by channel, event name, or time range:

channel:private-orders event:order.created after:2026-04-01 before:2026-04-03

You can also filter by payload content using a JSON path expression:

data.amount > 100

Inspecting an Event

Click any event in the timeline to see its full details:

• Timestamp — when the event was published (UTC)
• Channel — which channel(s) received it
• Event name — the event type
• Payload — the full JSON data
• Delivery stats — how many connected clients received it and latency percentiles

Replaying Events

Select one or more events and click Replay to re-publish them to their original channels. This is useful for:

• Debugging — reproduce a client-side issue with real production data
• Recovery — re-deliver events that clients may have missed during a disconnect
• Testing — replay a sequence of events against a development environment

You can also replay via the REST API:

curl -X POST https://your-relay-host.com/api/v1/apps/YOUR_APP_ID/replay \
  -H "Authorization: Bearer YOUR_APP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "event_ids": ["evt_abc123", "evt_def456"],
    "target_channel": "private-orders"
  }'

Omit target_channel to replay to the original channels.

Replay to a Different Environment

Set the target_app_id field to replay events into a different app (useful for replaying production events into a staging app):

curl -X POST https://your-relay-host.com/api/v1/apps/YOUR_APP_ID/replay \
  -H "Authorization: Bearer YOUR_APP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "event_ids": ["evt_abc123"],
    "target_app_id": "STAGING_APP_ID"
  }'

Retention

Events on no-history- channels are never stored and cannot be replayed.