Challenges

Start clocks of a game

Start the clocks of a game immediately, even if a player has not yet made a move. Requires the OAuth tokens of both players with challenge:write scope. If the clocks have already started, the call will have no effect.

For AI games with only one player, omit the token2 parameter.

post/api/challenge/{gameId}/start-clocks

Request

  • Base URL
    https://lichess.org
  • URL
    https://lichess.org/api/challenge/{gameId}/start-clocks
  • Auth
    OAuth 2
    Authorization code: https://lichess.org/oauth
    Token URL: https://lichess.org/api/token scopes: challenge:write

Path parameters

gameIdstring required

ID of the game

Query parameters

token1string required

OAuth token of a player

token2string

OAuth token of the other player. Omit for AI games that have only one player.

Response

The clock of a game was successfully started.

okboolean required

Changes

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