My Matches

Create a match acceptance request

Changed on

Creates a match acceptance request as the personal API key owner. The owner must be a captain, co-captain, or org owner of the accepting team and the proposed roster must satisfy existing match rules. Requires matches.user_matches:read-write and API writes access. Supports an optional Idempotency-Key header for safe retries.

post/matches/{matchId}/accept

Request

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

Path parameters

matchIdstring required

Match ID.

Request body

teamIdstring required

Team ID accepting the match.

activeRosterstring[] required

Active roster user IDs for the acceptance request.

disputedRulesobject

Optional proposed rule changes.

mapPreferenceMode'PREFERRED' | 'VETO'

Optional map preference mode for selected maps.

selectedMapsstring[]

Optional proposed map IDs.

messagestring

Optional message for the match creator.

Response

The match acceptance request was created.

successtrue required
acceptanceIdstring required
timestampstring required

Changes