Submit a mutually-confirmed result

Records a player’s claim about how a match ended. The browser is never the sole authority: the claim is stored only after its session token validates to a real, unconsumed, non-expired match session bound to this user and match.

A match finalizes only when both participants independently claim the same outcome through their own sessions. The response reports the reconciliation decision:

• pending — awaiting the opponent’s claim,
• replay — mutual DRAW in a single-elimination match (match stays running),
• game_advance — claims agree and the bracket advanced,
• game_advance_pending_finalization — agree but bracket finalization deferred,
• dispute — claims conflict or outcome could not be mapped to a slot.

The x-session-token is consumed on a successful (status 2xx) submission.

POST /api/v1/game-sdk/{gameId}/results

Submit a mutually-confirmed result

cURL

curl --request POST \
  --url https://api.musterbox.com/api/v1/game-sdk/{gameId}/results \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "matchId": 1042,
  "boardHash": "b4c8f6d1ea3f0c26597da05a21c66f7e"
}
'

200

{
  "decision": "pending",
  "matchId": 123,
  "reason": "<string>",
  "claimCount": 123,
  "tournamentId": "<string>",
  "winnerOpponent": 1
}

Authorizations

bearerAuthgameKeygameSessionToken

Authorization · string · header · required

Player access token returned by login/refresh.

Path Parameters

gameId · string · required

The identifier of the game.

Body

application/json

environment · enum<string> · required

Backend environment the credential was created for.

Available options: local, sandbox, staging, production

matchId · integer · required

Example:

1042

outcome · enum<string> · required

Available options: PLAYER_A_WIN, PLAYER_B_WIN, DRAW

boardHash · string

Optional integrity digest of the final board state.

Example:

"b4c8f6d1ea3f0c26597da05a21c66f7e"

Response

200

application/json

Claim recorded and reconciliation decision returned.

decision · enum<string> · required

Available options: pending, replay, game_advance, game_advance_pending_finalization, dispute

matchId · integer · required

reason · string · required

Human-readable reconciliation reason.

claimCount · integer · required

Number of claims recorded so far for this match.

tournamentId · string | null

winnerOpponent · enum<integer>

The opponent slot whose claimed outcome won, when determinable.

Available options: 1, 2