Bot API 10.3

Bot API 10.3, released by Telegram on 2026-08-24.

Fetch it

https://raw.githubusercontent.com/DOFER998/telegram-bot-api-schema/v10.3.1/spec.json
https://raw.githubusercontent.com/DOFER998/telegram-bot-api-schema/v10.3.1/openapi.json

What it holds

Types	400
Methods	185
Fields and parameters	2820
Enums	37
Fields carrying extracted facts	715

What Telegram changed in 10.3

Rich Messages

• Added the class RichMessageButton representing a button in a RichMessage.
• Added the class RichTextButton.
• Added the classes RichBlockButtons and InputRichBlockButtons.
• Added the field is_compact to the classes RichBlockTable and InputRichBlockTable.
• Added the classes RichBlockExpandableBlockQuotation and InputRichBlockExpandableBlockQuotation representing a block quotation, which can be expanded or collapsed back.
• Added the classes RichBlockDocument and InputRichBlockDocument, containing a file.
• Added support for links of the form tg://document?id= for general file uploads in rich messages.

Ephemeral messages

• Added the class EphemeralMessageParameters and replaced the parameters receiver_user_id and callback_query_id in the methods sendMessage, sendAnimation, sendAudio, sendDocument, sendLivePhoto, sendPhoto, sendSticker, sendVideo, sendVideoNote, sendVoice, sendContact, sendLocation and sendVenue with the parameter ephemeral_message_parameters.
• Added the parameter ephemeral_message_parameters to the method sendRichMessage.
• Added the field replace_callback_query_message to the class EphemeralMessageParameters, which allows bots to show an ephemeral message in place of the original message.
• Supported upload of new files in editEphemeralMessageMedia.
• Added the parameter show_caption_above_media to the method editEphemeralMessageCaption.
• Added the parameter rich_message to the method editEphemeralMessageText.
• Added the field can_send_welcome_messages to the classes ChatAdministratorRights and ChatMemberAdministrator.
• Added the parameter can_send_welcome_messages to the method promoteChatMember.

Reply markup

• Added the class DisabledButton and the field disabled to the class InlineKeyboardButton.
• Added the field force_reply to the classes InlineKeyboardMarkup and ReplyKeyboardMarkup.

General

• Added the parameters can_stop and keep_on_stop to the methods sendMessageDraft and sendRichMessageDraft.
• Added updates about user stopping message generation, represented by the class MessageGenerationStopped and the field stopped_message_generation in the class Update.
• Added the class CommunityChatJoined and the field community_chat_joined to the class Message for service messages about join of a chat from a community.
• Added the fields text, entities and is_private to the class UniqueGiftInfo.

Bot API 10.3

Bot API 10.3, released by Telegram on 2026-08-24.

Fetch it

https://raw.githubusercontent.com/DOFER998/telegram-bot-api-schema/v10.3.0/spec.json
https://raw.githubusercontent.com/DOFER998/telegram-bot-api-schema/v10.3.0/openapi.json

What it holds

Types	400
Methods	185
Fields and parameters	2820
Enums	37
Fields carrying extracted facts	715

What Telegram changed in 10.3

Rich Messages

• Added the class RichMessageButton representing a button in a RichMessage.
• Added the class RichTextButton.
• Added the classes RichBlockButtons and InputRichBlockButtons.
• Added the field is_compact to the classes RichBlockTable and InputRichBlockTable.
• Added the classes RichBlockExpandableBlockQuotation and InputRichBlockExpandableBlockQuotation representing a block quotation, which can be expanded or collapsed back.
• Added the classes RichBlockDocument and InputRichBlockDocument, containing a file.
• Added support for links of the form tg://document?id= for general file uploads in rich messages.

Ephemeral messages

• Added the class EphemeralMessageParameters and replaced the parameters receiver_user_id and callback_query_id in the methods sendMessage, sendAnimation, sendAudio, sendDocument, sendLivePhoto, sendPhoto, sendSticker, sendVideo, sendVideoNote, sendVoice, sendContact, sendLocation and sendVenue with the parameter ephemeral_message_parameters.
• Added the parameter ephemeral_message_parameters to the method sendRichMessage.
• Added the field replace_callback_query_message to the class EphemeralMessageParameters, which allows bots to show an ephemeral message in place of the original message.
• Supported upload of new files in editEphemeralMessageMedia.
• Added the parameter show_caption_above_media to the method editEphemeralMessageCaption.
• Added the parameter rich_message to the method editEphemeralMessageText.
• Added the field can_send_welcome_messages to the classes ChatAdministratorRights and ChatMemberAdministrator.
• Added the parameter can_send_welcome_messages to the method promoteChatMember.

Reply markup

• Added the class DisabledButton and the field disabled to the class InlineKeyboardButton.
• Added the field force_reply to the classes InlineKeyboardMarkup and ReplyKeyboardMarkup.

General

• Added the parameters can_stop and keep_on_stop to the methods sendMessageDraft and sendRichMessageDraft.
• Added updates about user stopping message generation, represented by the class MessageGenerationStopped and the field stopped_message_generation in the class Update.
• Added the class CommunityChatJoined and the field community_chat_joined to the class Message for service messages about join of a chat from a community.
• Added the fields text, entities and is_private to the class UniqueGiftInfo.