League: Scores

Update a league match's lifecycle status

Changed on

Transitions a league match between lifecycle states. Requires a personal or developer API key whose owner is currently a league ADMIN of the league in the path, with the league scores capability enabled on the key. League API access is gated at api_pro on the league owner's plan.

patch/leagues/{identifier}/matches/{matchId}/status

Request

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

Path parameters

identifierstring required

League slug.

matchIdstring required

Match ID.

Request body

statusstring required

Target status. Allowed league transitions: READY -> IN_PROGRESS|CANCELLED, ACCEPTED -> CANCELLED. COMPLETED is not accepted directly; matches complete automatically once scores are confirmed.

Response

The league match status was transitioned successfully.

successtrue required
matchIdstring required

ID of the updated match.

previousStatusstring required

Match status before the transition.

newStatusstring required

Match status after the transition.

timestampstring required

Server response time (ISO 8601).

Changes