v20

OpenAPI 3.1.0raw.githubusercontent.com2026-08-011984401.2 MB
My Matches

Cancel a match

Cancels a match as the personal API key owner. For a regular match the owner must be able to manage it (be a captain, co-captain, or org owner of a participating team, or an admin); past the league grace period an accepted league match is treated as a forfeit. For a PENDING challenge the owner must lead the creator team (captain, co-captain, or org owner of the challenging team), and past the challenge grace window (default 24h, league-overridable) cancelling any pending challenge - league or not - is recorded as a forfeit with the creator team taking the loss. Requires matches.user_matches:read-write and API writes access. Supports an optional Idempotency-Key header for safe retries.

post/matches/{matchId}/cancel

Path parameters

matchIdstring required

Match ID.

Match ID.

Request body

reasonstring

Optional cancellation reason.

Response

The match was cancelled successfully.

successtrue required
matchIdstring required
timestampstring required