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

MethodRouteAuthPurpose
POST/admin/replay/matchesAdminCreate a replay match
GET/admin/replay/matchesAdminList replay matches
POST/admin/replay/matches/:id/controlAdminControl replay playback
DELETE/admin/replay/matches/:idAdminDelete a replay match
GET/admin/replay/tapesAdminList available tapes

​
POST /admin/replay/matches Admin

Create a new replay match from a tape.
​
tapeId
string
required
The ID of the recorded tape to replay.
​
speed
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.
​
id
string
required
Replay match ID.
​
action
string
required
One of: play, pause, stop, seek.
​
position
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).