v20

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

My Matches

Submit a map score

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

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.