---
title: "Update a Swiss tournament"
method: POST
path: "/api/swiss/{id}/edit"
tags: ["Tournaments (Swiss)"]
---

# Update a Swiss tournament

`POST /api/swiss/{id}/edit`

Update a Swiss tournament.
Be mindful not to make important changes to ongoing tournaments.
Additional restrictions:
  - clock.limit + clock.increment > 0
  - 15s and 0+1 variant tournaments cannot be rated

## Path parameters

- `id` string, required

## Response `200`

The Swiss tournament was successfully updated.

- SwissTournament
  - `id` string, required
  - `createdBy` string, required
  - `startsAt` string, required
  - `name` string, required
  - `clock` object, required
    - `limit` number, required
    - `increment` number, required
  - `variant` string, required
  - `round` number, required
  - `nbRounds` number, required
  - `nbPlayers` number, required
  - `nbOngoing` number, required
  - `status` 'created' | 'started' | 'finished', required — The current state of the swiss tournament
  - `stats` object
    - `games` number, required
    - `whiteWins` number, required
    - `blackWins` number, required
    - `draws` number, required
    - `byes` number, required
    - `absences` number, required
    - `averageRating` number, required
  - `rated` boolean, required
  - `verdicts` Verdicts, required
    - `accepted` boolean, required
    - `list` Verdict[], required
      - `condition` string, required
      - `verdict` string, required
  - `nextRound` object
    - `at` string, date-time
    - `in` integer — The number of seconds until the next round starts.

## Other responses

- `400` — Updating the swiss failed.
- `401` — This user cannot update this Swiss.

---

[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)