---
title: "Update an Arena tournament"
method: POST
path: "/api/tournament/{id}"
tags: ["Tournaments (Arena)"]
---

# Update an Arena tournament

`POST /api/tournament/{id}`

Update an Arena tournament.
Be mindful not to make important changes to ongoing tournaments.
Can be used to update a team battle.
Additional restrictions:
  - clockTime + clockIncrement > 0
  - 15s and 0+1 variant tournaments cannot be rated
  - Clock time in comparison to tournament length must be reasonable: 3 <= (minutes * 60) / (96 * clockTime + 48 * clockIncrement + 15) <= 150

## Response `200`

The Arena tournament was successfully updated.

- ArenaTournamentFull
  - `id` string, required
  - `fullName` string, required
  - `rated` boolean
  - `spotlight` object
    - `headline` string
  - `berserkable` boolean
  - `onlyTitled` boolean
  - `clock` Clock, required
    - `limit` integer, required
    - `increment` integer, required
  - `minutes` integer
  - `createdBy` string
  - `system` string
  - `secondsToStart` integer
  - `secondsToFinish` integer
  - `isFinished` boolean
  - `isRecentlyFinished` boolean
  - `pairingsClosed` boolean
  - `startsAt` string, int64
  - `nbPlayers` integer, required
  - `verdicts` Verdicts
    - `accepted` boolean, required
    - `list` Verdict[], required
      - `condition` string, required
      - `verdict` string, required
  - `quote` object — The quote displayed on the tournament page
    - `text` string
    - `author` string
  - `greatPlayer` object
    - `name` string
    - `url` string, uri
  - `allowList` string[] — List of usernames allowed to join the tournament
  - `hasMaxRating` boolean
  - `maxRating` ArenaRatingObj
    - `perf` 'ultraBullet' | 'bullet' | 'blitz' | 'rapid' | 'classical' | 'correspondence' | 'chess960' | 'crazyhouse' | 'antichess' | 'atomic' | 'horde' | 'kingOfTheHill' | 'racingKings' | 'threeCheck'
    - `rating` integer, required
  - `minRating` ArenaRatingObj
    - `perf` 'ultraBullet' | 'bullet' | 'blitz' | 'rapid' | 'classical' | 'correspondence' | 'chess960' | 'crazyhouse' | 'antichess' | 'atomic' | 'horde' | 'kingOfTheHill' | 'racingKings' | 'threeCheck'
    - `rating` integer, required
  - `minRatedGames` object
    - `nb` integer
  - `botsAllowed` boolean
  - `minAccountAgeInDays` integer
  - `perf` object
    - `icon` string, required
    - `key` string, required
    - `name` string, required
  - `schedule` object
    - `freq` string, required
    - `speed` string, required
  - `description` string
  - `variant` string
  - `duels` object[]
    - `id` string
    - `p` object[]
      - `n` string
      - `r` integer
      - `k` integer
  - `standing` object
    - `page` integer
    - `players` object[]
      - `name` string
      - `title` 'GM' | 'WGM' | 'IM' | 'WIM' | 'FM' | 'WFM' | 'NM' | 'CM' | 'WCM' | 'WNM' | 'LM' | 'BOT' — only appears if the user is a titled player or a bot user
      - `patron` boolean — Use patronColor value instead to determine if player is a patron.
      - `patronColor` integer — Players can choose a color for their Patron wings. See [here for the color mappings](https://github.com/lichess-org/lila/blob/master/ui/lib/css/abstract/_patron-colors.scss). The presence of this field indicates the player is an active Patron.
      - `flair` string — See [available flair list and images](https://github.com/lichess-org/lila/tree/master/public/flair)
      - `rank` integer
      - `rating` integer
      - `score` integer
      - `sheet` ArenaSheet
        - `scores` string, required
        - `fire` boolean
  - `featured` object
    - `id` string
    - `fen` string
    - `orientation` string
    - `color` string
    - `lastMove` string
    - `white` object
      - `name` string
      - `id` string
      - `rank` integer
      - `rating` integer
    - `black` object
      - `name` string
      - `id` string
      - `rank` integer
      - `rating` integer
    - `c` object
      - `white` integer — white's clock in seconds
      - `black` integer — black's clock in seconds
  - `podium` object[]
    - `name` string
    - `title` 'GM' | 'WGM' | 'IM' | 'WIM' | 'FM' | 'WFM' | 'NM' | 'CM' | 'WCM' | 'WNM' | 'LM' | 'BOT' — only appears if the user is a titled player or a bot user
    - `patron` boolean — Use patronColor value instead to determine if player is a patron.
    - `patronColor` integer — Players can choose a color for their Patron wings. See [here for the color mappings](https://github.com/lichess-org/lila/blob/master/ui/lib/css/abstract/_patron-colors.scss). The presence of this field indicates the player is an active Patron.
    - `flair` string — See [available flair list and images](https://github.com/lichess-org/lila/tree/master/public/flair)
    - `rank` integer
    - `rating` integer
    - `score` integer
    - `nb` object
      - `game` integer
      - `berserk` integer
      - `win` integer
    - `performance` integer
  - `stats` object
    - `games` integer, required
    - `moves` integer, required
    - `whiteWins` integer, required
    - `blackWins` integer, required
    - `draws` integer, required
    - `berserks` integer, required
    - `averageRating` integer, required
  - `myUsername` string

## Other responses

- `400` — The update of the Arena tournament failed.

---

[API](https://skmtc.net/lichess/apis/lichess-org-api-reference.md) · [All operations](https://skmtc.net/lichess/apis/lichess-org-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lichess/lichess-org-api-reference/versions/1425db81eb3b/schema)