Lichess TV API

openapi: 3.2.0
info:
  version: 2.0.144
  title: Lichess.org API reference TV API
  contact:
    name: Lichess.org API
    url: https://lichess.org/api
    email: contact@lichess.org
  x-logo:
    url: https://lichess1.org/assets/logo/lichess-pad12.svg
  license:
    name: AGPL-3.0-or-later
    url: https://www.gnu.org/licenses/agpl-3.0.txt
  description: '# Introduction

    Welcome to the reference for the Lichess API!'
servers:
- url: https://lichess.org
- url: https://lichess.dev
- url: http://localhost:{port}
  variables:
    port:
      default: '8080'
- url: http://l.org
tags:
- name: TV
  description: 'Access Lichess TV channels and games.

    &'
paths:
  /api/tv/channels:
    get:
      operationId: tvChannels
      summary: Get current TV games
      description: 'Get basic info about the best games being played for each speed and variant,

        but also computer games and bot games.

        See lichess.org/tv.'
      tags:
      - TV
      security: []
      responses:
        '200':
          description: The list of games being played for each speed and variant.
          headers:
            Access-Control-Allow-Origin:
              schema:
                type: string
                default: '''*'''
          content:
            application/json:
              schema:
                type: object
                required:
                - bot
                - blitz
                - racingKings
                - ultraBullet
                - bullet
                - classical
                - threeCheck
                - antichess
                - computer
                - horde
                - rapid
                - atomic
                - crazyhouse
                - chess960
                - kingOfTheHill
                - best
                properties:
                  bot:
                    $ref: '#/components/schemas/TvGame'
                  blitz:
                    $ref: '#/components/schemas/TvGame'
                  racingKings:
                    $ref: '#/components/schemas/TvGame'
                  ultraBullet:
                    $ref: '#/components/schemas/TvGame'
                  bullet:
                    $ref: '#/components/schemas/TvGame'
                  classical:
                    $ref: '#/components/schemas/TvGame'
                  threeCheck:
                    $ref: '#/components/schemas/TvGame'
                  antichess:
                    $ref: '#/components/schemas/TvGame'
                  computer:
                    $ref: '#/components/schemas/TvGame'
                  horde:
                    $ref: '#/components/schemas/TvGame'
                  rapid:
                    $ref: '#/components/schemas/TvGame'
                  atomic:
                    $ref: '#/components/schemas/TvGame'
                  crazyhouse:
                    $ref: '#/components/schemas/TvGame'
                  chess960:
                    $ref: '#/components/schemas/TvGame'
                  kingOfTheHill:
                    $ref: '#/components/schemas/TvGame'
                  best:
                    $ref: '#/components/schemas/TvGame'
              examples:
                default:
                  $ref: '#/components/examples/tv-getCurrentTvGames.json'
  /api/tv/feed:
    get:
      operationId: tvFeed
      summary: Stream current TV game
      description: 'Stream positions and moves of the current TV game in ndjson.

        Try it with `curl https://lichess.org/api/tv/feed`.'
      tags:
      - TV
      security: []
      responses:
        '200':
          description: The stream of the current TV game.
          content:
            application/x-ndjson:
              schema:
                $ref: '#/components/schemas/TvFeed'
              examples:
                new featured game:
                  $ref: '#/components/examples/tv-streamCurrentTvGame-newGame.json'
                move:
                  $ref: '#/components/examples/tv-streamCurrentTvGame-move.json'
  /api/tv/{channel}/feed:
    get:
      operationId: tvChannelFeed
      summary: Stream current TV game of a TV channel
      description: 'Stream positions and moves of a current TV channel''s game in ndjson.

        Try it with `curl https://lichess.org/api/tv/rapid/feed`.'
      tags:
      - TV
      security: []
      parameters:
      - in: path
        name: channel
        description: The name of the channel in camel case.
        schema:
          type: string
        required: true
      responses:
        '200':
          description: The stream of the current TV game of a TV channel.
          content:
            application/x-ndjson:
              schema:
                $ref: '#/components/schemas/TvFeed'
              examples:
                new featured game:
                  $ref: '#/components/examples/tv-streamCurrentTvGame-newGame.json'
                move:
                  $ref: '#/components/examples/tv-streamCurrentTvGame-move.json'
  /api/tv/{channel}:
    get:
      operationId: tvChannelGames
      summary: Get best ongoing games of a TV channel
      description: 'Get a list of ongoing games for a given TV channel. Similar to lichess.org/games.

        Available in PGN or ndjson format, depending on the request `Accept` header.'
      tags:
      - TV
      security: []
      parameters:
      - $ref: '#/components/parameters/AcceptPgnOrNdjson'
      - in: path
        name: channel
        description: The name of the channel in camel case.
        schema:
          type: string
        required: true
      - in: query
        name: nb
        description: Number of games to fetch.
        schema:
          type: integer
          default: 10
          minimum: 1
          maximum: 30
      - in: query
        name: moves
        description: Include the PGN moves.
        schema:
          type: boolean
          default: true
      - in: query
        name: pgnInJson
        description: Include the full PGN within the JSON response, in a `pgn` field.
        schema:
          type: boolean
          default: false
      - in: query
        name: tags
        description: Include the PGN tags.
        schema:
          type: boolean
          default: true
      - in: query
        name: clocks
        description: 'Include clock status when available.

          Either as PGN comments: `2. exd5 { [%clk 1:01:27] } e5 { [%clk 1:01:28] }`

          Or in a `clocks` JSON field, as centisecond integers, depending on the response type.

          '
        schema:
          type: boolean
          default: false
      - in: query
        name: opening
        description: 'Include the opening name.

          Example: `[Opening "King''s Gambit Accepted, King''s Knight Gambit"]`

          '
        schema:
          type: boolean
          default: false
      responses:
        '200':
          description: The representation of the games.
          content:
            application/x-chess-pgn:
              schema:
                $ref: '#/components/schemas/GamePgn'
              examples:
                pgn:
                  $ref: '#/components/examples/tv-getBestOngoingGamesOfTvChannel.pgn'
            application/x-ndjson:
              schema:
                $ref: '#/components/schemas/GameJson'
              examples:
                default:
                  $ref: '#/components/examples/tv-getBestOngoingGamesOfTvChannel.json'
