Games

Add or remove a bookmark on a game, for the logged in user. By default, the bookmark is toggled: added if absent, removed if present. Use the v parameter to explicitly set the bookmark instead, making the request idempotent. Bookmarked games can be downloaded with the export your bookmarked games endpoint.

post/bookmark/{gameId}

Request

  • Base URL
    https://lichess.org
  • URL
    https://lichess.org/bookmark/{gameId}
  • Auth
    OAuth 2
    Authorization code: https://lichess.org/oauth
    Token URL: https://lichess.org/api/token scopes: preference:write

Path parameters

gameIdstring required
Example:5IrD6Gzz

Query parameters

vboolean

Explicitly set the bookmark instead of toggling it. true adds the bookmark, false removes it.

Response

The bookmark was successfully added or removed.

Changes