My Matches

Submit a map score

Changed on

Submit or overwrite a map score for a match. Only a captain, co-captain, or org owner of a participating team can submit. Requires the matches.team_matches:read-write permission.

post/matches/{matchId}/scores

Request

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

Path parameters

matchIdstring required

Match id.

Request body

mapIndexinteger required

Zero-based map index. Must be a non-negative integer.

mapIdstring required

Map identifier string (e.g. dust2).

creatorTeamScoreinteger required

Creator team score (integer, 0-1000).

opponentTeamScoreinteger required

Accepted/opponent team score (integer, 0-1000).

screenshotUrlsstring[]

Optional external screenshot URLs (validated as public https server-side, max 10). Prefer screenshotStorageIds for validated blobs.

screenshotStorageIdsstring[]

Optional Convex storage ids from POST /api/v1/uploads/image-url (validated for size + content-type, max 10; preferred over screenshotUrls).

Response

Map score submitted.

successboolean required
actionstring required

Action performed, e.g. "submitted" or "confirmed".

mapIndexinteger required

Zero-based map index that was affected.

scoreStatusstring required

Resulting score status, e.g. PENDING or CONFIRMED.

Changes

  • 82f2480cdb83Revision changes
    • info

      api tag My Matches added

    • info

      api tag Matches 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