v3

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

Challenges

Challenge the AI

Start a game with Lichess AI. You will be notified on the event stream that a new game has started.

post/api/challenge/ai

Response

The game with Lichess AI was successfully started.

idstring

speed'ultraBullet' | 'bullet' | 'blitz' | 'rapid' | 'classical' | 'correspondence'

perf'ultraBullet' | 'bullet' | 'blitz' | 'rapid' | 'classical' | 'correspondence' | 'chess960' | 'crazyhouse' | 'antichess' | 'atomic' | 'horde' | 'kingOfTheHill' | 'racingKings' | 'threeCheck'

ratedboolean

fenstring

turnsinteger

source'lobby' | 'friend' | 'ai' | 'api' | 'tournament' | 'position' | 'import' | 'importlive' | 'simul' | 'relay' | 'pool' | 'arena' | 'swiss'

createdAtinteger

player'white' | 'black'

fullIdstring

Example response

{
  "variant": {
    "key": "standard"
  }
}