Skip to main content
Replay endpoints allow you to simulate live matches using recorded “tapes” of past match data. Useful for testing Live Activities, push notifications, and frontend rendering without waiting for real matches.
Replay functionality is only available when mock mode is enabled. See Configuration for the relevant env vars.

​
Endpoint reference

​
POST /admin/replay/matches Admin

Create a new replay match from a tape.
​
string
required
The ID of the recorded tape to replay.
​
number
Playback speed multiplier. Default 1. Set to 2 for double speed, etc.

​
GET /admin/replay/matches Admin

List all active replay matches and their current playback state.

​
POST /admin/replay/matches/:id/control Admin

Control playback of a replay match.
​
string
required
Replay match ID.
​
string
required
One of: play, pause, stop, seek.
​
number
Required when action is seek. The ball number to seek to.

​
DELETE /admin/replay/matches/:id Admin

Stop and delete a replay match.

​
GET /admin/replay/tapes Admin

List all available replay tapes with metadata (match name, duration, ball count).