---
title: "Update a broadcast round"
method: POST
path: "/broadcast/round/{broadcastRoundId}/edit"
tags: ["Broadcasts"]
---

# Update a broadcast round

`POST /broadcast/round/{broadcastRoundId}/edit`

Update information about a broadcast round.
This endpoint accepts the same form data as the web form.
All fields must be populated with data. Missing fields will override the broadcast with empty data.
For instance, if you omit `startDate`, then any pre-existing start date will be removed.

## Path parameters

- `broadcastRoundId` string, required

## Query parameters

- `patch` boolean

## Response `200`

The broadcast round was successfully edited.

- BroadcastRound
  - `round` BroadcastRoundInfo, required
    - `id` string, required
    - `name` string, required
    - `slug` string, required
    - `createdAt` integer, required
    - `rated` boolean, required — Whether the round is used for rating calculations
    - `ongoing` boolean
    - `startsAt` integer
    - `startsAfterPrevious` boolean — The start date/time is unknown and the round will start automatically when the previous round completes
    - `finishedAt` integer
    - `finished` boolean
    - `url` string, uri, required
    - `delay` integer
    - `customScoring` BroadcastCustomScoring — Scoring overrides for wins or draws.
      - `white` BroadcastCustomPointsPerColor, required
        - `win` number, required
        - `draw` number, required
      - `black` BroadcastCustomPointsPerColor, required
        - `win` number, required
        - `draw` number, required
  - `tour` BroadcastTour, required
    - `id` string, required
    - `name` string, required
    - `slug` string, required
    - `createdAt` integer, required
    - `dates` integer[] — Start and end dates of the tournament, as Unix timestamps in milliseconds
    - `info` BroadcastTourInfo — Additional display information about the tournament
      - `format` string — Tournament format. Example: `"8-player round-robin" or "5-round Swiss"`
      - `tc` string — Time control. Example: `"Classical" or "Rapid" or "Rapid & Blitz"`
      - `fideTC` 'standard' | 'rapid' | 'blitz' — FIDE rating category
      - `timeZone` string — Timezone of the tournament. Example: `America/New_York`. See [list of possible timezone identifiers](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) for more.
      - `location` string — Tournament location
      - `players` string — Mentioning up to 4 of the best players participating.
      - `website` string, uri — Official website. External website URL
      - `standings` string, uri — Official standings website. External website URL, e.g. chess-results.com, info64.org
      - `regulations` string, uri — External URL to the official tournament regulations.
    - `tier` integer — Used to designate featured tournaments on Lichess
    - `image` string, uri
    - `description` string — Full tournament description in markdown format, or in HTML if the html=1 query parameter is set.
    - `teamTable` boolean
    - `showTeamScores` boolean
    - `url` string, uri, required
    - `communityOwner` LightUser
      - `id` string, required
      - `name` string, required
      - `flair` string — See [available flair list and images](https://github.com/lichess-org/lila/tree/master/public/flair)
      - `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.
  - `study` BroadcastRoundStudyInfo, required
    - `writeable` boolean — Whether the currently authenticated user has permission to update the study
    - `features` object
      - `chat` boolean — Whether chat is enabled for the currently authenticated user
      - `computer` boolean — Whether engine analysis is enabled for the currently authenticated user
      - `explorer` boolean — Whether the opening explorer + tablebase is enabled for the currently authenticated user
  - `games` BroadcastRoundGame[], required
    - `id` string, required
    - `name` string, required
    - `fen` string
    - `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
      - `rating` integer
      - `fideId` integer
      - `fed` string
      - `clock` integer
    - `lastMove` string
    - `check` '+' | '#'
    - `thinkTime` integer
    - `status` '*' | '1-0' | '0-1' | '½-½' — The result of the game
  - `group` BroadcastGroup
    - `id` string, required
    - `slug` string, required
    - `name` string, required
    - `tours` BroadcastGroupTour[], required
      - `id` string, required
      - `name` string, required
      - `active` boolean, required
      - `live` boolean, required
  - `isSubscribed` boolean — Indicates if the user making the request is subscribed to the broadcast
  - `photos` BroadcastPhotos, required — Photos of players, when available. The object keys are FIDE IDs

## Other responses

- `400` — The broadcast round update 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)