Game: Scores

Submit map scores across multiple matches in one call

Changed on

Submits map scores for up to 50 (match, map) items in a single request. Each item is independently scope-checked against the key's bound game; an off-scope or otherwise failing item is rejected in its per-item envelope (status "failed", error = bare error_* code) WITHOUT failing the whole request. The response is ALWAYS HTTP 200 - inspect per-item status. Requires the game.scores:write permission. Score submission is naturally idempotent: an unconfirmed map is overwritten on re-submit and an already-confirmed map returns a per-item error_score_already_submitted_by_game, so a retried batch is safe without an Idempotency-Key.

post/game/matches/batch-scores

Request

  • Base URL
    https://teambattles.gg/api/v1
  • Auth
    HTTP bearer

Request body

Response

Per-item submission results. success is true only when every item was confirmed.

successboolean required

True only when every submitted item was confirmed.

countinteger required

Number of items that were confirmed.

Changes

    • info

      api tag Game: Scores added

    • info

      api tag Game removed

    • 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