My Matches

Forfeit a match

Changed on

Forfeits a match as the personal API key owner. The owner must be a captain, co-captain, or org owner of one participating team. Requires matches.user_matches:read-write and API writes access. Supports an optional Idempotency-Key header for safe retries.

post/matches/{matchId}/forfeit

Request

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

Path parameters

matchIdstring required

Match ID.

Request body

reasonstring

Optional forfeit reason.

Response

The match was forfeited successfully.

successtrue required
matchIdstring required
timestampstring required

Changes