Skip to main content
PATCH
/
matches
/
{matchId}
/
scores
curl -X PATCH https://teambattles.gg/api/v1/matches/jm7match123/scores \
  -H "Authorization: Bearer tb_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"mapIndex": 0}'

{
  "success": true,
  "action": "<string>",
  "mapIndex": 0,
  "scoreStatus": "<string>"
}

​
Permission Required

This endpoint requires matches.team_matches:read-write on your API key. A free (api_free) key receives 403 error_api_feature_required; this requires an api_pro+ plan.

​
Access / Membership Rules

The confirmation is recorded as the API key owner, derived from the key itself - it is never accepted as a body field. Only the opposing team’s captain can confirm a score: a captain cannot confirm their own team’s submission. Confirming moves the map score from PENDING to CONFIRMED (see Submit A Map Score). A personal key can only confirm scores for matches whose teams its owner captains - the route binding is a no-op and this authorization is enforced inside Convex. A non-personal key receives 403 API_KEY_PERMISSION_DENIED.

​
Request Body

FieldTypeRequiredDescription
mapIndexnumberYesZero-based map index to confirm (non-negative integer).

​
What’s Returned

Returns success: true, action: "confirmed", the mapIndex, and scoreStatus: "CONFIRMED". Mintlify renders the full schema from the spec below. 
curl -X PATCH https://teambattles.gg/api/v1/matches/jm7match123/scores \
  -H "Authorization: Bearer tb_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"mapIndex": 0}'

Authorizations

​
Authorization
string
header
required

Send your API key as: Authorization: Bearer tb_

Path Parameters

​
matchId
string
required

Match id.

Body

application/json

Confirmation payload identifying the map score to confirm.

​
mapIndex
integer
required

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

Required range: 0 <= x <= 9007199254740991

Response

Map score confirmed.

Result of submitting or confirming a map score.

​
success
boolean
required
​
action
string
required

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

​
mapIndex
integer
required

Zero-based map index that was affected.

Required range: -9007199254740991 <= x <= 9007199254740991
​
scoreStatus
string
required

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