v3

OpenAPI 3.1.0AGPL-3.0-or-later2026-07-311871891.1 MB
Puzzles

Solve multiple puzzles at once

Set puzzles as solved and update ratings.

post/api/puzzle/batch/{angle}

Path parameters

anglestring required
Example:mix

The theme or opening of the solved puzzles.

Available themes are listed in the lichess source code and the lichess training themes hyperlinks.

Query parameters

nbinteger
Example:1

When > 0, the response includes a new puzzle batch with that many puzzles.

This is equivalent to calling /api/puzzle/batch/{angle}, and can sometimes save a request.

Request body

Response

The solved puzzles, named rounds, and a new puzzle batch named puzzles.