Challenges

Add time to the opponent clock

Add seconds to the opponent's clock. Can be used to create games with time odds.

post/api/round/{gameId}/add-time/{seconds}

Request

  • Base URL
    https://lichess.org
  • URL
    https://lichess.org/api/round/{gameId}/add-time/{seconds}
  • 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

secondsinteger required

How many seconds to give

Response

Time was successfully added to the opponent's clock.

okboolean required

Changes

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