v20

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

League: Seasons

Create a league season

Creates an upcoming season for a league game. Requires a personal or developer API key whose owner is currently a league ADMIN of the league in the path, with the league seasons capability enabled on the key. League API access is gated at api_pro on the league owner's plan. Supply an optional Idempotency-Key request header to make retries safe: an identical key and body replays the original season id, while the same key with a different body returns 409 error_idempotency_key_conflict.

post/leagues/{identifier}/seasons/create

Path parameters

identifierstring required

League slug.

Request body

gameIdstring required

Game ID the season belongs to.

namestring required

Season name.

startDatenumber required

Season start timestamp in milliseconds.

endDatenumber required

Season end timestamp in milliseconds.

Response

The season was created.

successtrue required

seasonIdstring required

timestampstring required