Skip to content

Mark that you started watching

POST
/api/matches/{id}/playback-started
curl --request POST \
--url https://foxleague.ai/api/matches/1/playback-started \
--header 'Authorization: Bearer <token>'

Tells the server you started watching your ranked or casual match. The first call starts the match’s broadcast clock, which drives resume, the live banner and the moment the result applies; later calls change nothing. A match whose result is already applied is a replay and starts no clock.

Who: a signed-in player of the match.

Refusals:

  • You are not a participant in this match: no such match; you are not one of its two players; a tournament or challenge match (it answers like an unknown id, before and after its broadcast).
id
required
integer format: int32

The match id.

Success or a refusal: read success (the refusals are in the description).

Media type application/json
object
code

A machine-readable reason next to error, set only where the caller must act differently. tx_pending: the payment was not refused but could not be verified yet; keep the transaction hash and confirm again with the same hash, never pay twice.

string | null
data

The answer. Present when success is true.

object
applied

Only on playback-done: false when this call did not apply the result.

boolean
ok
required

Always true.

boolean
error

Why the request was refused, in plain words. Present when success is false.

string | null
success
required

true when the request did what it asked. false is a refusal: read error.

boolean
Example
{
"data": {
"ok": true
},
"success": true
}

No valid session. The body is plain text: Missing Authorization header, Invalid Authorization format, Invalid session token or Session expired or invalid. Sign in again.

Media type text/plain
string
Example
Session expired or invalid