Mint a viewer token for the live feed
POST/battles/:id/viewer-tokens
Issues a short-lived token scoped to this battle only, valid for 15 minutes.
Creating a battle and adding a seat already return one, so call this when that token expired — a lobby that sat open for twenty minutes — or when a new viewer joins an existing battle.
Mint per viewer. The token is the only revocation granularity available.
Scope: viewer:mint
Request
Responses
- 200
- 401
- 403
- 404
- 500
- 503
A fresh viewer token
Missing, malformed, revoked or expired API key
The key lacks viewer:mint, or the casino is suspended
No such battle for this casino
The instance has no viewer-token signing key. Battles still open and seats still fill; only the live feed is unavailable. Ask your platform contact to appoint a key, or rotate one from the admin console
The lobby is still initialising, or the instance has no token issuer at all