---
title: "Bookmark a game"
method: POST
path: "/bookmark/{gameId}"
tags: ["Games"]
---

# Bookmark a game

`POST /bookmark/{gameId}`

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](#tag/games/GET/api/games/export/bookmarks) endpoint.

## Path parameters

- `gameId` string, required

## Query parameters

- `v` boolean

## Response `204`

The bookmark was successfully added or removed.

## Changes

> 8 revisions in range; 4 could not be searched.

- **2026-07-26** `291205d29a92` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/lichess/apis/lichess-org-api-reference/changes/bookmark/:gameId/post.md)

---

[API](https://skmtc.dev/lichess/apis/lichess-org-api-reference.md) · [All operations](https://skmtc.dev/lichess/apis/lichess-org-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/lichess/lichess-org-api-reference/revisions/c5ccdaeee7c4/schema)