Game: Scores

Submit a single map's score

Changed on

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}

Request

  • Base URL
    https://teambattles.gg/api/v1
  • URL
    https://teambattles.gg/api/v1/game/matches/{matchId}/scores/{mapIndex}
  • Auth
    HTTP bearer

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.

Changes

  • 82f2480cdb83Revision changes
    • info

      api tag Game: Scores added

    • info

      api tag Game removed

  • 4bed7522e6f8Revision changes
    • breaking

      the request property type changed from number to integer

    • breaking

      the request property type changed from number to integer

    • warning

      the request property's max was set to 1000.00

    • warning

      the request property's max was set to 1000.00