League: Seasons

Create a league season

Changed on

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

Request

  • Base URL
    https://teambattles.gg/api/v1
  • URL
    https://teambattles.gg/api/v1/leagues/{identifier}/seasons/create
  • Auth
    HTTP bearer

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

Changes