POST /setGameScore – Photon Telegram Bot API

Telegram Bot API

Changed on Jun 14, 2026

Use this method to set the score of the specified user in a game message. On success, if the message is not an inline message, the Message is returned, otherwise True is returned. Returns an error, if the new score is not greater than the user's current score in the chat and force is False.

post/setGameScore

Request

Base URL: https://api.telegram.org/bot<bot_token>
URL: https://api.telegram.org/bot<bot_token>/setGameScore
Auth: none declared

Request body

user_idinteger required

User identifier

scoreinteger required

New score, must be non-negative

forceboolean

Pass True if the high score is allowed to decrease. This can be useful when fixing mistakes or banning cheaters.

disable_edit_messageboolean

Pass True if the game message should not be automatically edited to include the current scoreboard

chat_idinteger

Required if inline_message_id is not specified. Unique identifier for the target chat.

message_idinteger

Required if inline_message_id is not specified. Identifier of the sent message.

inline_message_idstring

Required if chat_id and message_id are not specified. Identifier of the inline message.

Response

Telegram API response

oktrue required

Changes

Jun 14, 2026e4c250383b33 Revision changes
- info
  added the optional property ///////////// to the response with the status
- info
  added the optional property //////////////// to the response with the status
- info
  added the optional property //////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property //////////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property //////////////////// to the response with the status
- info
  added the optional property //////////////// to the response with the status
- info
  added the optional property ///////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property ///////////////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property ///////////////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property ///////////////////// to the response with the status
- info
  added the optional property ///////////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property ///////////////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property //////////////////// to the response with the status
- info
  added the optional property /////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property ///////////// to the response with the status
- info
  added the optional property /////////// to the response with the status
- info
  added the optional property /////////// to the response with the status
- info
  added the optional property //////////////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property //////////////// to the response with the status
- info
  added the optional property //////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property //////////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property //////////////// to the response with the status
- info
  added the optional property //////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property /////////// to the response with the status
- info
  added the optional property /////////// to the response with the status
- info
  added the optional property ///////////// to the response with the status

Operation history