---
title: "Upgrade to Bot account"
method: POST
path: "/api/bot/account/upgrade"
tags: ["Bot"]
---

# Upgrade to Bot account

`POST /api/bot/account/upgrade`

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](https://github.com/lichess-bot-devs/lichess-bot), or follow these steps:
- Create an [API access token](https://lichess.org/account/oauth/token/create?scopes[]=bot:play) 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](#tag/account/GET/api/account):
the `title` field should be set to `BOT`.

## Response `200`

The bot account was successfully upgraded.

- Ok
  - `ok` boolean, required

## Other responses

- `400` — The upgrade of the bot account failed.

---

[API](https://skmtc.net/lichess/apis/lichess-org-api-reference.md) · [All operations](https://skmtc.net/lichess/apis/lichess-org-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lichess/lichess-org-api-reference/versions/1425db81eb3b/schema)