v20

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-011984401.2 MB

Tournament: Lifecycle

Schedule a tournament round

Sets or clears the start time of a single round. A COMPLETED round answers 400, and a round that does not belong to the tournament in the path answers 404 error_tournament_not_found - identical to an unknown slug, so the endpoint is not an existence oracle. IMPORTANT: matches that have ALREADY been generated keep the start time they were generated with; the round's startsAt is a generation-time snapshot, so this only affects matches generated after the change. Requires an API key holding the tournaments lifecycle capability whose owner is a tournament ADMIN - a tournamentStaff MODERATOR is NOT sufficient and receives 403.

post/tournaments/{identifier}/rounds/{roundId}/schedule

Path parameters

identifierstring required

Tournament slug.

roundIdstring required

Tournament round id.

Request body

startsAtinteger nullable required

Unix ms the round is scheduled to start, or null to clear the round's scheduled time. REQUIRED - there is no 'leave unchanged' value, because omitting it in the underlying mutation clears the field, and a silent clear is not something an integrator should be able to trigger by forgetting a key.

Response

The round schedule was updated.

successtrue required

roundIdstring required

startsAtinteger nullable required

The value now stored on the round.

timestampstring required