v20

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-011984401.2 MB

Game: Scores

Submit a single map's score

Submits the score for one map (mapIndex from the path); game-developer scores are auto-confirmed. Requires the game.scores:write permission.

post/game/matches/{matchId}/scores/{mapIndex}

Path parameters

matchIdstring required

Match ID.

mapIndexstring required

Zero-based index of the map within the series.

Request body

mapIdstring required

Identifier of the map that was played.

creatorTeamScoreinteger required

Score for the creator team (integer, 0-1000).

opponentTeamScoreinteger required

Score for the opponent (accepted) team (integer, 0-1000).

screenshotUrlsstring[]

Optional external screenshot URLs supporting the reported score. Each must be a public https URL. Prefer screenshotStorageIds (validated blobs) where possible.

screenshotStorageIdsstring[]

Optional storage IDs for screenshots uploaded via POST /uploads/image-url. Preferred over screenshotUrls: each is validated (size, content-type, ownership) and resolved to a URL server-side.

playerStatsobject

Optional per-player stats keyed by user ID.

Response

The map score was submitted and confirmed.

successtrue required

mapIndexinteger required

Index of the map that was scored.

scoreStatusstring required

Confirmation state, always "CONFIRMED" on success.