---
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.

---

[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)