Challenges

Accept a challenge

Accept an incoming challenge. You should receive a gameStart event on the incoming events stream.

post/api/challenge/{challengeId}/accept

Request

  • Base URL
    https://lichess.org
  • URL
    https://lichess.org/api/challenge/{challengeId}/accept
  • Auth
    OAuth 2
    Authorization code: https://lichess.org/oauth
    Token URL: https://lichess.org/api/token scopes: challenge:write, bot:play, board:play

Path parameters

challengeIdstring required
Example:5IrD6Gzz

Query parameters

color'white' | 'black'

Accept challenge as this color (only valid if this is an open challenge)

Response

The challenge was successfully accepted.

okboolean required

Changes

No recorded changes to this operation across all 16 revisions of this API.