LIlichess
Challenges

Admin challenge tokens

This endpoint can only be used by Lichess administrators. It will not work if you do not have the appropriate permissions. Tournament organizers should instead use OAuth to obtain challenge:write tokens from users in order to perform bulk pairing.* Create and obtain challenge:write tokens for multiple users. If a similar token already exists for a user, it is reused. This endpoint is idempotent.

post/api/token/admin-challenge

Request

  • Base URL
    https://lichess.org
  • URL
    https://lichess.org/api/token/admin-challenge
  • Auth
    OAuth 2
    Authorization code: https://lichess.org/oauth
    Token URL: https://lichess.org/api/token scopes: web:mod

Request body application/x-www-form-urlencoded

usersstring required

Usernames separated with commas

descriptionstring required

User visible description of the token

Example request

{
  "users": "thibault,neio,lizen2,lizen3",
  "description": "FIDE tournament XYZ"
}

Response

The challenge:write tokens of each user

object required

Changes

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