LIlichess
Bot

Upgrade to Bot account

Upgrade a lichess player account into a Bot account. Only Bot accounts can use the Bot API. The account cannot have played any game before becoming a Bot account. The upgrade is irreversible. The account will only be able to play as a Bot. To upgrade an account to Bot, use the official lichess-bot client, or follow these steps:

  • Create an API access token with "Play bot moves" permission.
  • curl -d '' https://lichess.org/api/bot/account/upgrade -H "Authorization: Bearer <yourTokenHere>" To know if an account has already been upgraded, use the Get my profile API: the title field should be set to BOT.
post/api/bot/account/upgrade

Request

  • Base URL
    https://lichess.org
  • URL
    https://lichess.org/api/bot/account/upgrade
  • Auth
    OAuth 2
    Authorization code: https://lichess.org/oauth
    Token URL: https://lichess.org/api/token scopes: bot:play

Response

The bot account was successfully upgraded.

okboolean required

Changes

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