ci: update api (#7)

github-actions[bot] · CI · web-flow · commit ffdee2cec109 · 2026-01-31T10:33:35.000Z
Co-authored-by: CI &lt;ci@rman.dev&gt;
diff --git a/specs/lichess-api.yaml b/specs/lichess-api.yaml
@@ -1,6 +1,6 @@
 openapi: "3.1.0"
 info:
-  version: 2.0.112
+  version: 2.0.113
   title: Lichess.org API reference
   contact:
     name: "Lichess.org API"
@@ -117,11 +117,11 @@ tags:
       Works with normal Lichess accounts. Engine play or assistance is [forbidden](https://lichess.org/page/fair-play).
 
       ### Features
-      - [Stream incoming chess moves](#tag/board/get/apiboardgamestreamgameid)
-      - [Play chess moves](#tag/board/post/apiboardgamegameidmovemove)
-      - [Read](#tag/board/get/apiboardgamestreamgameid) and [write](#tag/board/post/apiboardgamegameidchat) in the player and spectator chats
-      - [Receive](#tag/board/get/apistreamevent), [create](#tag/challenges/post/apichallengeusername) and [accept](#tag/challenges/post/apichallengechallengeidaccept) (or [decline](#tag/challenges/post/apichallengechallengeiddecline)) challenges
-      - [Abort](#tag/board/post/apiboardgamegameidabort) and [resign](#tag/board/post/apiboardgamegameidresign) games
+      - [Stream incoming chess moves](#tag/board/GET/api/board/game/stream/{gameId})
+      - [Play chess moves](#tag/board/POST/api/board/game/{gameId}/move/{move})
+      - [Read](#tag/board/GET/api/board/game/stream/{gameId}) and [write](#tag/board/POST/api/board/game/{gameId}/chat) in the player and spectator chats
+      - [Receive](#tag/board/GET/api/stream/event), [create](#tag/challenges/POST/api/challenge/{username}) and [accept](#tag/challenges/POST/api/challenge/{challengeId}/accept) (or [decline](#tag/challenges/POST/api/challenge/{challengeId}/decline)) challenges
+      - [Abort](#tag/board/POST/api/board/game/{gameId}/abort) and [resign](#tag/board/POST/api/board/game/{gameId}/resign) games
       - Compatible with normal Lichess accounts
 
       ### Restrictions
@@ -136,19 +136,21 @@ tags:
       - [Lichs (play from command-line)](https://github.com/Cqsi/lichs)
       - [Lichess discord bot](https://top.gg/bot/707287095911120968)
       - [cli-chess](https://github.com/trevorbayless/cli-chess/)
+      - [Blunderly 3D board](https://github.com/maurimo/blunderly)
+      - Yours? Please make [an issue or pull request](https://github.com/lichess-org/api).
   - name: Bot
     description: |
       Play on Lichess as a bot. Allows engine play.
       Read the [blog post announcement of lichess bots](https://lichess.org/blog/WvDNticAAMu_mHKP/welcome-lichess-bots).
 
-      Only works with [Bot accounts](#tag/bot/post/apibotaccountupgrade).
+      Only works with [Bot accounts](#tag/bot/POST/api/bot/account/upgrade).
 
       ### Features
-      - [Stream incoming chess moves](#tag/bot/get/apibotgamestreamgameid)
-      - [Play chess moves](#tag/bot/post/apibotgamegameidmovemove)
-      - [Read](#tag/bot/get/apibotgamestreamgameid) and [write](#tag/bot/post/apibotgamegameidchat) in the player and spectator chats
-      - [Receive](#tag/bot/get/apistreamevent), [create](#tag/challenges/post/apichallengeusername) and [accept](#tag/challenges/post/apichallengechallengeidaccept) (or [decline](#tag/challenges/post/apichallengechallengeiddecline)) challenges
-      - [Abort](#tag/bot/post/apibotgamegameidabort) and [resign](#tag/bot/post/apibotgamegameidresign) games
+      - [Stream incoming chess moves](#tag/bot/GET/api/bot/game/stream/{gameId})
+      - [Play chess moves](#tag/bot/POST/api/bot/game/{gameId}/move/{move})
+      - [Read](#tag/bot/GET/api/bot/game/stream/{gameId}) and [write](#tag/bot/POST/api/bot/game/{gameId}/chat) in the player and spectator chats
+      - [Receive](#tag/bot/GET/api/stream/event), [create](#tag/challenges/POST/api/challenge/{username}) and [accept](#tag/challenges/POST/api/challenge/{challengeId}/accept) (or [decline](#tag/challenges/POST/api/challenge/{challengeId}/decline)) challenges
+      - [Abort](#tag/bot/POST/api/bot/game/{gameId}/abort) and [resign](#tag/bot/POST/api/bot/game/{gameId}/resign) games
       - Engine assistance is [allowed](https://lichess.org/page/fair-play)
       ### Restrictions
       - Bots can only play challenge games:  pools and tournaments are off-limits
@@ -173,7 +175,7 @@ tags:
       [Official broadcasts](https://lichess.org/broadcast) are maintained by Lichess,
       but you can [create your own broadcasts](https://lichess.org/broadcast/new) to cover any live game or chess event.
       You will need to publish PGN on a public URL so that Lichess can pull updates from it.
-      Alternatively, you can push PGN updates to Lichess using [this API endpoint](#tag/Broadcasts/operation/broadcastPush).
+      Alternatively, you can push PGN updates to Lichess using [this API endpoint](#tag/broadcasts/POST/api/broadcast/round/{broadcastRoundId}/push).
 
       Broadcasts are organized in tournaments, which have several rounds, which have several games.
       You must first create a tournament, then you can add rounds to them.
@@ -186,7 +188,7 @@ tags:
     description: |
       Send and receive challenges to play.
 
-      To create a lot of challenges, consider [bulk pairing](#tag/bulk-pairings/post/apibulk-pairing) instead.
+      To create a lot of challenges, consider [bulk pairing](#tag/bulk-pairings/POST/api/bulk-pairing) instead.
   - name: External engine
     description: |
       **This API is in alpha and subject to change.**
@@ -775,7 +777,7 @@ components:
     OAuth2:
       type: oauth2
       description: |
-        Read [the introduction for how to make authenticated requests](/#description/authentication).
+        Read [the introduction for how to make authenticated requests](#description/authentication).
       flows:
         authorizationCode:
           authorizationUrl: https://lichess.org/oauth
@@ -802,5 +804,5 @@ components:
             "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/apibotaccountupgrade)
+            "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)
diff --git a/specs/schemas/ExternalEngine.yaml b/specs/schemas/ExternalEngine.yaml
@@ -12,7 +12,7 @@ properties:
     type: string
     description: |
       A secret token that can be used to
-      [*request* analysis](#tag/External-engine/operation/apiExternalEngineAnalyse)
+      [*request* analysis](#tag/external-engine/POST/api/external-engine/{id}/analyse)
       from this external engine.
   userId:
     type: string
diff --git a/specs/schemas/ExternalEngineRegistration.yaml b/specs/schemas/ExternalEngineRegistration.yaml
@@ -33,7 +33,7 @@ properties:
     type: string
     description: |
       A random token that can be used to
-      [wait for analysis requests](#tag/External-engine/operation/apiExternalEngineAcquire)
+      [wait for analysis requests](#tag/external-engine/POST/api/external-engine/work)
       and provide analysis.
 
       The engine provider should securely generate a random string.
diff --git a/specs/schemas/UserExtended.yaml b/specs/schemas/UserExtended.yaml
@@ -17,12 +17,12 @@ allOf:
         $ref: "./UserStreamer.yaml"
       followable:
         type: boolean
-        description: only appears if the request is [authenticated with OAuth2](/#description/authentication)
+        description: only appears if the request is [authenticated with OAuth2](#description/authentication)
       following:
         type: boolean
-        description: only appears if the request is [authenticated with OAuth2](/#description/authentication)
+        description: only appears if the request is [authenticated with OAuth2](#description/authentication)
       blocking:
         type: boolean
-        description: only appears if the request is [authenticated with OAuth2](/#description/authentication)
+        description: only appears if the request is [authenticated with OAuth2](#description/authentication)
     required:
       - url
diff --git a/specs/tags/arenatournaments/api-tournament-id-games.yaml b/specs/tags/arenatournaments/api-tournament-id-games.yaml
@@ -6,7 +6,7 @@ get:
     Games are sorted by reverse chronological order (most recent first).
     The game stream is throttled, depending on who is making the request:
       - Anonymous request: 20 games per second
-      - [OAuth2 authenticated](/#description/authentication) request: 30 games per second
+      - [OAuth2 authenticated](#description/authentication) request: 30 games per second
   tags:
     - "Tournaments (Arena)"
   security: []
diff --git a/specs/tags/arenatournaments/api-tournament-id-join.yaml b/specs/tags/arenatournaments/api-tournament-id-join.yaml
@@ -3,7 +3,7 @@ post:
   summary: Join an Arena tournament
   description: |
     Join an Arena tournament, possibly with a password and/or a team.
-    Also unpauses if you had previously [paused](#tag/arena-tournaments/post/apitournamentidwithdraw) the tournament.
+    Also unpauses if you had previously [paused](#tag/arena-tournaments/POST/api/tournament/{id}/withdraw) the tournament.
   tags:
     - "Tournaments (Arena)"
   security:
diff --git a/specs/tags/arenatournaments/api-tournament-team-battle-id.yaml b/specs/tags/arenatournaments/api-tournament-team-battle-id.yaml
@@ -3,7 +3,7 @@ post:
   summary: Update a team battle
   description: |
     Set the teams and number of leaders of a team battle.
-    To update the other attributes of a team battle, use the [tournament update endpoint](#tag/arena-tournaments/post/apitournamentid).
+    To update the other attributes of a team battle, use the [tournament update endpoint](#tag/arena-tournaments/POST/api/tournament/{id}).
   tags:
     - "Tournaments (Arena)"
   security:
diff --git a/specs/tags/arenatournaments/api-tournament.yaml b/specs/tags/arenatournaments/api-tournament.yaml
@@ -163,7 +163,7 @@ post:
               type: string
               description: |
                 Set the ID of a team you lead to create a team battle.
-                The other teams can be added using the [team battle edit endpoint](#tag/arena-tournaments/post/apitournamentteam-battleid).
+                The other teams can be added using the [team battle edit endpoint](#tag/arena-tournaments/POST/api/tournament/team-battle/{id}).
             conditions.teamMember.teamId:
               type: string
               description: |
diff --git a/specs/tags/arenatournaments/api-user-username-tournament-created.yaml b/specs/tags/arenatournaments/api-user-username-tournament-created.yaml
@@ -7,7 +7,7 @@ get:
     Tournaments are streamed as [ndjson](#description/streaming-with-nd-json).
     The stream is throttled, depending on who is making the request:
       - Anonymous request: 20 tournaments per second
-      - [OAuth2 authenticated](/#description/authentication) request: 30 tournaments per second
+      - [OAuth2 authenticated](#description/authentication) request: 30 tournaments per second
       - Authenticated, downloading your own tournaments: 50 tournaments per second
   tags:
     - "Tournaments (Arena)"
diff --git a/specs/tags/arenatournaments/api-user-username-tournament-played.yaml b/specs/tags/arenatournaments/api-user-username-tournament-played.yaml
@@ -7,7 +7,7 @@ get:
     Tournaments are streamed as [ndjson](#description/streaming-with-nd-json).
     The stream is throttled, depending on who is making the request:
       - Anonymous request: 20 tournaments per second
-      - [OAuth2 authenticated](/#description/authentication) request: 30 tournaments per second
+      - [OAuth2 authenticated](#description/authentication) request: 30 tournaments per second
       - Authenticated, downloading your own tournaments: 50 tournaments per second
   tags:
     - "Tournaments (Arena)"
diff --git a/specs/tags/board/api-board-seek.yaml b/specs/tags/board/api-board-seek.yaml
@@ -14,8 +14,8 @@ post:
     If the client closes the connection, the seek is canceled. This way, if the client terminates, the user won't be paired in a game they wouldn't play.
     When the seek is accepted, or expires, the server closes the connection.
 
-    **Make sure to also have an [Event stream](#tag/board/get/apiboardgamestreamgameid) open**, to be notified when a game starts.
-    We recommend opening the [Event stream](#tag/board/get/apiboardgamestreamgameid) first, then the seek stream. This way,
+    **Make sure to also have an [Event stream](#tag/board/GET/api/board/game/stream/{gameId}) open**, to be notified when a game starts.
+    We recommend opening the [Event stream](#tag/board/GET/api/board/game/stream/{gameId}) first, then the seek stream. This way,
     you won't miss the game event if the seek is accepted immediately.
 
     ### Correspondence seek
diff --git a/specs/tags/bot/api-bot-account-upgrade.yaml b/specs/tags/bot/api-bot-account-upgrade.yaml
@@ -7,7 +7,7 @@ post:
     To upgrade an account to Bot, use the [official lichess-bot client](https://github.com/lichess-bot-devs/lichess-bot), or follow these steps:
     - Create an [API access token](https://lichess.org/account/oauth/token/create?scopes[]=bot:play) with "Play bot moves" permission.
     - `curl -d '' https://lichess.org/api/bot/account/upgrade -H "Authorization: Bearer <yourTokenHere>"`
-    To know if an account has already been upgraded, use the [Get my profile API](#tag/account/get/apiaccount):
+    To know if an account has already been upgraded, use the [Get my profile API](#tag/account/GET/api/account):
     the `title` field should be set to `BOT`.
   tags:
     - Bot
diff --git a/specs/tags/broadcasts/api-broadcast-broadcastTournamentId-pgn.yaml b/specs/tags/broadcasts/api-broadcast-broadcastTournamentId-pgn.yaml
@@ -5,7 +5,7 @@ get:
     Download all games of all rounds of a broadcast in PGN format.
     If a `study:read` [OAuth token](#tag/OAuth) is provided,
     the private rounds where the user is a contributor will be available.
-    You may want to [download only the games of a single round](#tag/broadcasts/get/apibroadcastroundbroadcastroundidpgn) instead.
+    You may want to [download only the games of a single round](#tag/broadcasts/GET/api/broadcast/round/{broadcastRoundId}.pgn) instead.
   tags:
     - Broadcasts
   security:
diff --git a/specs/tags/broadcasts/api-broadcast-round-broadcastRoundId-pgn.yaml b/specs/tags/broadcasts/api-broadcast-round-broadcastRoundId-pgn.yaml
@@ -5,7 +5,7 @@ get:
     Download all games of a single round of a broadcast tournament in PGN format.
     You *could* poll this endpoint to get updates about a tournament, but it would be slow,
     and very inefficient.
-    Instead, consider [streaming the tournament](#tag/broadcasts/get/apistreambroadcastroundbroadcastroundidpgn) to get
+    Instead, consider [streaming the tournament](#tag/broadcasts/GET/api/stream/broadcast/round/{broadcastRoundId}.pgn) to get
     a new PGN every time a game is updated, in real-time.
   tags:
     - Broadcasts
diff --git a/specs/tags/broadcasts/broadcast-broadcastTournamentId-new.yaml b/specs/tags/broadcasts/broadcast-broadcastTournamentId-new.yaml
@@ -5,7 +5,7 @@ post:
     Create a new broadcast round to relay external games.
     This endpoint accepts the same form data as the web form.
 
-    Choose one between `syncUrl`, `syncUrls`, `syncIds` and `syncUsers`, if it is missing, the broadcast needs to be fed by [pushing PGN to it](#tag/broadcasts/post/apibroadcastroundbroadcastroundidpush)
+    Choose one between `syncUrl`, `syncUrls`, `syncIds` and `syncUsers`, if it is missing, the broadcast needs to be fed by [pushing PGN to it](#tag/broadcasts/POST/api/broadcast/round/{broadcastRoundId}/push)
   tags:
     - Broadcasts
   security:
diff --git a/specs/tags/broadcasts/broadcast-broadcastTournamentId-players-playerId.yaml b/specs/tags/broadcasts/broadcast-broadcastTournamentId-players-playerId.yaml
@@ -19,7 +19,7 @@ get:
       name: playerId
       description: |
         The unique player ID within the broadcast. This is usually their fideId. 
-        If the player does not have a fideId, it is their name. Consult the [list of players for the broadcast](#tag/Broadcasts/operation/broadcastPlayersGet) for which ID to use.
+        If the player does not have a fideId, it is their name. Consult the [list of players for the broadcast](#tag/broadcasts/GET/broadcast/{broadcastTournamentId}/players) for which ID to use.
       required: true
       schema:
         type: string
diff --git a/specs/tags/challenges/api-challenge-ai.yaml b/specs/tags/challenges/api-challenge-ai.yaml
@@ -3,7 +3,7 @@ post:
   summary: Challenge the AI
   description: |
     Start a game with Lichess AI.
-    You will be notified on the [event stream](#tag/board/get/apiboardgamestreamgameid) that a new game has started.
+    You will be notified on the [event stream](#tag/board/GET/api/board/game/stream/{gameId}) that a new game has started.
   tags:
     - Challenges
   security:
diff --git a/specs/tags/challenges/api-challenge-challengeId-accept.yaml b/specs/tags/challenges/api-challenge-challengeId-accept.yaml
@@ -3,7 +3,7 @@ post:
   summary: Accept a challenge
   description: |
     Accept an incoming challenge.
-    You should receive a `gameStart` event on the [incoming events stream](#tag/board/get/apiboardgamestreamgameid).
+    You should receive a `gameStart` event on the [incoming events stream](#tag/board/GET/api/board/game/stream/{gameId}).
   tags:
     - Challenges
   security:
diff --git a/specs/tags/challenges/api-challenge-open.yaml b/specs/tags/challenges/api-challenge-open.yaml
@@ -8,9 +8,9 @@ post:
     You can control which color each player gets by giving them these URLs,
     instead of the main challenge URL.
     Open challenges expire after 24h.
-    If the challenge creation is [authenticated with OAuth2](/#description/authentication),
-    then you can use the [challenge cancel endpoint](#tag/challenges/post/apichallengechallengeidcancel) to cancel it.
-    To directly pair 2 known players, use [this endpoint](#tag/bulk-pairings/get/apibulk-pairing) instead.
+    If the challenge creation is [authenticated with OAuth2](#description/authentication),
+    then you can use the [challenge cancel endpoint](#tag/challenges/POST/api/challenge/{challengeId}/cancel) to cancel it.
+    To directly pair 2 known players, use [this endpoint](#tag/bulk-pairings/GET/api/bulk-pairing) instead.
   tags:
     - Challenges
   security: []
diff --git a/specs/tags/challenges/api-challenge-username.yaml b/specs/tags/challenges/api-challenge-username.yaml
@@ -3,7 +3,7 @@ post:
   summary: Create a challenge
   description: |
     Challenge someone to play. The targeted player can choose to accept or decline.
-    If the challenge is accepted, you will be notified on the [event stream](#tag/board/get/apiboardgamestreamgameid)
+    If the challenge is accepted, you will be notified on the [event stream](#tag/board/GET/api/board/game/stream/{gameId})
     that a new game has started. The game ID will be the same as the challenge ID.
     Challenges for realtime games (not correspondence) expire after 20s if not accepted.
     To prevent that, use the `keepAliveStream` flag described below.
diff --git a/specs/tags/externalengine/api-external-engine-work.yaml b/specs/tags/externalengine/api-external-engine-work.yaml
@@ -12,7 +12,7 @@ post:
     have been registered with the given `secret`.
     Uses long polling.
     After acquiring a request, the provider should immediately
-    [start streaming the results](#tag/External-engine/operation/apiExternalEngineSubmit).
+    [start streaming the results](#tag/external-engine/POST/api/external-engine/workid).
   requestBody:
     description: Provider credentials.
     required: true
diff --git a/specs/tags/games/api-games-user-username.yaml b/specs/tags/games/api-games-user-username.yaml
@@ -8,7 +8,7 @@ get:
     <https://lichess.org/@/german11> for instance has more than 500,000 games.
     The game stream is throttled, depending on who is making the request:
       - Anonymous request: 20 games per second
-      - [OAuth2 authenticated](/#description/authentication) request: 30 games per second
+      - [OAuth2 authenticated](#description/authentication) request: 30 games per second
       - Authenticated, downloading your own games: 60 games per second
   tags:
     - Games
diff --git a/specs/tags/games/api-import.yaml b/specs/tags/games/api-import.yaml
@@ -4,7 +4,7 @@ post:
   description: |
     Import a game from PGN. See <https://lichess.org/paste>.
     Rate limiting: 200 games per hour for OAuth requests, 100 games per hour for anonymous requests.
-    To broadcast ongoing games, consider [pushing to a broadcast instead](#tag/broadcasts/post/apibroadcastroundbroadcastroundidpush).
+    To broadcast ongoing games, consider [pushing to a broadcast instead](#tag/broadcasts/POST/api/broadcast/round/{broadcastRoundId}/push).
     To analyse a position or a line, just construct an analysis board URL (most standard tags supported if URL-encoded):
     [https://lichess.org/analysis/pgn/e4_e5_Nf3_Nc6_Bc4_Bc5_Bxf7+](https://lichess.org/analysis/pgn/e4_e5_Nf3_Nc6_Bc4_Bc5_Bxf7+)
   tags:
diff --git a/specs/tags/games/api-stream-games-streamId-add.yaml b/specs/tags/games/api-stream-games-streamId-add.yaml
@@ -2,7 +2,7 @@ post:
   operationId: gamesByIdsAdd
   summary: Add game IDs to stream
   description: |
-    Add new game IDs for [an existing stream](#tag/games/post/apistreamgamesstreamid) to watch.
+    Add new game IDs for [an existing stream](#tag/games/POST/api/stream/games/{streamId}) to watch.
     The stream will immediately outputs the games that already exists, then emit an event each time a game is started or finished.
   tags:
     - Games
@@ -12,7 +12,7 @@ post:
       name: streamId
       schema:
         type: string
-        description: The stream ID you used to [create the stream](#tag/games/post/apistreamgamesstreamid).
+        description: The stream ID you used to [create the stream](#tag/games/POST/api/stream/games/{streamId}).
         example: "myAppName-someRandomId"
       required: true
   requestBody:
diff --git a/specs/tags/games/api-stream-games-streamId.yaml b/specs/tags/games/api-stream-games-streamId.yaml
@@ -5,8 +5,8 @@ post:
     Creates a stream of games from an arbitrary streamId, and a list of game IDs.
     The stream first outputs the games that already exists, then emits an event each time a game is started or finished.
     Games are streamed as [ndjson](#description/streaming-with-nd-json).
-    Maximum number of games: 500 for anonymous requests, or 1000 for [OAuth2 authenticated](/#description/authentication) requests.
-    While the stream is open, it is possible to [add new game IDs to watch](#tag/games/post/apistreamgamesstreamidAdd).
+    Maximum number of games: 500 for anonymous requests, or 1000 for [OAuth2 authenticated](#description/authentication) requests.
+    While the stream is open, it is possible to [add new game IDs to watch](#tag/games/POST/api/stream/games/{streamId}/add).
   tags:
     - Games
   security: []
diff --git a/specs/tags/oauth/oauth.yaml b/specs/tags/oauth/oauth.yaml
diff --git a/specs/tags/puzzles/api-puzzle-batch-angle.yaml b/specs/tags/puzzles/api-puzzle-batch-angle.yaml
diff --git a/specs/tags/simuls/api-simul.yaml b/specs/tags/simuls/api-simul.yaml
diff --git a/specs/tags/swisstournaments/api-swiss-id-edit.yaml b/specs/tags/swisstournaments/api-swiss-id-edit.yaml
diff --git a/specs/tags/swisstournaments/api-swiss-id-games.yaml b/specs/tags/swisstournaments/api-swiss-id-games.yaml