components:
  schemas:
    GamePgn:
      type: string
      example: '[Event "Rated Blitz game"]

        [Site "https://lichess.org/fY44h4OY"]

        [Date "2018.03.29"]

        [Round "-"]

        [White "pveldman"]

        [Black "thibault"]

        [Result "1-0"]

        [UTCDate "2018.03.29"]

        [UTCTime "01:38:15"]

        [WhiteElo "1610"]

        [BlackElo "1601"]

        [WhiteRatingDiff "+10"]

        [BlackRatingDiff "-10"]

        [Variant "Standard"]

        [TimeControl "180+0"]

        [ECO "C62"]

        [Opening "Ruy Lopez: Steinitz Defense"]

        [Termination "Normal"]


        1. e4 { [%clk 0:03:00] } e5 { [%clk 0:03:00] } 2. Nf3 { [%clk 0:02:59] } Nc6 { [%clk 0:02:58] } 3. Bb5 { [%clk 0:02:57] } d6 { [%clk 0:02:55] } 4. h3 { [%clk 0:02:54] } Nf6 { [%clk 0:02:52] } 5. Bxc6+ { [%clk 0:02:52] } bxc6 { [%clk 0:02:49] } 6. d3 { [%clk 0:02:51] } Be7 { [%clk 0:02:46] } 7. O-O { [%clk 0:02:47] } O-O { [%clk 0:02:45] } 8. b3 { [%clk 0:02:45] } d5 { [%clk 0:02:45] } 9. exd5 { [%clk 0:02:33] } cxd5 { [%clk 0:02:40] } 10. Nxe5 { [%clk 0:02:31] } Qd6 { [%clk 0:02:38] } 1-0

        '
    GameJson:
      type: object
      properties:
        id:
          type: string
        rated:
          type: boolean
        variant:
          $ref: '#/components/schemas/VariantKey'
        speed:
          $ref: '#/components/schemas/Speed'
        perf:
          type: string
        createdAt:
          type: integer
          format: int64
        lastMoveAt:
          type: integer
          format: int64
        status:
          $ref: '#/components/schemas/GameStatusName'
        source:
          type: string
        players:
          $ref: '#/components/schemas/GamePlayers'
        initialFen:
          type: string
        winner:
          $ref: '#/components/schemas/GameColor'
        opening:
          $ref: '#/components/schemas/GameOpening'
        moves:
          type: string
        pgn:
          type: string
        daysPerTurn:
          type: integer
        analysis:
          type: array
          items:
            $ref: '#/components/schemas/GameMoveAnalysis'
        tournament:
          type: string
        swiss:
          type: string
        clock:
          type: object
          properties:
            initial:
              type: integer
            increment:
              type: integer
            totalTime:
              type: integer
          required:
          - initial
          - increment
          - totalTime
        clocks:
          type: array
          items:
            type: integer
        division:
          type: object
          properties:
            middle:
              type: integer
              description: Ply at which the middlegame begins
            end:
              type: integer
              description: Ply at which the endgame begins
          required: []
      required:
      - id
      - rated
      - variant
      - speed
      - perf
      - createdAt
      - lastMoveAt
      - status
      - players
    GameMoveAnalysis:
      type: object
      properties:
        eval:
          type: integer
          description: Evaluation in centipawns
        mate:
          type: integer
          description: Number of moves until forced mate
        best:
          type: string
          example: c2c3
          description: Best move in UCI notation (only if played move was inaccurate)
        variation:
          type: string
          example: c3 Nc6 d4 Qb6 Be2 Nge7 Na3 cxd4 cxd4 Nf5
          description: Best variation in SAN notation (only if played move was inaccurate)
        judgment:
          type: object
          description: Judgment annotation (only if played move was inaccurate)
          properties:
            name:
              type: string
              enum:
              - Inaccuracy
              - Mistake
              - Blunder
            comment:
              type: string
              example: Blunder. Nxg6 was best.
    VariantKey:
      type: string
      enum:
      - standard
      - chess960
      - crazyhouse
      - antichess
      - atomic
      - horde
      - kingOfTheHill
      - racingKings
      - threeCheck
      - fromPosition
      example: standard
      default: standard
    TvFeedFeatured:
      type: object
      title: featured
      properties:
        t:
          type: string
          description: 'The type of message.

            A summary of the game is sent as the first message and when the featured game changes.

            Subsequent messages are just the X-FEN, last move, and clocks.

            '
          const: featured
        d:
          type: object
          description: The data of the message
          title: featured
          properties:
            id:
              type: string
              description: The game ID
            orientation:
              $ref: '#/components/schemas/GameColor'
            players:
              type: array
              items:
                type: object
                properties:
                  color:
                    $ref: '#/components/schemas/GameColor'
                  user:
                    $ref: '#/components/schemas/LightUser'
                  rating:
                    type: integer
                  seconds:
                    type: integer
                    description: The player's remaining time in seconds
                required:
                - color
                - rating
                - seconds
                - user
              minItems: 2
              maxItems: 2
            fen:
              type: string
              description: The X-FEN of the current position
          required:
          - id
          - orientation
          - players
          - fen
      required:
      - t
      - d
    TvGame:
      type: object
      properties:
        user:
          $ref: '#/components/schemas/LightUser'
        rating:
          type: integer
        gameId:
          type: string
        color:
          $ref: '#/components/schemas/GameColor'
      required:
      - user
      - rating
      - gameId
      - color
    GameOpening:
      type: object
      properties:
        eco:
          type: string
        name:
          type: string
        ply:
          type: integer
      required:
      - eco
      - name
      - ply
    Flair:
      type: string
      description: See [available flair list and images](https://github.com/lichess-org/lila/tree/master/public/flair)
    GameStatusName:
      type: string
      enum:
      - created
      - started
      - aborted
      - mate
      - resign
      - stalemate
      - timeout
      - draw
      - outoftime
      - cheat
      - noStart
      - unknownFinish
      - insufficientMaterialClaim
      - variantEnd
    TvFeedFen:
      type: object
      title: fen
      properties:
        t:
          type: string
          description: 'The type of message.

            A summary of the game is sent as the first message and when the featured game changes.

            Subsequent messages are just the X-FEN, last move, and clocks.

            '
          const: fen
        d:
          type: object
          description: The data of the message
          title: fen
          properties:
            fen:
              type: string
              description: The X-FEN of the current position
            lm:
              type: string
              description: 'The last move in UCI format (King to rook for Chess960-compatible

                castling notation)

                '
            wc:
              type: integer
              description: White's clock in seconds
            bc:
              type: integer
              description: Black's clock in seconds
          required:
          - fen
          - lm
          - wc
          - bc
      required:
      - t
      - d
    Speed:
      type: string
      enum:
      - ultraBullet
      - bullet
      - blitz
      - rapid
      - classical
      - correspondence
    Patron:
      type: boolean
      deprecated: true
      description: 'Use patronColor value instead to determine if player is a patron.

        '
    PatronColor:
      type: integer
      description: '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.

        '
      minimum: 1
      maximum: 10
    Title:
      type: string
      enum:
      - GM
      - WGM
      - IM
      - WIM
      - FM
      - WFM
      - NM
      - CM
      - WCM
      - WNM
      - LM
      - BOT
      description: only appears if the user is a titled player or a bot user
    TvFeed:
      oneOf:
      - $ref: '#/components/schemas/TvFeedFeatured'
      - $ref: '#/components/schemas/TvFeedFen'
    GameColor:
      type: string
      enum:
      - white
      - black
    LightUser:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        flair:
          $ref: '#/components/schemas/Flair'
        title:
          $ref: '#/components/schemas/Title'
        patron:
          $ref: '#/components/schemas/Patron'
        patronColor:
          $ref: '#/components/schemas/PatronColor'
      required:
      - id
      - name
    GamePlayers:
      type: object
      properties:
        white:
          $ref: '#/components/schemas/GamePlayerUser'
        black:
          $ref: '#/components/schemas/GamePlayerUser'
      required:
      - white
      - black
    GamePlayerUser:
      type: object
      properties:
        user:
          $ref: '#/components/schemas/LightUser'
        rating:
          type: integer
        ratingDiff:
          type: integer
        name:
          type: string
        provisional:
          type: boolean
        aiLevel:
          type: integer
        analysis:
          type: object
          properties:
            inaccuracy:
              type: integer
            mistake:
              type: integer
            blunder:
              type: integer
            acpl:
              type: integer
            accuracy:
              type: integer
          required:
          - inaccuracy
          - mistake
          - blunder
          - acpl
        team:
          type: string
      required:
      - user
      - rating
  examples:
    tv-streamCurrentTvGame-newGame.json:
      value:
        t: featured
        d:
          id: 2i3nCKuq
          orientation: black
          players:
          - color: white
            user:
              name: DrawMerchant
              title: IM
              id: drawmerchant
            rating: 2787
            seconds: 60
          - color: black
            user:
              name: Empathy666
              flair: symbols.black-heart
              id: empathy666
            rating: 2876
            seconds: 60
          fen: 2n1rrk1/1p3ppp/3p4/pP1P2qn/2PB4/5Q2/P1N2PPP/R4RK1 w - - 5 21
    tv-getBestOngoingGamesOfTvChannel.json:
      value:
        id: nQSXy8Zw
        rated: true
        variant: standard
        speed: bullet
        perf: bullet
        createdAt: 1778812619976
        lastMoveAt: 1778812625792
        status: started
        source: friend
        players:
          white:
            user:
              name: Chess-uae
              id: chess-uae
            rating: 2995
          black:
            user:
              name: eloWhitekingchess
              flair: nature.horse-face
              id: elowhitekingchess
            rating: 2868
        opening:
          eco: A00
          name: 'Hungarian Opening: Indian Defense'
          ply: 2
        moves: g3 Nf6 Bg2 d6 Nf3 g6 O-O Bg7 d4 O-O c4 c6
        clocks:
        - 3000
        - 3000
        - 3000
        - 3000
        - 3000
        - 2964
        - 3000
        - 2964
        - 3000
        - 2964
        - 3000
        - 2955
        pgn: '[Event "rated bullet game"]

          [Site "https://lichess.org/nQSXy8Zw"]

          [Date "2026.05.15"]

          [Round "-"]

          [White "Chess-uae"]

          [Black "eloWhitekingchess"]

          [Result "*"]

          [GameId "nQSXy8Zw"]

          [UTCDate "2026.05.15"]

          [UTCTime "02:36:59"]

          [WhiteElo "2995"]

          [BlackElo "2868"]

          [Variant "Standard"]

          [TimeControl "30+0"]

          [ECO "A00"]

          [Opening "Hungarian Opening: Indian Defense"]

          [Termination "Unterminated"]


          1. g3 { [%clk 0:00:30] } 1... Nf6 { [%clk 0:00:30] } 2. Bg2 { [%clk 0:00:30] } 2... d6 { [%clk 0:00:30] } 3. Nf3 { [%clk 0:00:30] } 3... g6 { [%clk 0:00:30] } 4. O-O { [%clk 0:00:30] } 4... Bg7 { [%clk 0:00:30] } 5. d4 { [%clk 0:00:30] } 5... O-O { [%clk 0:00:30] } 6. c4 { [%clk 0:00:30] } 6... c6 { [%clk 0:00:30] } *



          '
        clock:
          initial: 30
          increment: 0
          totalTime: 30
    tv-getCurrentTvGames.json:
      value:
        chess960:
          user:
            name: realNomenNescio
            id: realnomennescio
          rating: 2366
          gameId: doTaX3pm
          color: black
        best:
          user:
            name: DrawMerchant
            title: IM
            id: drawmerchant
          rating: 2787
          gameId: 2i3nCKuq
          color: black
        antichess:
          user:
            name: Penguinept
            flair: activity.puzzle-piece
            id: penguinept
          rating: 2197
          gameId: Mm5RSBXg
          color: white
        computer:
          user:
            name: AIDARED
            flair: food-drink.red-apple
            id: aidared
          rating: 2506
          gameId: Y1D9abkF
          color: white
        bullet:
          user:
            name: DrawMerchant
            title: IM
            id: drawmerchant
          rating: 2787
          gameId: 2i3nCKuq
          color: black
        horde:
          user:
            name: Andr88
            flair: symbols.triangular-flag
            id: andr88
          rating: 2133
          gameId: zv6BfeT6
          color: black
        atomic:
          user:
            name: cyberpunks
            flair: smileys.cold-face
            patron: true
            patronColor: 1
            id: cyberpunks
          rating: 1932
          gameId: EBddIJbc
          color: white
        bot:
          user:
            name: PetersBot
            title: BOT
            id: petersbot
          rating: 2921
          gameId: 0xBV4AeD
          color: black
        racingKings:
          user:
            name: AahaanTheChamp
            flair: food-drink.mango
            id: aahaanthechamp
          rating: 2135
          gameId: HEmN5MUd
          color: white
        ultraBullet:
          user:
            name: Lumbrerosky
            id: lumbrerosky
          rating: 1942
          gameId: v2WgmhmU
          color: black
        blitz:
          user:
            name: Bugzilla
            title: IM
            id: bugzilla
          rating: 2629
          gameId: Si5fCcRw
          color: white
        kingOfTheHill:
          user:
            name: sorrymyfault
            id: sorrymyfault
          rating: 2357
          gameId: ugZHqrgZ
          color: white
        crazyhouse:
          user:
            name: Mini_verse
            flair: smileys.skull
            id: mini_verse
          rating: 2295
          gameId: f2RI9DMl
          color: black
        threeCheck:
          user:
            name: blit2
            id: blit2
          rating: 1978
          gameId: ltR9SqXm
          color: black
        classical:
          user:
            name: Matador85
            id: matador85
          rating: 2356
          gameId: JBrftNJe
          color: white
        rapid:
          user:
            name: fito2
            title: FM
            id: fito2
          rating: 2479
          gameId: EUO98ic9
          color: white
    tv-getBestOngoingGamesOfTvChannel.pgn:
      value: '[Event "rated bullet game"]

        [Site "https://lichess.org/nQSXy8Zw"]

        [Date "2026.05.15"]

        [Round "-"]

        [White "Chess-uae"]

        [Black "eloWhitekingchess"]

        [Result "*"]

        [GameId "nQSXy8Zw"]

        [UTCDate "2026.05.15"]

        [UTCTime "02:36:59"]

        [WhiteElo "2995"]

        [BlackElo "2868"]

        [Variant "Standard"]

        [TimeControl "30+0"]

        [ECO "A00"]

        [Termination "Unterminated"]


        1. g3 Nf6 2. Bg2 d6 3. Nf3 g6 4. O-O Bg7 5. d4 O-O 6. c4 c6 *



        [Event "GRAN FINAL BULLET RAW ABRIL Team Battle"]

        [Site "https://lichess.org/9U5Mc8fc"]

        [Date "2026.05.15"]

        [Round "-"]

        [White "Goku102020newaccount"]

        [Black "Misterio666"]

        [Result "*"]

        [GameId "9U5Mc8fc"]

        [UTCDate "2026.05.15"]

        [UTCTime "02:36:36"]

        [WhiteElo "2826"]

        [BlackElo "2530"]

        [Variant "Standard"]

        [TimeControl "60+0"]

        [ECO "A40"]

        [Termination "Unterminated"]


        1. d4 e6 2. Bf4 Nf6 3. e3 d5 4. Nf3 Bd6 5. Bg3 Ne4 6. Nbd2 f5 7. c4 c6 8. Qb3 O-O 9. Bd3 Kh8 10. Bxe4 fxe4 11. Ne5 Bxe5 12. Bxe5 Nd7 13. Bg3 Nf6 *



        [Event "rated bullet game"]

        [Site "https://lichess.org/tQrb3I5l"]

        [Date "2026.05.15"]

        [Round "-"]

        [White "eloWhitekingchess"]

        [Black "Chess-uae"]

        [Result "0-1"]

        [GameId "tQrb3I5l"]

        [UTCDate "2026.05.15"]

        [UTCTime "02:36:23"]

        [WhiteElo "2872"]

        [BlackElo "2991"]

        [WhiteRatingDiff "-4"]

        [BlackRatingDiff "+4"]

        [Variant "Standard"]

        [TimeControl "30+0"]

        [ECO "A05"]

        [Termination "Normal"]


        1. Nf3 g6 2. d3 Nf6 3. g3 Bg7 4. Bg2 O-O 5. O-O d5 6. c3 c5 7. Qc2 Nc6 8. Nbd2 d4 9. e3 dxc3 10. bxc3 Bf5 11. e4 Bg4 12. Nc4 b5 13. Ne3 Rc8 14. Nxg4 Nxg4 15. h3 Nge5 16. Nxe5 Bxe5 17. Rd1 Bg7 18. Be3 b4 19. cxb4 Nxb4 20. Qb3 Bxa1 21. Rxa1 Qxd3 22. Qa4 Rfd8 23. Qxa7 Nc2 24. Rc1 Nxe3 25. Qxe7 Nxg2 26. Kxg2 Re8 0-1

        '
    tv-streamCurrentTvGame-move.json:
      value:
        t: fen
        d:
          fen: 2n1rrk1/1p3ppp/3p4/pP1P2qn/2PB4/5Q2/P1N2PPP/4RRK1 b - - 6 21
          lm: a1e1
          wc: 39
          bc: 43
  parameters:
    AcceptPgnOrNdjson:
      in: header
      name: Accept
      description: 'Specify the desired response format.

        Use `application/x-chess-pgn` to get the games in PGN format.

        Use `application/x-ndjson` to get the games in ndjson format. [Read about ndjson here](#description/streaming-with-nd-json) and how you can parse it in Javascript.

        '
      schema:
        type: string
        enum:
        - application/x-chess-pgn
        - application/x-ndjson
        default: application/x-chess-pgn
  securitySchemes:
    OAuth2:
      type: oauth2
      description: 'Read [the introduction for how to make authenticated requests](#description/authentication).

        '
      flows:
        authorizationCode:
          authorizationUrl: https://lichess.org/oauth
          tokenUrl: https://lichess.org/api/token
          scopes:
            preference:read: Read your preferences
            preference:write: Write your preferences
            email:read: Read your email address
            engine:read: Read your external engines
            engine:write: Create, update, delete your external engines
            challenge:read: Read incoming challenges
            challenge:write: Create, accept, decline challenges
            challenge:bulk: Create, delete, query bulk pairings
            study:read: Read private studies and broadcasts
            study:write: Create, update, delete studies and broadcasts
            tournament:write: Create tournaments
            racer:write: Create and join puzzle races
            puzzle:read: Read puzzle activity
            puzzle:write: Write puzzle activity
            team:read: Read private team information
            team:write: Join, leave teams
            team:lead: Manage teams (kick members, send PMs)
            follow:read: Read followed players
            follow:write: Follow and unfollow other players
            msg:write: Send private messages to other players
            board:play: Play with the Board API
            bot:play: Play with the Bot API. Only for [Bot accounts](#tag/bot/POST/api/bot/account/upgrade)
            web:mod: Use moderator tools (within the bounds of your permissions)
x-provenance:
  method: harvested
  publisher: Lichess
  source: https://lichess.org/openapi.yaml
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)