Telegram Bot API changelog
Every change to the Telegram Bot API from version 9.0 (April 2025) to the current Bot API 10.5 (November 22, 2026), newest first. Method names link to our reference with parameters and examples; class names link to the official documentation.
Bot API 10.5 Latest
New methods: setMySettings
Bot Settings
- Added the method setMySettings, allowing bots to change their settings, including inline mode settings, privacy mode, the ability to be added to groups, forum topic mode in private chats, and the mode of receiving callback queries.
- Added the ability to receive callback queries from buttons in messages sent by the bot with the field inline_message_id instead of the field message in the class CallbackQuery, depending on the parameter callback_query_mode of the method setMySettings.
- Added the ability for bots to show the list of topics in a sidebar in private chats with the bot using the parameter has_topic_sidebar of the method setMySettings.
- Split out the class BotFullInfo from the class User and changed the return type of the method getMe to BotFullInfo. The fields that were returned only in getMe were removed from the class User.
- Added the field active_usernames to the class BotFullInfo, allowing the bot to get the list of all its active usernames.
- Added the field inline_query_placeholder to the class BotFullInfo, allowing the bot to get its placeholder for inline queries.
- Added the field needs_inline_query_location to the class BotFullInfo, allowing the bot to check whether it requests the location of the user with every inline query.
- Added the field has_topic_sidebar to the class BotFullInfo, allowing the bot to check whether topics in private chats with the bot are shown in a sidebar.
General
- Added the ability for bot owners to invite up to 10 users at once to private chats with the bot by pressing the link
https://t.me/botinvite/<bot_username>. The bot can send messages to the invited users. - Added the field inviter to the class WriteAccessAllowed for service messages about users invited to the private chat with the bot by the owner of the bot.
- Replaced the field text with the field blocks in the classes RichBlockExpandableBlockQuotation and InputRichBlockExpandableBlockQuotation, allowing expandable block quotations to contain arbitrary blocks.
Bot API 10.4
New methods: sendWidget, sendSharedWidget, answerWidgetQuery, editMessageWidgetData, editSharedWidgetData, getChatShareThemeBackdrops, getUniqueGift, deleteBusinessAccountGift
Widgets
- Added the class Widget and the field widget to the classes Message and ExternalReplyInfo for messages with HTML widgets.
- Added the method sendWidget, allowing bots to send messages with HTML widgets. Currently, in the production environment, widgets can be sent only to private chats, and sent widgets automatically have protected content and therefore can't be forwarded.
- Added the method sendSharedWidget, allowing bots to send again shared widgets created by the bot.
- Added the class WidgetQuery and the field widget_query to the class Update for queries sent to the bot by widgets in messages sent by the bot or via the bot.
- Added the class SharedWidgetQuery and the field shared_widget_query to the class Update for queries sent to the bot from forwarded messages with shared widgets.
- Added the classes WidgetQueryType, WidgetQueryTypeData, WidgetQueryTypeSignData, WidgetQueryTypeSentTransaction and WidgetQueryWallet, describing the type of a query from a widget. A query can contain data for the bot together with the TON wallet card of the user, data signed by a TON wallet of the user, or a notification about a transaction sent from a TON wallet of the user.
- Added the method answerWidgetQuery, allowing bots to answer queries from widgets.
- Added the method editMessageWidgetData, allowing bots to change data of a widget in a message.
- Added the method editSharedWidgetData, allowing bots to change public data of a shared widget.
- Added the classes InputWidgetMessageContent and InputSharedWidgetMessageContent, allowing bots to send widgets in response to inline queries. Currently, widgets can't be sent in response to inline queries in the production environment.
- Widget messages can't be copied using the methods copyMessage and copyMessages.
- The right can_send_other_messages in the classes ChatPermissions and ChatMemberRestricted now also allows sending widgets.
Ephemeral messages
- Allowed bots to send ephemeral replies to callback queries in any chat except channel direct messages chats by specifying callback_query_id without receiver_user_id in the parameter ephemeral_message_parameters of the methods sendMessage, sendRichMessage, sendAnimation, sendAudio, sendContact, sendDocument, sendLivePhoto, sendLocation, sendPhoto, sendSticker, sendVenue, sendVideo, sendVideoNote and sendVoice.
- The field receiver_user_id of the class EphemeralMessageParameters and the parameter chat_id of the mentioned methods are optional now.
Quotes from rich messages
- Added the field rich_texts to the class TextQuote for quotes chosen from a RichMessage.
- Added the field quote_rich_texts to the class ReplyParameters, allowing bots to quote rich messages.
TON wallet
- Added the classes TonWalletCard, TonWalletCardSticker, TonNft and TonNftAttribute, and the field ton_wallet_card to the class ChatFullInfo.
- Added the class TonWalletTransfer and the field ton_wallet_transfer to the class Message for service messages about transfers with a TON wallet.
- Renamed the class StoryAreaPosition to AreaPosition, because it is now also used to describe the position of stickers on TON wallet cards.
Chat share themes
- Added the classes ChatShareTheme, ChatShareThemeEmoji and ChatShareThemeUniqueGift, and the field share_theme to the class ChatFullInfo, describing the theme of the screen for sharing a link to a user or a chat.
- Added the classes EmojiType, EmojiTypeEmoji and EmojiTypeCustomEmoji.
- Added the classes ChatShareThemeBackdrop and ChatShareThemeBackdrops and the method getChatShareThemeBackdrops.
Gifts
- Added the method getUniqueGift, allowing bots to get information about a unique gift by its name.
- Added the method deleteBusinessAccountGift, allowing bots to delete regular gifts owned by a managed business account without receiving Telegram Stars for them.
General
- Allowed users with a Telegram Premium subscription to assign secondary usernames ending with “agent”, “ai”, “app”, “game”, or “gay” to up to 2 owned bots. Such usernames can be suggested in the field suggested_username of the class KeyboardButtonRequestManagedBot.
- Added the class RichTextTonAddress representing an address in the TON blockchain in a RichMessage.
- Added the type “ton_address” to the class MessageEntity for addresses in the TON blockchain.
- Added the type “bank_card_number” to the class MessageEntity for bank card numbers.
- Added the parameters custom_description_parse_mode and custom_description_entities to the methods verifyUser and verifyChat.
- Added the class PaidMessagesWaived and the field paid_messages_waived to the class Message for service messages about the sender using a link which allows sending messages without paying Telegram Stars.
- Added the ability to create links to topics in private chats with the bot in the format
https://t.me/<bot_username>/<message_thread_id>. Such a link opens the topic only for the user in the private chat with whom the topic exists.
Bot API 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.2
New methods: editEphemeralMessageText, editEphemeralMessageMedia, editEphemeralMessageCaption, editEphemeralMessageReplyMarkup, deleteEphemeralMessage
Rich Messages
- Added the class InputRichMessageMedia and the field media to the class InputRichMessage, allowing bots to explicitly specify media used in markdown or html formatting when sending a rich message.
- Added the class InputMediaVoiceNote, representing a voice message to be sent.
- Added the class InputRichBlockListItem, which represents an item in a list to be sent.
- Added the classes InputRichBlockParagraph, InputRichBlockSectionHeading, InputRichBlockPreformatted, InputRichBlockFooter, InputRichBlockDivider, InputRichBlockMathematicalExpression, InputRichBlockAnchor, InputRichBlockList, InputRichBlockBlockQuotation, InputRichBlockPullQuotation, InputRichBlockCollage, InputRichBlockSlideshow, InputRichBlockTable, InputRichBlockDetails, InputRichBlockMap, InputRichBlockAnimation, InputRichBlockAudio, InputRichBlockPhoto, InputRichBlockVideo, InputRichBlockVoiceNote and InputRichBlockThinking, which represent different types of blocks available to format an outgoing rich message.
- Added the field blocks to the class InputRichMessage, allowing bots to specify rich message formatting via block entities.
Ephemeral Messages
- Introduced support for Ephemeral Messages, allowing bots to send group messages and receive commands that are visible only to a specific user and the bot.
- Added the field is_ephemeral to the class BotCommand.
- Added the field receiver_user to the class Message.
- Added the field ephemeral_message_id to the class Message.
- Added the parameters receiver_user_id and callback_query_id to the methods sendMessage, sendAnimation, sendAudio, sendDocument, sendLivePhoto, sendPhoto, sendSticker, sendVideo, sendVideoNote, sendVoice, sendContact, sendLocation, sendVenue.
- Added the field ephemeral_message_id to the class ReplyParameters, allowing bots to reply to ephemeral messages.
- Marked the field message_id in the class ReplyParameters as optional if the field ephemeral_message_id is present.
- Added the methods editEphemeralMessageText, editEphemeralMessageMedia, editEphemeralMessageCaption, and editEphemeralMessageReplyMarkup allowing bots to edit ephemeral messages.
- Added the method deleteEphemeralMessage allowing bots to delete ephemeral messages.
Communities
- Introduced initial support for Communities - several supergroups, channels, and bots linked together around a shared topic or audience.
- Added the class Community which represents a community.
- Added the class CommunityChatAdded and the field community_chat_added to the class Message.
- Added the class CommunityChatRemoved and the field community_chat_removed to the class Message.
- Added the field community to the class ChatFullInfo.
General
- Added updates about changes to a user payment subscription, represented by the class BotSubscriptionUpdated and the field subscription in the class Update.
- Hardened the security of Mini Apps by disallowing the usage of Mini App methods from origins different from the original Mini App domain. The protection will be automatically enabled for all Mini Apps on July 20, 2026. You can opt-out from the protection through the @BotFather Mini App. If you do so, you acknowledge that it is the responsibility of the bot to ensure that the Mini App has no links to untrusted sites.
Bot API 10.1
New methods: sendRichMessage, sendRichMessageDraft, answerChatJoinRequestQuery, sendChatJoinRequestWebApp
Rich Messages
- Added support for Rich Messages, allowing bots to send highly structured text and stream AI-generated replies with seamless rich formatting.
- Added the classes RichTextBold, RichTextItalic, RichTextUnderline, RichTextStrikethrough, RichTextSpoiler, RichTextDateTime, RichTextTextMention, RichTextSubscript, RichTextSuperscript, RichTextMarked, RichTextCode, RichTextCustomEmoji, RichTextMathematicalExpression, RichTextUrl, RichTextEmailAddress, RichTextPhoneNumber, RichTextBankCardNumber, RichTextMention, RichTextHashtag, RichTextCashtag, RichTextBotCommand, RichTextAnchor, RichTextAnchorLink, RichTextReference and RichTextReferenceLink, which represent different types of rich formatted text.
- Added the class RichText, which represents rich formatted text.
- Added the class RichBlockCaption, which represents the caption of a rich formatted text.
- Added the class RichBlockTableCell, which represents a cell in a table.
- Added the class RichBlockListItem, which represents an item in a list.
- Added the classes RichBlockParagraph, RichBlockSectionHeading, RichBlockPreformatted, RichBlockFooter, RichBlockDivider, RichBlockMathematicalExpression, RichBlockAnchor, RichBlockList, RichBlockBlockQuotation, RichBlockPullQuotation, RichBlockCollage, RichBlockSlideshow, RichBlockTable, RichBlockDetails, RichBlockMap, RichBlockAnimation, RichBlockAudio, RichBlockPhoto, RichBlockVideo, RichBlockVoiceNote and RichBlockThinking, which represent different types of blocks in a rich formatted message.
- Added the class RichBlock, which represents a block in a rich formatted message.
- Added the class RichMessage, which represents a rich formatted message.
- Added the field rich_message to the class Message.
- Added the class InputRichMessage, describing a rich message to send.
- Added the class InputRichMessageContent and allowed it to be used as InputMessageContent in results of inline, guest, and Web App queries.
- Added the method sendRichMessage, allowing bots to send rich messages.
- Added the method sendRichMessageDraft, allowing bots to stream partial rich messages.
- Added the parameter rich_message to the method editMessageText, allowing bots to edit rich messages.
Join Request Queries
- Added the field supports_join_request_queries to the class User.
- Added the field guard_bot to the class ChatFullInfo.
- Added the field query_id to the class ChatJoinRequest.
- Added the method answerChatJoinRequestQuery.
- Added the method sendChatJoinRequestWebApp.
Polls
- Added the class Link and the field link to the class PollMedia.
- Added the class InputMediaLink and allowed it to be used as InputPollOptionMedia.
Bot API 10.0
New methods: answerGuestQuery, deleteAllMessageReactions, deleteMessageReaction, sendLivePhoto, getManagedBotAccessSettings, setManagedBotAccessSettings, getUserPersonalChatMessages
Guest Mode
- Introduced support for guest mode, allowing bots to receive certain messages and issue replies within chats they are not a member of.
- Added the field supports_guest_queries to the class User.
- Added the fields guest_bot_caller_user and guest_bot_caller_chat to the class Message.
- Added the field guest_query_id to the class Message.
- Added the field guest_message to the class Update.
- Added the class SentGuestMessage and the method answerGuestQuery.
Chat Management
- Added the field can_react_to_messages to the classes ChatMemberRestricted and ChatPermissions.
- Added the parameter return_bots to the method getChatAdministrators.
- Added the method deleteAllMessageReactions.
- Added the method deleteMessageReaction.
- Added the ability to see certain messages sent by other bots in groups.
Polls
- Added the classes InputMediaSticker, InputMediaLocation, and InputMediaVenue.
- Added the class PollMedia, representing a media in a poll.
- Added the field media to the class Poll, allowing bots to see media in polls.
- Added the field explanation_media to the class Poll, allowing bots to see media in quiz explanations.
- Added the field media to the class PollOption, allowing bots to see media in poll options.
- Added the class InputPollMedia and the parameters media and explanation_media to the method sendPoll, allowing bots to add media to polls.
- Added the class InputPollOptionMedia and the field media to the class InputPollOption, allowing bots to add media to poll options.
- Added the field members_only to the class Poll.
- Added the parameter members_only to the method sendPoll.
- Added the field country_codes to the class Poll.
- Added the parameter country_codes to the method sendPoll.
- Decreased the minimum number of poll options from 2 to 1.
Live photos
- Added the class LivePhoto, which represents a photo with a short video.
- Added the class InputMediaLivePhoto.
- Added the field live_photo to the classes Message and ExternalReplyInfo.
- Added the method sendLivePhoto, allowing bots to send live photos.
- Added the class PaidMediaLivePhoto, which describes a paid media with a live photo.
- Added the class InputPaidMediaLivePhoto, allowing bots to send live photos as paid media.
- Allowed to use live photos in sendMediaGroup and editMessageMedia,
General
- Allowed Business Bots to manage user accounts without a Telegram Premium subscription.
- Added the ability to send messages to other bots via username if both bots enabled bot-to-bot communication.
- Added the ability to reply to other bots from a business bot if the business bot enabled bot-to-bot communication.
- Allowed bots to pass an empty text in the method sendMessageDraft.
- Added the class BotAccessSettings and the method getManagedBotAccessSettings.
- Added the method setManagedBotAccessSettings.
- Added the method getUserPersonalChatMessages.
Bot API 9.6
New methods: getManagedBotToken, replaceManagedBotToken, savePreparedKeyboardButton
Managed Bots
- Added the field can_manage_bots to the class User.
- Added the class KeyboardButtonRequestManagedBot and the field request_managed_bot to the class KeyboardButton.
- Added the class ManagedBotCreated and the field managed_bot_created to the class Message.
- Added updates about the creation of managed bots and the change of their token, represented by the class ManagedBotUpdated and the field managed_bot in the class Update.
- Added the methods getManagedBotToken and replaceManagedBotToken.
- Added the class PreparedKeyboardButton and the method savePreparedKeyboardButton, allowing bots to request users, chats and managed bots from Mini Apps.
- Added the method requestChat to the class WebApp.
- Added support for
https://t.me/newbot/{manager_bot_username}/{suggested_bot_username}[?name={suggested_bot_name}]links, allowing bots to request the creation of a managed bot via a link.
Polls
- Added support for quizzes with multiple correct answers.
- Replaced the field correct_option_id with the field correct_option_ids in the class Poll.
- Replaced the parameter correct_option_id with the parameter correct_option_ids in the method sendPoll.
- Allowed to pass allows_multiple_answers for quizzes in the method sendPoll.
- Increased the maximum time for automatic poll closure to 2628000 seconds.
- Added the field allows_revoting to the class Poll.
- Added the parameter allows_revoting to the method sendPoll.
- Added the parameter shuffle_options to the method sendPoll.
- Added the parameter allow_adding_options to the method sendPoll.
- Added the parameter hide_results_until_closes to the method sendPoll.
- Added the fields description and description_entities to the class Poll.
- Added the parameters description, description_parse_mode, and description_entities to the method sendPoll.
- Added the field persistent_id to the class PollOption, representing a persistent identifier for the option.
- Added the field option_persistent_ids to the class PollAnswer.
- Added the fields added_by_user and added_by_chat to the class PollOption, denoting the user and the chat which added the option.
- Added the field addition_date to the class PollOption, describing the date when the option was added.
- Added the class PollOptionAdded and the field poll_option_added to the class Message.
- Added the class PollOptionDeleted and the field poll_option_deleted to the class Message.
- Added the field poll_option_id to the class ReplyParameters, allowing bots to reply to a specific poll option.
- Added the field reply_to_poll_option_id to the class Message.
- Allowed “date_time” entities in checklist title, checklist task text, TextQuote, ReplyParameters quote, sendGift, and giftPremiumSubscription.
Bot API 9.5
New methods: setChatMemberTag
- Added the MessageEntity type “date_time”, allowing bots to show a formatted date and time to the user.
- Allowed all bots to use the method sendMessageDraft.
- Added the field tag to the classes ChatMemberMember and ChatMemberRestricted.
- Added the method setChatMemberTag.
- Added the field can_edit_tag to the classes ChatMemberRestricted and ChatPermissions.
- Added the field can_manage_tags to the classes ChatMemberAdministrator and ChatAdministratorRights.
- Added the parameter can_manage_tags to the method promoteChatMember.
- Added the field sender_tag to the class Message.
- Added the field iconCustomEmojiId to the class BottomButton.
Bot API 9.4
New methods: setMyProfilePhoto, removeMyProfilePhoto, getUserProfileAudios
- Allowed bots to use custom emoji in messages directly sent by the bot to private, group and supergroup chats if the owner of the bot has a Telegram Premium subscription.
- Allowed bots to create topics in private chats using the method createForumTopic.
- Allowed bots to prevent users from creating and deleting topics in private chats through a new setting in the @BotFather Mini App.
- Added the field allows_users_to_create_topics to the class User.
- Added the field icon_custom_emoji_id to the classes KeyboardButton and InlineKeyboardButton, allowing bots to show a custom emoji on buttons if they are able to use custom emoji in the message.
- Added the field style to the classes KeyboardButton and InlineKeyboardButton, allowing bots to change the color of buttons.
- Added the class ChatOwnerLeft and the field chat_owner_left to the class Message.
- Added the class ChatOwnerChanged and the field chat_owner_changed to the class Message.
- Added the methods setMyProfilePhoto and removeMyProfilePhoto, allowing bots to manage their profile picture.
- Added the class VideoQuality and the field qualities to the class Video allowing bots to get information about other available qualities of a video.
- Added the field first_profile_audio to the class ChatFullInfo.
- Added the class UserProfileAudios and the method getUserProfileAudios, allowing bots to fetch a list of audios added to the profile of a user.
- Added the field rarity to the class UniqueGiftModel.
- Added the field is_burned to the class UniqueGift.
Bot API 9.3
New methods: sendMessageDraft, getUserGifts, getChatGifts, repostStory
Topics in private chats
- Added the field has_topics_enabled to the class User, which can be used to determine whether forum topic mode is enabled for the bot in private chats.
- Added the method sendMessageDraft, allowing partial messages to be streamed to a user while being generated.
- Supported the fields message_thread_id and is_topic_message in the class Message for messages in private chats with forum topic mode enabled.
- Supported the parameter message_thread_id in private chats with topics in the methods sendMessage, sendPhoto, sendVideo, sendAnimation, sendAudio, sendDocument, sendPaidMedia, sendSticker, sendVideoNote, sendVoice, sendLocation, sendVenue, sendContact, sendPoll, sendDice, sendInvoice, sendGame, sendMediaGroup, copyMessage, copyMessages, forwardMessage, and forwardMessages, allowing bots to send a message to a specific topic.
- Supported the parameter message_thread_id in private chats in the method sendChatAction, allowing bots to send chat actions to a specific topic in private chats.
- Supported the parameter message_thread_id in private chats with topics in the method editForumTopic, deleteForumTopic, and unpinAllForumTopicMessages, allowing bots to manage topics in private chats.
- Added the field is_name_implicit to the classes ForumTopic and ForumTopicCreated.
Gifts
- Added the methods getUserGifts and getChatGifts.
- Replaced the field last_resale_star_count with the fields last_resale_currency and last_resale_amount in the class UniqueGiftInfo.
- Replaced the parameter exclude_limited with the parameters exclude_limited_upgradable and exclude_limited_non_upgradable in the method getBusinessAccountGifts.
- Added the value “gifted_upgrade” as a possible value of UniqueGiftInfo.origin for messages about the upgrade of a gift that was purchased after it was sent.
- Added the value “offer” as a possible value of UniqueGiftInfo.origin for messages about the purchase of a gift through a purchase offer.
- Added the field gift_upgrade_sent to the class Message.
- Added the field gift_id to the class UniqueGift.
- Added the field is_from_blockchain to the class UniqueGift.
- Added the parameter exclude_from_blockchain in the method getBusinessAccountGifts, to filter out gifts that were assigned from the TON blockchain.
- Added the fields personal_total_count and personal_remaining_count to the class Gift.
- Added the field is_premium to the classes Gift and UniqueGift.
- Added the field is_upgrade_separate to the classes GiftInfo and OwnedGiftRegular.
- Added the class UniqueGiftColors that describes the color scheme for a user's name, replies to messages and link previews based on a unique gift.
- Added the field has_colors to the class Gift.
- Added the field colors to the class UniqueGift.
- Added the class GiftBackground and the field background to the class Gift.
- Added the field unique_gift_variant_count to the class Gift.
- Added the field unique_gift_number to the classes GiftInfo and OwnedGiftRegular.
- Added the field gifts_from_channels to the class AcceptedGiftTypes.
Miscellaneous
- Allowed bots to disable their main username if they have additional active usernames purchased on Fragment.
- Allowed bots to disable the right can_restrict_members in channel chats.
- Added the method repostStory, allowing bots to repost stories across different business accounts they manage.
- Added the class UserRating and the field rating to the class ChatFullInfo.
- Increased the maximum price for paid media to 25000 Telegram Stars.
- Added the field paid_message_star_count to the class ChatFullInfo.
- Added the parameter message_effect_id to the methods forwardMessage and copyMessage.
- Added the field unique_gift_colors to the class ChatFullInfo.
- Added the field completed_by_chat to the class ChecklistTask.
Bot API 9.2
New methods: approveSuggestedPost, declineSuggestedPost
Checklists
- Added the field checklist_task_id to the class ReplyParameters, allowing bots to reply to a specific checklist task.
- Added the field reply_to_checklist_task_id to the class Message.
Gifts
- Added the field publisher_chat to the classes Gift and UniqueGift which can be used to get information about the chat that published a gift.
Direct Messages in Channels
- Added the field is_direct_messages to the classes Chat and ChatFullInfo which can be used to identify supergroups that are used as channel direct messages chats.
- Added the field parent_chat to the class ChatFullInfo which indicates the parent channel chat for a channel direct messages chat.
- Added the class DirectMessagesTopic and the field direct_messages_topic to the class Message, describing a topic of a direct messages chat.
- Added the parameter direct_messages_topic_id to the methods sendMessage, sendPhoto, sendVideo, sendAnimation, sendAudio, sendDocument, sendPaidMedia, sendSticker, sendVideoNote, sendVoice, sendLocation, sendVenue, sendContact, sendDice, sendInvoice, sendMediaGroup, copyMessage, copyMessages, forwardMessage and forwardMessages. This parameter can be used to send a message to a direct messages chat topic.
Suggested Posts
- Added the class SuggestedPostParameters and the parameter suggested_post_parameters to the methods sendMessage, sendPhoto, sendVideo, sendAnimation, sendAudio, sendDocument, sendPaidMedia, sendSticker, sendVideoNote, sendVoice, sendLocation, sendVenue, sendContact, sendDice, sendInvoice, copyMessage, forwardMessage. This parameter can be used to send a suggested post to a direct messages chat topic.
- Added the method approveSuggestedPost, allowing bots to approve incoming suggested posts.
- Added the method declineSuggestedPost, allowing bots to decline incoming suggested posts.
- Added the field can_manage_direct_messages to the classes ChatMemberAdministrator and ChatAdministratorRights.
- Added the parameter can_manage_direct_messages to the method promoteChatMember.
- Added the field is_paid_post to the class Message, which can be used to identify paid posts. Such posts must not be deleted for 24 hours to receive the payment.
- Added the class SuggestedPostPrice, describing the price of a suggested post.
- Added the class SuggestedPostInfo and the field suggested_post_info to the class Message, describing a suggested post.
- Added the class SuggestedPostApproved and the field suggested_post_approved to the class Message, describing a service message about the approval of a suggested post.
- Added the class SuggestedPostApprovalFailed and the field suggested_post_approval_failed to the class Message, describing a service message about the failed approval of a suggested post.
- Added the class SuggestedPostDeclined and the field suggested_post_declined to the class Message, describing a service message about the rejection of a suggested post.
- Added the class SuggestedPostPaid and the field suggested_post_paid to the class Message, describing a service message about a successful payment for a suggested post.
- Added the class SuggestedPostRefunded and the field suggested_post_refunded to the class Message, describing a service message about a payment refund for a suggested post.
Bot API 9.1
New methods: sendChecklist, editMessageChecklist, getMyStarBalance
Checklists
- Added the class ChecklistTask representing a task in a checklist.
- Added the class Checklist representing a checklist.
- Added the class InputChecklistTask representing a task to add to a checklist.
- Added the class InputChecklist representing a checklist to create.
- Added the field checklist to the classes Message and ExternalReplyInfo, describing a checklist in a message.
- Added the class ChecklistTasksDone and the field checklist_tasks_done to the class Message, describing a service message about status changes for tasks in a checklist (i.e., marked as done/not done).
- Added the class ChecklistTasksAdded and the field checklist_tasks_added to the class Message, describing a service message about the addition of new tasks to a checklist.
- Added the method sendChecklist, allowing bots to send a checklist on behalf of a business account.
- Added the method editMessageChecklist, allowing bots to edit a checklist on behalf of a business account.
Gifts
- Added the field next_transfer_date to the classes OwnedGiftUnique and UniqueGiftInfo.
- Added the field last_resale_star_count to the class UniqueGiftInfo.
- Added “resale” as the possible value of the field origin in the class UniqueGiftInfo.
General
- Increased the maximum number of options in a poll to 12.
- Added the method getMyStarBalance, allowing bots to get their current balance of Telegram Stars.
- Added the class DirectMessagePriceChanged and the field direct_message_price_changed to the class Message, describing a service message about a price change for direct messages sent to the channel chat.
- Added the method hideKeyboard to the class WebApp.
Bot API 9.0
New methods: readBusinessMessage, deleteBusinessMessages, setBusinessAccountName, setBusinessAccountUsername, setBusinessAccountBio, setBusinessAccountProfilePhoto, removeBusinessAccountProfilePhoto, setBusinessAccountGiftSettings, getBusinessAccountStarBalance, transferBusinessAccountStars, getBusinessAccountGifts, convertGiftToStars, upgradeGift, transferGift, postStory, editStory, deleteStory, giftPremiumSubscription
Business Accounts
- Added the class BusinessBotRights and replaced the field can_reply with the field rights of the type BusinessBotRights in the class BusinessConnection.
- Added the method readBusinessMessage, allowing bots to mark incoming messages as read on behalf of a business account.
- Added the method deleteBusinessMessages, allowing bots to delete messages on behalf of a business account.
- Added the method setBusinessAccountName, allowing bots to change the first and last name of a managed business account.
- Added the method setBusinessAccountUsername, allowing bots to change the username of a managed business account.
- Added the method setBusinessAccountBio, allowing bots to change the bio of a managed business account.
- Added the class InputProfilePhoto, describing a profile photo to be set.
- Added the methods setBusinessAccountProfilePhoto and removeBusinessAccountProfilePhoto, allowing bots to change the profile photo of a managed business account.
- Added the method setBusinessAccountGiftSettings, allowing bots to change the privacy settings pertaining to incoming gifts in a managed business account.
- Added the class StarAmount and the method getBusinessAccountStarBalance, allowing bots to check the current Telegram Star balance of a managed business account.
- Added the method transferBusinessAccountStars, allowing bots to transfer Telegram Stars from the balance of a managed business account to their own balance for withdrawal.
- Added the classes OwnedGiftRegular, OwnedGiftUnique, OwnedGifts and the method getBusinessAccountGifts, allowing bots to fetch the list of gifts owned by a managed business account.
- Added the method convertGiftToStars, allowing bots to convert gifts received by a managed business account to Telegram Stars.
- Added the method upgradeGift, allowing bots to upgrade regular gifts received by a managed business account to unique gifts.
- Added the method transferGift, allowing bots to transfer unique gifts owned by a managed business account.
- Added the classes InputStoryContentPhoto and InputStoryContentVideo representing the content of a story to post.
- Added the classes StoryArea, StoryAreaPosition, LocationAddress, StoryAreaTypeLocation, StoryAreaTypeSuggestedReaction, StoryAreaTypeLink, StoryAreaTypeWeather and StoryAreaTypeUniqueGift, describing clickable active areas on stories.
- Added the method postStory, allowing bots to post a story on behalf of a managed business account.
- Added the method editStory, allowing bots to edit stories they had previously posted on behalf of a managed business account.
- Added the method deleteStory, allowing bots to delete stories they had previously posted on behalf of a managed business account.
Mini Apps
- Added the field DeviceStorage, allowing Mini Apps to use persistent local storage on the user's device.
- Added the field SecureStorage, allowing Mini Apps to use a secure local storage on the user's device for sensitive data.
Gifts
- Added the classes UniqueGiftModel, UniqueGiftSymbol, UniqueGiftBackdropColors, and UniqueGiftBackdrop to describe the properties of a unique gift.
- Added the class UniqueGift describing a gift that was upgraded to a unique one.
- Added the class AcceptedGiftTypes describing the types of gifts that are accepted by a user or a chat.
- Replaced the field can_send_gift with the field accepted_gift_types of the type AcceptedGiftTypes in the class ChatFullInfo.
- Added the class GiftInfo and the field gift to the class Message, describing a service message about a regular gift that was sent or received.
- Added the class UniqueGiftInfo and the field unique_gift to the class Message, describing a service message about a unique gift that was sent or received.
Telegram Premium
- Added the method giftPremiumSubscription, allowing bots to gift a user a Telegram Premium subscription paid in Telegram Stars.
- Added the field premium_subscription_duration to the class TransactionPartnerUser for transactions involving a Telegram Premium subscription purchased by the bot.
- Added the field transaction_type to the class TransactionPartnerUser, simplifying the differentiation and processing of all transaction types.
General
- Increased the maximum price for paid media to 10000 Telegram Stars.
- Increased the maximum price for a subscription period to 10000 Telegram Stars.
- Added the class PaidMessagePriceChanged and the field paid_message_price_changed to the class Message, describing a service message about a price change for paid messages sent to the chat.
- Added the field paid_star_count to the class Message, containing the number of Telegram Stars that were paid to send the message.
Earlier versions
Releases before Bot API 9.0 are listed with their dates. Their full descriptions are in the official changelog.
- Bot API 8.3 — February 12, 2025
- Bot API 8.2 — January 1, 2025
- Bot API 8.1 — December 4, 2024
- Bot API 8.0 — November 17, 2024
- Bot API 7.11 — October 31, 2024
- Bot API 7.10 — September 6, 2024
- Bot API 7.9 — August 14, 2024
- Bot API 7.8 — July 31, 2024
- Bot API 7.7 — July 7, 2024
- Bot API 7.6 — July 1, 2024
- Bot API 7.5 — June 18, 2024
- Bot API 7.4 — May 28, 2024
- Bot API 7.3 — May 6, 2024
- Bot API 7.2 — March 31, 2024
- Bot API 7.1 — February 16, 2024
- Bot API 7.0 — December 29, 2023
- Bot API 6.9 — September 22, 2023
- Bot API 6.8 — August 18, 2023
- Bot API 6.7 — April 21, 2023
- Bot API 6.6 — March 9, 2023
- Bot API 6.5 — February 3, 2023
- Bot API 6.4 — December 30, 2022
- Bot API 6.3 — November 5, 2022
- Bot API 6.2 — August 12, 2022
- Bot API 6.1 — June 20, 2022
- Bot API 6.0 — April 16, 2022
- Bot API 5.7 — January 31, 2022
- Bot API 5.6 — December 30, 2021
- Bot API 5.5 — December 7, 2021
- Bot API 5.4 — November 5, 2021
- Bot API 5.3 — June 25, 2021
- Bot API 5.2 — April 26, 2021
- Bot API 5.1 — March 9, 2021
- Bot API 5.0 — November 4, 2020
- Bot API 4.9 — June 4, 2020
- Bot API 4.8 — April 24, 2020
- Bot API 4.7 — March 30, 2020
- Bot API 4.6 — January 23, 2020
- Bot API 4.5 — December 31, 2019
- Bot API 4.4 — July 29, 2019
- Bot API 4.3 — May 31, 2019
- Bot API 4.2 — April 14, 2019
- Bot API 4.1 — August 27, 2018
- Bot API 4.0 — July 26, 2018
- Bot API 3.6 — February 13, 2018
- Bot API 3.5 — November 17, 2017
- Bot API 3.4 — October 11, 2017
- Bot API 3.3 — August 23, 2017
- Bot API 3.2 — July 21, 2017
- Bot API 3.1 — June 30, 2017
- Bot API 3.0 — May 18, 2017
- Bot API 2.3.1 — December 4, 2016
- Bot API 2.3 — November 21, 2016
- Bot API 2.2. — October 3, 2016
- Bot API 2.1. — May 22, 2016
- Bot API 2.0 — April 9, 2016
Frequently asked questions
What is the latest version of the Telegram Bot API?
Bot API 10.5, released on November 22, 2026. It has 194 methods.
How often does the Telegram Bot API change?
Telegram usually releases a new Bot API version every one to two months. Each release adds methods and fields; some releases also contain breaking changes, which are marked in the descriptions.
How do I find out when a method was added?
Open the method in our methods reference: the Version history section shows the release that added it and the releases that changed it, with links to this page.