# Layer changelog
Below you will find information on schema changes. For more details on the use of layers, see [Invoking API methods](/api/invoking.md#layers).
### [Layer 225](/schema?layer=225)
To view all changes since the last documentation refresh, start reading at [layer 215](#layer-215).
This documentation release includes the following new and substantially overhauled articles, documenting pre-existing features:
- [Group calls, video chats, live stories, conferences and livestreams »](/api/group-calls.md)
- [One-to-one calls »](/api/calls.md)
- [Completely overhauled the E2E conference documentation »](/api/end-to-end/group-calls.md)
- [Completely overhauled the file reference database schema, making it significantly easier to autogenerate the file reference database »](/api/file-references.md)
- [Applying basic group updates »](/api/peers.md#basic-group-updates)
- [Applying group call updates »](/api/end-to-end/group-calls.md#handling-updates)
- [Message ID sequences »](/api/updates.md#message-id-sequences)
- [More detailed instructions for update gap handling (also considering gaps beyond the max message box size) »](/api/updates.md#recovering-gaps-for-very-old-messages)
- [Parallel sessions »](/api/datacenter.md#parallel-sessions)
- [updateMessageID handling »](/api/updates.md#updatemessageid-updates)
- [Documented rate limits for live drafts »](/api/bots/ai.md#live-response-streaming)
- [Content protection »](/api/content-protection.md)
- [Message views »](/api/views.md)
- [Sending messages on behalf of owned channels and groups »](/api/channel.md#sending-messages-on-behalf-of-owned-channels-and-groups)
- [Working with basic group participants »](/api/channel.md#basic-group-participants)
- [Leaving groups/channels (full flow) »](/api/channel.md#leaving-groups-channels)
- [Added the layer number to the RPC error DB »](/api/errors.md)
- [Improved the takeout documentation »](/api/takeout.md)
- Documented the [`navigationBarColor` »](/api/web-events.md#navigationbarcolor), [`actionBarColor` »](/api/web-events.md#actionbarcolor), [`allowScroll` »](/api/web-events.md#allowscroll), [`siteName` »](/api/web-events.md#sitename) event types
- [`whitelisted_bots` »](/api/config.md#whitelisted-bots)
- Detailed changelogs for API configuration keys, web events, limits, suggested actions and other API constants will now be automatically listed in the appropriate layer changelog, instead of the latest layer.
- Published an aggregated, machine-readable index of all [API constants and push updates »](/api/config.md#machine-readable-configuration-index) at the new [/api/config.json »](/api/config.json.md) permalink.
- The [RPC error database »](/api/errors.md#error-database) is now also published as a machine-readable [/api/errors.json »](/api/errors.json.md) permalink, replacing the previous embedded file link.
- Multiple other improvements and fixes across the board.
And documenting the following new features (a brief overview of features introduced since [layer 215](#layer-215)):
- AI features: [message composition »](/api/ai.md#compose-messages), [AI compose tones »](/api/ai.md#ai-compose-tones) and [message summarization »](/api/ai.md#summarize-messages)
- Bot AI features: [live drafts »](/api/bots/ai.md#live-response-streaming)
- [Bot forums »](/api/forum.md#bot-forums)
- [Managed bots »](/api/bots/managed-bots.md)
- [Improved styled text entities »](/api/entities.md)
- [Guest mode for bots »](/api/bots/guest-mode.md)
- [Gift auctions »](/api/auctions.md)
- [Passkeys »](/api/passkeys.md)
- [Live stories »](/api/group-calls.md#live-stories), [in-call messages »](/api/group-calls.md#in-call-messages), [paid live story comments »](/api/group-calls.md#paid-live-story-comments) and [paid live story donations »](/api/group-calls.md#paid-live-story-donations)
- [Recent story summaries »](/api/stories.md#recent-story-summaries)
- [Repeating scheduled messages »](/api/scheduled-messages.md#repeating-scheduled-messages)
- [Message views »](/api/views.md#view-counters) and [read metrics »](/api/views.md#read-metrics)
- [Open-answer polls »](/api/poll.md#open-answer-polls), [unread poll votes »](/api/poll.md#unread-poll-votes), [poll answer media attachments »](/api/poll.md#sending-a-poll), [replies to poll options »](/api/poll.md#replying-to-poll-options), [poll search »](/api/poll.md#searching-for-polls) and [poll statistics »](/api/stats.md#poll-statistics)
- [Group member/admin tags »](/api/rank.md)
- [Group/channel ownership transfer »](/api/channel.md#transferring-ownership-of-a-group-channel) and [leave handoff flows »](/api/channel.md#leaving-groups-channels)
- [Date styled text entities »](/api/entities.md#date-entities) and [diff styled text entities »](/api/entities.md#diff-entities)
- [Collectible gifts »](/api/gifts.md#collectible-gifts): [crafting »](/api/gifts.md#crafting-collectible-gifts), [purchase offers »](/api/gifts.md#collectible-gift-purchase-offers), [hosted gifts »](/api/gifts.md#hosted-collectible-gifts), [collectible message palettes »](/api/colors.md#collectible-message-palettes) and [collectible profile palettes »](/api/colors.md#collectible-profile-palettes).
- [Private contact notes »](/api/contacts.md#private-notes-for-contacts)
- [Birthdays »](/api/profile.md#birthday), [music profile tab »](/api/profile.md#music), [managed bot manager info »](/api/profile.md#managed-bot-manager), [personal channels »](/api/profile.md#personal-channel) and [unofficial client warnings »](/api/profile.md#unofficial-client-warning)
- [Private chat content protection »](/api/content-protection.md#for-users)
- [Button styles »](/api/bots/buttons.md#button-styles)
- [Peer requests for Mini Apps »](/api/bots/buttons.md#requesting-peers-via-mini-apps)
- [Anonymous group admins »](/api/rights.md#anonymous-admins) can now [toggle checklist items »](/api/todo.md#mark-items-as-completed)
- [Removing participant reactions »](/api/reactions.md#removing-participant-reactions)
- [Message effects »](/api/effects.md) support for forwarded messages
- [Login email setup suggestions »](/api/auth.md#email-verification) and [passkey setup suggestions »](/api/config.md#setup-passkey)
- [OAuth login »](/api/url-authorization.md)
- [`blur_enabled` in `fullscreen_changed` events »](/api/bots/webapps.md#fullscreen-changed)
- New [deep link »](/api/links.md) types:
- [Parameterized settings deep links, with support for opening a specific settings page or subsection »](/api/links.md#settings-links)
- [Contact list deep links »](/api/links.md#contacts-links)
- [Chat creation deep links »](/api/links.md#new-chat-links)
- [Chat list deep links »](/api/links.md#chat-list-links)
- [Live story deep links »](/api/links.md#live-story-links)
- [Story composer deep links »](/api/links.md#post-story-links)
- [Timestamp links »](/api/links.md#timestamp-links)
- [Highlighting of a specific checklist task or poll option in message deep links »](/api/links.md#message-links)
This layer introduces the following features:
- [Custom AI compose tones »](/api/ai.md#ai-compose-tones)
- [Guest mode for bots »](/api/bots/guest-mode.md)
- [Poll statistics »](/api/stats.md#poll-statistics)
- [Participant reaction moderation »](/api/reactions.md#removing-participant-reactions)
- [Allowed bots to fetch the history of the personal channel of any user »](/api/profile.md#personal-channel)
#### API constants
##### Premium limits
[Telegram Premium limit identifiers »](/api/premium.md#double-limits).
- Added [`double_limits__aicompose_tone_saved` »](/api/premium.md#double-limits-aicompose-tone-saved)
##### Web page type values
Web page type values from the [webPage](/constructor/webPage.md) constructor.
- Added `telegram_aicomposetone` - Preview of an [AI compose tone link »](/api/links.md#ai-compose-tone-links), shared when previewing a [custom AI composer tone »](/api/ai.md#ai-compose-tones). The `attributes` field contains a [webPageAttributeAiComposeTone](/constructor/webPageAttributeAiComposeTone.md) with the [custom emoji »](/api/custom-emoji.md) representing the tone; clients render a button that applies the shared tone.
#### [Schema](/schema.md) changes
##### New Methods
* Added [messages.setBotGuestChatResult](/method/messages.setBotGuestChatResult.md) - Bots may use this method to answer a [guest mode »](/api/bots/guest-mode.md) query received via an [updateBotGuestChatQuery](/constructor/updateBotGuestChatQuery.md) update, providing the message to post into the chat as a guest, see [here »](/api/bots/guest-mode.md#handling-guest-queries-bot-side) for more info.
* Added [messages.deleteParticipantReactions](/method/messages.deleteParticipantReactions.md) - As an admin, remove all of a specific participant's [reactions](/api/reactions.md) from every message in a group or channel.
* Added [messages.deleteParticipantReaction](/method/messages.deleteParticipantReaction.md) - As an admin, remove all of a specific participant's [reactions](/api/reactions.md) from a single message.
* Added [messages.getPersonalChannelHistory](/method/messages.getPersonalChannelHistory.md) - Fetch the message history of a user's [personal channel »](/api/profile.md#personal-channel).
* Added [bots.getAccessSettings](/method/bots.getAccessSettings.md) - Get the [access restriction settings »](/api/bots/managed-bots.md#managing-a-managed-bot) of a managed bot; can only be called by the manager bot.
* Added [bots.editAccessSettings](/method/bots.editAccessSettings.md) - Edit the [access restriction settings »](/api/bots/managed-bots.md#managing-a-managed-bot) of a managed bot; can only be called by the manager bot.
* Added [stats.getPollStats](/method/stats.getPollStats.md) - Get [statistics](/api/stats.md#poll-statistics) for a poll sent in a message.
* Added [aicompose.createTone](/method/aicompose.createTone.md) - Create a new custom [AI composer tone »](/api/ai.md#ai-compose-tones).
* Added [aicompose.updateTone](/method/aicompose.updateTone.md) - Edit a custom [AI composer tone »](/api/ai.md#ai-compose-tones) previously created by the current user. Only the fields whose flag is set will be modified.
* Added [aicompose.saveTone](/method/aicompose.saveTone.md) - Install or uninstall an [AI composer tone »](/api/ai.md#ai-compose-tones), adding it to or removing it from the list of saved tones of the current user.
* Added [aicompose.deleteTone](/method/aicompose.deleteTone.md) - Permanently delete a custom [AI composer tone »](/api/ai.md#ai-compose-tones) created by the current user.
* Added [aicompose.getTone](/method/aicompose.getTone.md) - Fetch information about a single [AI composer tone »](/api/ai.md#ai-compose-tones), for example to resolve a shared tone deep link.
* Added [aicompose.getTones](/method/aicompose.getTones.md) - Fetch the list of saved [AI composer tones »](/api/ai.md#ai-compose-tones) of the current user.
* Added [aicompose.getToneExample](/method/aicompose.getToneExample.md) - Fetch an example showing how an [AI composer tone »](/api/ai.md#ai-compose-tones) rephrases a sample message, used as a preview in the tone picker.
##### Changed Methods
* Added **bots_guestchat** parameter in [contacts.getTopPeers](/method/contacts.getTopPeers.md)
* Added **tone** parameter, removed **change_tone** parameter in [messages.composeMessageWithAI](/method/messages.composeMessageWithAI.md)
##### New Constructors
* Added [updateBotGuestChatQuery](/constructor/updateBotGuestChatQuery.md) - Sent to [guest bots »](/api/bots/guest-mode.md) when a user invokes the bot as a guest in a chat. The bot should reply by invoking [messages.setBotGuestChatResult](/method/messages.setBotGuestChatResult.md), see [here »](/api/bots/guest-mode.md#handling-guest-queries-bot-side) for more info.
* Added [updateAiComposeTones](/constructor/updateAiComposeTones.md) - The list of saved [AI composer tones »](/api/ai.md#ai-compose-tones) of the current user has changed, and should be refetched using [aicompose.getTones](/method/aicompose.getTones.md).
* Added [topPeerCategoryBotsGuestChat](/constructor/topPeerCategoryBotsGuestChat.md) - Top [guest bots »](/api/bots/guest-mode.md), i.e. bots most frequently invoked as guests in chats.
* Added [webPageAttributeAiComposeTone](/constructor/webPageAttributeAiComposeTone.md) - [Webpage attribute](/type/WebPageAttribute.md) attached to a [webPage](/constructor/webPage.md) of type `telegram_aicomposetone`, generated when previewing a shared [AI composer tone »](/api/ai.md#ai-compose-tones) via an [AI compose tone link »](/api/links.md#ai-compose-tone-links).
* Added [stats.pollStats](/constructor/stats.pollStats.md) - [Statistics](/api/stats.md#poll-statistics) for a poll sent in a message.
* Added [inputAiComposeToneDefault](/constructor/inputAiComposeToneDefault.md) - References a built-in, default [AI composer tone »](/api/ai.md#ai-compose-tones) by its string identifier.
* Added [inputAiComposeToneID](/constructor/inputAiComposeToneID.md) - References a custom [AI composer tone »](/api/ai.md#ai-compose-tones) by its ID and access hash.
* Added [inputAiComposeToneSlug](/constructor/inputAiComposeToneSlug.md) - References a custom [AI composer tone »](/api/ai.md#ai-compose-tones) by its public slug, used when opening an [AI compose tone link »](/api/links.md#ai-compose-tone-links).
* Added [aiComposeTone](/constructor/aiComposeTone.md) - A custom [AI composer tone »](/api/ai.md#ai-compose-tones), used to rephrase messages in a specific style with the [AI message composer](/api/ai.md#compose-messages).
* Added [aiComposeToneDefault](/constructor/aiComposeToneDefault.md) - A built-in, default [AI composer tone »](/api/ai.md#ai-compose-tones), identified by a string identifier rather than by a numeric ID.
* Added [aicompose.tonesNotModified](/constructor/aicompose.tonesNotModified.md) - The list of saved [AI composer tones »](/api/ai.md#ai-compose-tones) hasn't changed since the last time it was fetched (i.e. the `hash` passed to [aicompose.getTones](/method/aicompose.getTones.md) is still valid).
* Added [aicompose.tones](/constructor/aicompose.tones.md) - The list of saved [AI composer tones »](/api/ai.md#ai-compose-tones) of the current user.
* Added [aiComposeToneExample](/constructor/aiComposeToneExample.md) - An example showing how an [AI composer tone »](/api/ai.md#ai-compose-tones) rephrases a message, used as a preview in the tone picker.
* Added [bots.accessSettings](/constructor/bots.accessSettings.md) - Access restriction settings for a [managed bot »](/api/bots/managed-bots.md#managing-a-managed-bot).
##### Changed Constructors
* Added **bot_guestchat** parameter in [user](/constructor/user.md)
* Added **guestchat_via_from** parameter in [message](/constructor/message.md)
* Added **premium_days** parameter in [auth.sentCodePaymentRequired](/constructor/auth.sentCodePaymentRequired.md)
* Added **subscribers_only**, **countries_iso2** parameters in [poll](/constructor/poll.md)
* Added **can_view_stats** parameter in [pollResults](/constructor/pollResults.md)
* Added **send_reactions** parameter in [chatBannedRights](/constructor/chatBannedRights.md)
* Added **premium_days** parameter in [inputStorePaymentAuthCode](/constructor/inputStorePaymentAuthCode.md)
#### [Changes in the file reference database map file »](/api/file-references.md)
##### New traversers incoming
* Added traverseIncomingConstructor{predicate: updateBotGuestChatQuery, params: [message, reference_messages], type: Update}
* Added traverseMethodResult{name: messages.getPersonalChannelHistory}
##### New traversers outgoing
* Added traverseMethodCall{name: messages.setBotGuestChatResult, params: [result]}
#### [Schema](/schema.md)
### [Layer 224](/schema?layer=224)
This layer introduces the following features:
- [AI message editor »](/api/ai.md#compose-messages)
- [Diff styled text entities »](/api/entities.md#diff-entities)
- [Message views and read metrics »](/api/views.md)
- [Managed bots »](/api/bots/managed-bots.md)
- [Managed bot manager info »](/api/profile.md#managed-bot-manager)
- [Peer requests for mini apps »](/api/bots/buttons.md#requesting-peers-via-mini-apps)
- [Detailed message metrics »](/api/views.md#read-metrics)
- [Open-answer polls »](/api/poll.md#open-answer-polls)
- [Unread poll votes »](/api/poll.md#unread-poll-votes)
- [Poll answer media attachments »](/api/poll.md#sending-a-poll)
- [Replies to poll options »](/api/poll.md#replying-to-poll-options)
- [Search for poll messages »](/api/poll.md#searching-for-polls)
- [Unofficial client warning »](/api/profile.md#unofficial-client-warning)
#### API constants
##### Incoming web events
Incoming web events documented [here »](/api/web-events.md#event-types).
- Added [`web_app_request_chat` »](/api/web-events.md#web-app-request-chat)
##### Mini app outgoing events
Outgoing mini app events documented [here »](/api/bots/webapps.md#incoming-events-client-to-mini-app).
- Added [`requested_chat_failed` »](/api/bots/webapps.md#requested-chat-failed)
- Added [`requested_chat_sent` »](/api/bots/webapps.md#requested-chat-sent)
##### Premium features
[Telegram Premium feature identifiers »](/api/premium.md#telegram-premium-features).
- Added [`ai_compose` »](/api/premium.md#ai-compose)
##### Premium limits
[Telegram Premium limit identifiers »](/api/premium.md#double-limits).
- Added [`double_limits__bots_create` »](/api/premium.md#double-limits-bots-create)
##### Web page type values
Web page type values from the [webPage](/constructor/webPage.md) constructor.
- Added `telegram_newbot`
#### [Schema](/schema.md) changes
##### New Methods
* Added [messages.composeMessageWithAI](/method/messages.composeMessageWithAI.md) - Invokes telegram's AI Editor that can translate, transform, fixup and/or emojify your message in a number of different ways, privately powered by [Cocoon](https://cocoon.org), see [here »](/api/ai.md#compose-messages) for more info!
* Added [messages.reportReadMetrics](/method/messages.reportReadMetrics.md) - Report viewport read metrics for visible messages, indicating how long each message stayed in the chat viewport, see [here »](/api/views.md#read-metrics) for more info on the full flow.
* Added [messages.reportMusicListen](/method/messages.reportMusicListen.md) - Report the listening duration of a music track (audio document without the `voice` flag), see [here »](/api/views.md#music-listens) for more info on the full flow.
* Added [messages.addPollAnswer](/method/messages.addPollAnswer.md) - Add an answer option to an [open-answer poll »](/api/poll.md#open-answer-polls)
* Added [messages.deletePollAnswer](/method/messages.deletePollAnswer.md) - Remove an answer option from an [open-answer poll »](/api/poll.md#open-answer-polls)
* Added [messages.getUnreadPollVotes](/method/messages.getUnreadPollVotes.md) - Get messages containing polls with [unread votes »](/api/poll.md#unread-poll-votes)
* Added [messages.readPollVotes](/method/messages.readPollVotes.md) - Mark all [unread poll votes »](/api/poll.md#unread-poll-votes) in a chat as read
* Added [bots.checkUsername](/method/bots.checkUsername.md) - Check whether a username is available and valid for use when [creating a managed bot »](/api/bots/managed-bots.md#creating-a-managed-bot).
* Added [bots.createBot](/method/bots.createBot.md) - Create a [managed bot »](/api/bots/managed-bots.md#creating-a-managed-bot) owned by the current user and controlled by the specified manager bot.
* Added [bots.exportBotToken](/method/bots.exportBotToken.md) - Export the bot token of a [managed bot »](/api/bots/managed-bots.md#managing-a-managed-bot); can only be called by the manager bot.
* Added [bots.requestWebViewButton](/method/bots.requestWebViewButton.md) - Bots may use this method to prepare a peer request button for a [Mini App](/api/bots/webapps.md), see [here »](/api/bots/buttons.md#requesting-peers-via-mini-apps) for more info.
* Added [bots.getRequestedWebViewButton](/method/bots.getRequestedWebViewButton.md) - Fetch the peer request button a bot prepared for a [Mini App](/api/bots/webapps.md) with [bots.requestWebViewButton](/method/bots.requestWebViewButton.md), invoked when the Mini App emits a [`web_app_request_chat`](/api/web-events.md#web-app-request-chat) event, see [here »](/api/bots/buttons.md#requesting-peers-via-mini-apps) for more info.
##### Changed Methods
* Added **poll_hash** parameter in [messages.getPollResults](/method/messages.getPollResults.md)
* Added **tone** parameter in [messages.translateText](/method/messages.translateText.md)
* Added **flags**, **webapp_req_id** parameters, changed type of **msg_id** from **int** to **flags.0?int** in [messages.sendBotRequestedPeer](/method/messages.sendBotRequestedPeer.md)
* Added **tone** parameter in [messages.summarizeText](/method/messages.summarizeText.md)
* Added **music** parameter in [stories.sendStory](/method/stories.sendStory.md)
* Added **music** parameter in [stories.editStory](/method/stories.editStory.md)
##### New Constructors
* Added [messageActionPollAppendAnswer](/constructor/messageActionPollAppendAnswer.md) - A new answer option was added to an [open-answer poll »](/api/poll.md#open-answer-polls)
* Added [messageActionPollDeleteAnswer](/constructor/messageActionPollDeleteAnswer.md) - An answer option was removed from an [open-answer poll »](/api/poll.md#open-answer-polls)
* Added [messageActionManagedBotCreated](/constructor/messageActionManagedBotCreated.md) - Service message sent by a user to a manager bot when a new [managed bot »](/api/bots/managed-bots.md) is created through it, by invoking [messages.sendBotRequestedPeer](/method/messages.sendBotRequestedPeer.md) with a [requestPeerTypeCreateBot](/constructor/requestPeerTypeCreateBot.md), see [here »](/api/bots/buttons.md#requesting-a-managed-bot) for more info.
* Added [inputMessagesFilterPoll](/constructor/inputMessagesFilterPoll.md) - Filter for poll messages, see [searching for polls »](/api/poll.md#searching-for-polls)
* Added [updateManagedBot](/constructor/updateManagedBot.md) - [Manager bots](/api/bots/managed-bots.md) only: a bot managed by the currently logged in bot was created or updated.
* Added [messageEntityDiffInsert](/constructor/messageEntityDiffInsert.md) - Represents an diff addition: render it by simply underlining the specified section and coloring it in green, see [here »](/api/entities.md#diff-entities) for more info on how to render diff entities.
* Added [messageEntityDiffReplace](/constructor/messageEntityDiffReplace.md) - Represents an diff replacement, render it as follows:
* Added [messageEntityDiffDelete](/constructor/messageEntityDiffDelete.md) - Represents an diff deletion: render it by simply underlining the specified section and coloring it in red, see [here »](/api/entities.md#diff-entities) for more info on how to render diff entities.
* Added [inputPollAnswer](/constructor/inputPollAnswer.md) - An answer option to add to an [open-answer poll »](/api/poll.md#open-answer-polls)
* Added [requestPeerTypeCreateBot](/constructor/requestPeerTypeCreateBot.md) - Used in a [keyboardButtonRequestPeer](/constructor/keyboardButtonRequestPeer.md) by a [manager bot](/api/bots/managed-bots.md) to ask a user to create a new [managed bot »](/api/bots/managed-bots.md), see [here »](/api/bots/buttons.md#requesting-a-managed-bot) for more info.
* Added [inputMessageReadMetric](/constructor/inputMessageReadMetric.md) - Read metric for a single message exposure, describing how long the message was visible in the chat viewport.
* Added [bots.exportedBotToken](/constructor/bots.exportedBotToken.md) - The bot token of a [managed bot »](/api/bots/managed-bots.md#managing-a-managed-bot), exported by the manager bot.
* Added [bots.requestedButton](/constructor/bots.requestedButton.md) - Contains the request ID a bot should pass to a [Mini App](/api/bots/webapps.md) after preparing a peer request button with [bots.requestWebViewButton](/method/bots.requestWebViewButton.md), see [here »](/api/bots/buttons.md#requesting-peers-via-mini-apps) for more info.
* Added [messages.composedMessageWithAI](/constructor/messages.composedMessageWithAI.md) - Represents a message modified by AI.
##### Changed Constructors
* Added **live_photo**, **video** parameters in [inputMediaUploadedPhoto](/constructor/inputMediaUploadedPhoto.md)
* Added **live_photo**, **video** parameters in [inputMediaPhoto](/constructor/inputMediaPhoto.md)
* Added **attached_media**, **solution_media** parameters, changed type of **correct_answers** from **flags.0?Vector<bytes>** to **flags.0?Vector<int>** in [inputMediaPoll](/constructor/inputMediaPoll.md)
* Added **bot_can_manage_bots** parameter in [user](/constructor/user.md)
* Added **live_photo**, **video** parameters in [messageMediaPhoto](/constructor/messageMediaPhoto.md)
* Added **flags**, **attached_media** parameters in [messageMediaPoll](/constructor/messageMediaPoll.md)
* Added **unread_poll_votes_count** parameter in [dialog](/constructor/dialog.md)
* Added **unofficial_security_risk**, **bot_manager_id** parameters in [userFull](/constructor/userFull.md)
* Added **peer**, **msg_id**, **top_msg_id** parameters in [updateMessagePoll](/constructor/updateMessagePoll.md)
* Added **positions** parameter in [updateMessagePollVote](/constructor/updateMessagePollVote.md)
* Added **flags**, **media**, **added_by**, **date** parameters in [pollAnswer](/constructor/pollAnswer.md)
* Added **open_answers**, **revoting_disabled**, **shuffle_answers**, **hide_results_until_close**, **creator**, **hash** parameters in [poll](/constructor/poll.md)
* Added **recent_voters** parameter, changed type of **voters** from **int** to **flags.2?int** in [pollAnswerVoters](/constructor/pollAnswerVoters.md)
* Added **has_unread_votes**, **solution_media** parameters in [pollResults](/constructor/pollResults.md)
* Added **is_app**, **verified_app_name** parameters in [urlAuthResultRequest](/constructor/urlAuthResultRequest.md)
* Added **poll_option** parameter in [messageReplyHeader](/constructor/messageReplyHeader.md)
* Added **unread_poll_votes_count** parameter in [forumTopic](/constructor/forumTopic.md)
* Added **music** parameter in [storyItem](/constructor/storyItem.md)
* Added **poll_option** parameter in [inputReplyToMessage](/constructor/inputReplyToMessage.md)
* Added **poll_votes_notify_from** parameter in [reactionsNotifySettings](/constructor/reactionsNotifySettings.md)
#### [Changes in the file reference database map file »](/api/file-references.md)
##### New sources
* Added [updateMessagePoll](/constructor/updateMessagePoll.md) - (unless messages.getScheduledMessages, updateNewScheduledMessage) fileSourceMessage{peer: extractPeerIdFromPeerAndStore([updateMessagePoll](/constructor/updateMessagePoll.md).peer?abort_if_empty), id: [updateMessagePoll](/constructor/updateMessagePoll.md).msg_id?abort_if_empty, quick_reply_shortcut_id: false}
##### New traversers incoming
* Added traverseIncomingConstructor{predicate: messageActionPollAppendAnswer, params: [answer], type: MessageAction}
* Added traverseIncomingConstructor{predicate: messageActionPollDeleteAnswer, params: [answer], type: MessageAction}
* Added traverseIncomingConstructor{predicate: messageMediaPoll, params: [poll, results, attached_media], type: MessageMedia}
* Added traverseIncomingConstructor{predicate: poll, params: [answers], type: Poll}
* Added traverseIncomingConstructor{predicate: pollAnswer, params: [media], type: PollAnswer}
* Added traverseIncomingConstructor{predicate: pollResults, params: [solution_media], type: PollResults}
* Added traverseIncomingConstructor{predicate: updateMessagePoll, params: [poll, results], push_sources: [fileSourceMessage (unless messages.getScheduledMessages, updateNewScheduledMessage)], type: Update}
* Added traverseMethodResult{name: messages.getUnreadPollVotes}
##### Changed traversers incoming
* Changed messageMediaPhoto traverseIncomingConstructor from traverseIncomingConstructor{predicate: messageMediaPhoto, params: [photo], type: MessageMedia}
to traverseIncomingConstructor{predicate: messageMediaPhoto, params: [photo, video], type: MessageMedia}
* Changed storyItem traverseIncomingConstructor from traverseIncomingConstructor{predicate: storyItem, params: [media], push_sources: [fileSourceStory (needs stories.getPinnedStories), fileSourceStory (needs stories.getStoriesArchive), fileSourceStory (needs stories.getStoriesByID), fileSourceStory (needs stories.getAlbumStories), fileSourceStory (needs peerStories), fileSourceStory], type: StoryItem}
to traverseIncomingConstructor{predicate: storyItem, params: [media, music], push_sources: [fileSourceStory (needs stories.getPinnedStories), fileSourceStory (needs stories.getStoriesArchive), fileSourceStory (needs stories.getStoriesByID), fileSourceStory (needs stories.getAlbumStories), fileSourceStory (needs peerStories), fileSourceStory], type: StoryItem}
##### New traversers outgoing
* Added traverseMethodCall{name: messages.addPollAnswer, params: [answer]}
* Added traverseMethodCall{name: messages.reportMusicListen, params: [id]}
* Added traverseOutgoingConstructor{predicate: inputMediaPoll, params: [attached_media, solution_media], type: InputMedia}
* Added traverseOutgoingConstructor{predicate: inputPollAnswer, params: [media], type: PollAnswer}
##### Changed traversers outgoing
* Changed stories.editStory traverseMethodCall from traverseMethodCall{name: stories.editStory, params: [media]}
to traverseMethodCall{name: stories.editStory, params: [media, music]}
* Changed stories.sendStory traverseMethodCall from traverseMethodCall{name: stories.sendStory, params: [media]}
to traverseMethodCall{name: stories.sendStory, params: [media, music]}
* Changed inputMediaPhoto traverseOutgoingConstructor from traverseOutgoingConstructor{predicate: inputMediaPhoto, params: [id], type: InputMedia}
to traverseOutgoingConstructor{predicate: inputMediaPhoto, params: [id, video], type: InputMedia}
* Changed inputMediaUploadedPhoto traverseOutgoingConstructor from traverseOutgoingConstructor{predicate: inputMediaUploadedPhoto, params: [file, stickers], type: InputMedia}
to traverseOutgoingConstructor{predicate: inputMediaUploadedPhoto, params: [file, stickers, video], type: InputMedia}
#### [Schema](/schema.md)
### [Layer 223](/schema?layer=223)
This layer introduces:
- [Login with Telegram via OAuth »](/api/url-authorization.md#oauth-authorization)
- [Content protection for private chats »](/api/content-protection.md#for-users)
- [Group member tags for all users, not just admins »](/api/rank.md)
- [Date styled text entities »](/api/entities.md#date-entities)
- [A new flow to obtain info about the admin that will become the owner of a basic group/supergroup/channel if the original owner leaves »](/api/channel.md#leaving-groups-channels)
- [Ownership transfer for basic groups (along with supergroups and channels) »](/api/channel.md#transferring-ownership-of-a-group-channel)
- [A new filter to return only resale gifts that can be bought using stars](/method/payments.getResaleStarGifts.md)
#### API constants
##### Incoming web events
Incoming web events documented [here »](/api/web-events.md#event-types).
- Added [`oauth_request` »](/api/web-events.md#oauth-request)
##### Mini app outgoing events
Outgoing mini app events documented [here »](/api/bots/webapps.md#incoming-events-client-to-mini-app).
- Added [`oauth_supported` »](/api/bots/webapps.md#oauth-supported)
- Added [`oauth_result_confirmed` »](/api/bots/webapps.md#oauth-result-confirmed)
- Added [`oauth_result_failed` »](/api/bots/webapps.md#oauth-result-failed)
##### Premium features
[Telegram Premium feature identifiers »](/api/premium.md#telegram-premium-features).
- Added [`pm_noforwards` »](/api/premium.md#pm-noforwards)
#### [Schema](/schema.md) changes
##### New Methods
* Added [messages.editChatCreator](/method/messages.editChatCreator.md) - Transfer the ownership of a basic group, supergroup or channel to another user, see [here »](/api/channel.md#transferring-ownership-of-a-group-channel) for the full flow.
* Added [messages.getFutureChatCreatorAfterLeave](/method/messages.getFutureChatCreatorAfterLeave.md) - Group/channel owners only: returns the ID of the user that will become the new owner of the group if we decide to leave the group, see [here »](/api/channel.md#leaving-groups-channels) for more info on the full flow.
* Added [messages.editChatParticipantRank](/method/messages.editChatParticipantRank.md) - Edit a group participant's [tag »](/api/rank.md).
* Added [messages.declineUrlAuth](/method/messages.declineUrlAuth.md) - Decline an incoming [OAuth authorization request »](/api/url-authorization.md#oauth-authorization), notifying the server that the user refused the login request.
* Added [messages.checkUrlAuthMatchCode](/method/messages.checkUrlAuthMatchCode.md) - Validate the match code selected by the user against the code shown on the login page, as part of the [OAuth authorization flow »](/api/url-authorization.md#oauth-authorization).
##### Changed Methods
* Added **flags** parameter, changed type of **rank** from **string** to **flags.0?string** in [channels.editAdmin](/method/channels.editAdmin.md)
* Added **in_app_origin** parameter in [messages.requestUrlAuth](/method/messages.requestUrlAuth.md)
* Added **share_phone_number**, **match_code** parameters in [messages.acceptUrlAuth](/method/messages.acceptUrlAuth.md)
* Added **flags**, **request_msg_id** parameters in [messages.toggleNoForwards](/method/messages.toggleNoForwards.md)
* Added **stars_only** parameter in [payments.getResaleStarGifts](/method/payments.getResaleStarGifts.md)
##### Deleted Methods
* Removed channels.editCreator
* Removed channels.getFutureCreatorAfterLeave
##### New Constructors
* Added [messageEntityFormattedDate](/constructor/messageEntityFormattedDate.md) - Represents a specific point in time, rendered as specified [here »](/api/entities.md#date-entities)
* Added [updateChatParticipantRank](/constructor/updateChatParticipantRank.md) - The [tag »](/api/rank.md) of a participant of a [basic group »](/api/channel.md#basic-groups) has changed.
* Added [messageActionNoForwardsToggle](/constructor/messageActionNoForwardsToggle.md) - Emitted only in private chats when enabling or disabling [content protection »](/api/content-protection.md#for-users).
* Added [messageActionNoForwardsRequest](/constructor/messageActionNoForwardsRequest.md) - Emitted only in private chats if the other side requested to disable [content protection »](/api/content-protection.md#for-users).
* Added [channelAdminLogEventActionParticipantEditRank](/constructor/channelAdminLogEventActionParticipantEditRank.md) - A participant's [tag »](/api/rank.md) was changed.
##### Changed Constructors
* Added **flags**, **rank** parameters in [chatParticipant](/constructor/chatParticipant.md)
* Added **from_rank** parameter in [message](/constructor/message.md)
* Added **noforwards_my_enabled**, **noforwards_peer_enabled** parameters in [userFull](/constructor/userFull.md)
* Added **rank** parameter in [channelParticipant](/constructor/channelParticipant.md)
* Added **rank** parameter in [channelParticipantSelf](/constructor/channelParticipantSelf.md)
* Added **flags**, **rank** parameters in [chatParticipantCreator](/constructor/chatParticipantCreator.md)
* Added **flags**, **rank** parameters in [chatParticipantAdmin](/constructor/chatParticipantAdmin.md)
* Added **rank** parameter in [channelParticipantBanned](/constructor/channelParticipantBanned.md)
* Added **edit_rank** parameter in [channelAdminLogEventsFilter](/constructor/channelAdminLogEventsFilter.md)
* Added **manage_ranks** parameter in [chatAdminRights](/constructor/chatAdminRights.md)
* Added **edit_rank** parameter in [chatBannedRights](/constructor/chatBannedRights.md)
* Added **match_codes_first**, **match_codes**, **user_id_hint** parameters in [urlAuthResultRequest](/constructor/urlAuthResultRequest.md)
#### PUSH notification changes
##### New PUSH notifications
* Added [OAUTH_REQUEST](/api/push-updates.md#oauth-request) - `Login request for {1} from {2}`
#### [Schema](/schema.md)
### [Layer 222](/schema?layer=222)
This layer introduces the following features:
- [Custom keyboard button backgrounds and custom emoji button labels »](/api/bots/buttons.md#button-styles)
- [AI message summarizer »](/api/ai.md#summarize-messages)
- [Gift crafting »](/api/gifts.md#crafting-collectible-gifts)
- [A new flow to obtain info about the admin that will become the owner of a supergroup/channel if the original owner leaves »](/api/channel.md#leaving-groups-channels)
#### API constants
##### Post story content types
Story content types accepted by [post story deep links »](/api/links.md#post-story-links).
- Added `photo`
- Added `video`
- Added `live`
#### [Schema](/schema.md) changes
##### New Methods
* Added [messages.getEmojiGameInfo](/method/messages.getEmojiGameInfo.md) - Fetch dice game information.
* Added [messages.summarizeText](/method/messages.summarizeText.md) - Summarize the contents of a message with AI, see [here »](/api/ai.md#summarize-messages) for more info.
* Added [payments.getCraftStarGifts](/method/payments.getCraftStarGifts.md) - Obtain owned [collectible gifts »](/api/gifts.md#collectible-gifts) of a specific type that can be used for [crafting »](/api/gifts.md#crafting-collectible-gifts).
* Added [payments.craftStarGift](/method/payments.craftStarGift.md) - Craft a new [collectible gift »](/api/gifts.md#collectible-gifts) by combining 1 to 4 owned collectible gifts of the same base gift type.
* Added [channels.getFutureCreatorAfterLeave](/method/channels.getFutureCreatorAfterLeave.md)
##### Changed Methods
* Added **for_craft** parameter in [payments.getResaleStarGifts](/method/payments.getResaleStarGifts.md)
##### New Constructors
* Added [messages.emojiGameOutcome](/constructor/messages.emojiGameOutcome.md) - Dice game outcome.
* Added [inputMediaStakeDice](/constructor/inputMediaStakeDice.md) - Dice game media.
* Added [messages.emojiGameUnavailable](/constructor/messages.emojiGameUnavailable.md) - Dice game information.
* Added [messages.emojiGameDiceInfo](/constructor/messages.emojiGameDiceInfo.md) - Dice game information.
* Added [updateEmojiGameInfo](/constructor/updateEmojiGameInfo.md) - Dice game update.
* Added [inputPasskeyCredentialFirebasePNV](/constructor/inputPasskeyCredentialFirebasePNV.md) - Alternative [passkey](/api/passkeys.md) credential that proves ownership of the account's phone number through a Firebase Phone Number Verification (PNV) token, used on official apps where a full WebAuthn [public-key passkey](/constructor/inputPasskeyCredentialPublicKey.md) cannot be created, in a way similar to [Firebase SMS authentication »](/api/auth.md).
* Added [starGiftAttributeRarity](/constructor/starGiftAttributeRarity.md) - Exact rarity value for a collectible gift attribute.
* Added [starGiftAttributeRarityUncommon](/constructor/starGiftAttributeRarityUncommon.md) - Represents uncommon collectible gift attribute rarity.
* Added [starGiftAttributeRarityRare](/constructor/starGiftAttributeRarityRare.md) - Represents rare collectible gift attribute rarity.
* Added [starGiftAttributeRarityEpic](/constructor/starGiftAttributeRarityEpic.md) - Represents epic collectible gift attribute rarity.
* Added [starGiftAttributeRarityLegendary](/constructor/starGiftAttributeRarityLegendary.md) - Represents legendary collectible gift attribute rarity.
* Added [updateStarGiftCraftFail](/constructor/updateStarGiftCraftFail.md) - Indicates that a [crafting »](/api/gifts.md#crafting-collectible-gifts) attempt did not produce a new collectible gift.
* Added [keyboardButtonStyle](/constructor/keyboardButtonStyle.md) - This constructor allows setting a custom background color and custom emoji label for a button, see [here »](/api/bots/buttons.md#button-styles) for more info.
* Added [messageActionNewCreatorPending](/constructor/messageActionNewCreatorPending.md) - Service message: emitted to a supergroup when the [group/channel creator leaves the group »](/api/channel.md#leaving-groups-channels), indicating that ownership transfer is pending. The `new_creator_id` user will become the new owner after 7 days if the old owner does not rejoin.
* Added [messageActionChangeCreator](/constructor/messageActionChangeCreator.md) - Service message: emitted to a supergroup when [ownership transfer completes after the old owner left the group »](/api/channel.md#leaving-groups-channels) (7 days after the old owner left without rejoining), indicating that ownership has been transferred to a new owner.
##### Changed Constructors
* Added **summary_from_language** parameter in [message](/constructor/message.md)
* Removed **legacy_ios** parameter in [messageService](/constructor/messageService.md)
* Added **bot_forum_can_manage_topics** parameter in [user](/constructor/user.md)
* Added **flags**, **style** parameters in [keyboardButton](/constructor/keyboardButton.md)
* Added **monoforum** parameter in [channelForbidden](/constructor/channelForbidden.md)
* Added **flags**, **style** parameters in [keyboardButtonUrl](/constructor/keyboardButtonUrl.md)
* Added **style** parameter in [keyboardButtonCallback](/constructor/keyboardButtonCallback.md)
* Added **flags**, **style** parameters in [keyboardButtonRequestPhone](/constructor/keyboardButtonRequestPhone.md)
* Added **flags**, **style** parameters in [keyboardButtonRequestGeoLocation](/constructor/keyboardButtonRequestGeoLocation.md)
* Added **style** parameter in [keyboardButtonSwitchInline](/constructor/keyboardButtonSwitchInline.md)
* Added **flags**, **style** parameters in [keyboardButtonGame](/constructor/keyboardButtonGame.md)
* Added **flags**, **style** parameters in [keyboardButtonBuy](/constructor/keyboardButtonBuy.md)
* Added **style** parameter in [keyboardButtonUrlAuth](/constructor/keyboardButtonUrlAuth.md)
* Added **style** parameter in [inputKeyboardButtonUrlAuth](/constructor/inputKeyboardButtonUrlAuth.md)
* Added **request_phone_number**, **browser**, **platform**, **ip**, **region** parameters in [urlAuthResultRequest](/constructor/urlAuthResultRequest.md)
* Added **flags** parameter, changed type of **url** from **string** to **flags.0?string** in [urlAuthResultAccepted](/constructor/urlAuthResultAccepted.md)
* Added **style** parameter in [keyboardButtonRequestPoll](/constructor/keyboardButtonRequestPoll.md)
* Added **flags**, **game_outcome** parameters in [messageMediaDice](/constructor/messageMediaDice.md)
* Added **flags**, **style** parameters in [inputKeyboardButtonUserProfile](/constructor/inputKeyboardButtonUserProfile.md)
* Added **flags**, **style** parameters in [keyboardButtonUserProfile](/constructor/keyboardButtonUserProfile.md)
* Added **flags**, **style** parameters in [keyboardButtonWebView](/constructor/keyboardButtonWebView.md)
* Added **flags**, **style** parameters in [keyboardButtonSimpleWebView](/constructor/keyboardButtonSimpleWebView.md)
* Added **flags**, **style** parameters in [keyboardButtonRequestPeer](/constructor/keyboardButtonRequestPeer.md)
* Added **style** parameter in [inputKeyboardButtonRequestPeer](/constructor/inputKeyboardButtonRequestPeer.md)
* Added **flags**, **style** parameters in [keyboardButtonCopy](/constructor/keyboardButtonCopy.md)
* Added **flags**, **crafted**, **rarity** parameters, removed **rarity_permille** parameter in [starGiftAttributeModel](/constructor/starGiftAttributeModel.md)
* Added **rarity** parameter, removed **rarity_permille** parameter in [starGiftAttributePattern](/constructor/starGiftAttributePattern.md)
* Added **rarity** parameter, removed **rarity_permille** parameter in [starGiftAttributeBackdrop](/constructor/starGiftAttributeBackdrop.md)
* Added **burned**, **crafted**, **craft_chance_permille** parameters in [starGiftUnique](/constructor/starGiftUnique.md)
* Added **craft**, **can_craft_at** parameters in [messageActionStarGiftUnique](/constructor/messageActionStarGiftUnique.md)
* Added **can_craft_at** parameter in [savedStarGift](/constructor/savedStarGift.md)
#### PUSH notification changes
##### New PUSH notifications
* Added [STORY_LIVE](/api/push-updates.md#story-live) - `started a live stream!`
#### [Changes in the file reference database map file »](/api/file-references.md)
##### New traversers incoming
* Added traverseMethodResult{name: payments.getCraftStarGifts}
#### [Schema](/schema.md)
### [Layer 220](/schema?layer=220)
This layer introduces the following features:
- [Added a new suggestion to setup a passkey »](/api/config.md#setup-passkey)
- Added a new premium feature identifier for [paid private messages »](/api/paid-messages.md)
- Some improvements for [auctions »](/api/auctions.md):
- Added a detailed description of all auction rounds as [StarGiftAuctionRound](/type/StarGiftAuctionRound.md)s
- Added `last_gift_num` to [allow computing the user's approximated position »](/api/auctions.md#auction-flow)
- Added fields to lookup auction gifts currently on resale, see [here »](/api/auctions.md) for more info.
- Added [payments.getStarGiftUpgradeAttributes](/method/payments.getStarGiftUpgradeAttributes.md) to obtain the **full** list of just the collectible attributes that may appear for a gift type once it's upgraded to a [collectible gift »](/api/gifts.md#collectible-gifts).
- Moved some auction-related fields to [starGift](/constructor/starGift.md)
- Added a new [starGiftBackground](/constructor/starGiftBackground.md) constructor to represent the background palette of gift cards and auctions
- [Collectible gift purchase offers »](/api/gifts.md#collectible-gift-purchase-offers)
#### API constants
##### Premium features
[Telegram Premium feature identifiers »](/api/premium.md#telegram-premium-features).
- Added [`paid_messages` »](/api/premium.md#paid-messages)
##### Suggested actions
[Basic suggestion identifiers »](/api/config.md#basic-suggestions)
- Added [`SETUP_PASSKEY` »](/api/config.md#setup-passkey)
#### [Schema](/schema.md) changes
##### New Methods
* Added [payments.resolveStarGiftOffer](/method/payments.resolveStarGiftOffer.md) - Accept or decline a previously received [collectible gift purchase offer »](/api/gifts.md#collectible-gift-purchase-offers), see [here »](/api/gifts.md#collectible-gift-purchase-offers) for the full flow.
* Added [payments.sendStarGiftOffer](/method/payments.sendStarGiftOffer.md) - Send an offer to purchase a [collectible gift »](/api/gifts.md#collectible-gift-purchase-offers), see [here »](/api/gifts.md#collectible-gift-purchase-offers) for the full flow.
* Added [payments.getStarGiftUpgradeAttributes](/method/payments.getStarGiftUpgradeAttributes.md) - Obtains the **full** list of just the collectible attributes that may appear for a gift type once it's upgraded to a [collectible gift »](/api/gifts.md#collectible-gifts).
##### New Constructors
* Added [messageActionStarGiftPurchaseOffer](/constructor/messageActionStarGiftPurchaseOffer.md) - Contains an offer to purchase a [collectible gift »](/api/gifts.md#collectible-gift-purchase-offers), see [here »](/api/gifts.md#collectible-gift-purchase-offers) for the full flow.
* Added [messageActionStarGiftPurchaseOfferDeclined](/constructor/messageActionStarGiftPurchaseOfferDeclined.md) - A [collectible gift purchase offer »](/api/gifts.md#collectible-gift-purchase-offers) was declined, or the offer expired, see [here »](/api/gifts.md#collectible-gift-purchase-offers) for the full flow.
* Added [starGiftBackground](/constructor/starGiftBackground.md) - Contains the default background palette of a [gift type »](/api/gifts.md#listing-all-possible-collectible-variants).
* Added [starGiftAuctionRound](/constructor/starGiftAuctionRound.md) - Describes one or more [collectible gift auction rounds »](/api/auctions.md).
* Added [starGiftAuctionRoundExtendable](/constructor/starGiftAuctionRoundExtendable.md) - Describes one or more extendable [collectible gift auction rounds »](/api/auctions.md).
* Added [payments.starGiftUpgradeAttributes](/constructor/payments.starGiftUpgradeAttributes.md) - List of just the collectible attributes that may appear for a gift type once it's upgraded to a [collectible gift »](/api/gifts.md#collectible-gifts).
##### Changed Constructors
* Added **legacy_ios** parameter in [messageService](/constructor/messageService.md)
* Added **auction_start_date**, **upgrade_variants**, **background** parameters in [starGift](/constructor/starGift.md)
* Added **gift_num** parameter in [messageActionStarGift](/constructor/messageActionStarGift.md)
* Added **value_usd_amount**, **offer_min_stars** parameters in [starGiftUnique](/constructor/starGiftUnique.md)
* Added **from_offer** parameter in [messageActionStarGiftUnique](/constructor/messageActionStarGiftUnique.md)
* Added **gift_num** parameter in [savedStarGift](/constructor/savedStarGift.md)
* Added **last_gift_num**, **rounds** parameters in [starGiftAuctionState](/constructor/starGiftAuctionState.md)
* Added **flags**, **listed_count**, **fragment_listed_count**, **fragment_listed_url** parameters in [starGiftAuctionStateFinished](/constructor/starGiftAuctionStateFinished.md)
* Added **chats** parameter in [payments.starGiftAuctionState](/constructor/payments.starGiftAuctionState.md)
* Added **gift_num** parameter in [starGiftAuctionAcquiredGift](/constructor/starGiftAuctionAcquiredGift.md)
* Added **chats** parameter in [payments.starGiftActiveAuctions](/constructor/payments.starGiftActiveAuctions.md)
* Removed **center_color**, **edge_color**, **text_color** parameters in [webPageAttributeStarGiftAuction](/constructor/webPageAttributeStarGiftAuction.md)
#### [Changes in the file reference database map file »](/api/file-references.md)
##### New skipped incoming sources
* Added [payments.starGiftUpgradeAttributes](/constructor/payments.starGiftUpgradeAttributes.md) - Contexts for star gifts are not yet implemented
##### New traversers incoming
* Added traverseIncomingConstructor{predicate: messageActionStarGiftPurchaseOffer, params: [gift], type: MessageAction}
* Added traverseIncomingConstructor{predicate: messageActionStarGiftPurchaseOfferDeclined, params: [gift], type: MessageAction}
* Added traverseIncomingConstructor{predicate: payments.starGiftUpgradeAttributes, params: [attributes], type: payments.StarGiftUpgradeAttributes}
* Added traverseMethodResult{name: payments.getStarGiftUpgradeAttributes}
#### [Schema](/schema.md)
### [Layer 219](/schema?layer=219)
This layer introduces the following features:
- [Passkeys »](/api/passkeys.md)
- [Message effects »](/api/effects.md) support for [messages.forwardMessages](/method/messages.forwardMessages.md).
#### [Schema](/schema.md) changes
##### New Methods
* Added [account.initPasskeyRegistration](/method/account.initPasskeyRegistration.md) - Initialize passkey registration for the current account, see [here »](/api/passkeys.md#creating-a-passkey) for more info on the full flow.
* Added [account.registerPasskey](/method/account.registerPasskey.md) - Complete passkey registration for the current account, see [here »](/api/passkeys.md#creating-a-passkey) for more info on the full flow.
* Added [account.getPasskeys](/method/account.getPasskeys.md) - List the passkeys associated to the current account that can be used to log in, see [here »](/api/passkeys.md#list-passkeys) for more info on passkeys.
* Added [account.deletePasskey](/method/account.deletePasskey.md) - Delete a passkey associated to the current account, see [here »](/api/passkeys.md#delete-passkeys) for more info.
* Added [auth.initPasskeyLogin](/method/auth.initPasskeyLogin.md) - Initialize login with a passkey over an unauthenticated connection, see [here »](/api/passkeys.md#logging-in-with-a-passkey) for more info.
* Added [auth.finishPasskeyLogin](/method/auth.finishPasskeyLogin.md) - Complete login with a passkey over an unauthenticated connection, see [here »](/api/passkeys.md#logging-in-with-a-passkey) for more info.
##### Changed Methods
* Added **effect** parameter in [messages.forwardMessages](/method/messages.forwardMessages.md)
##### New Constructors
* Added [passkey](/constructor/passkey.md) - Human-readable info about a passkey associated to an account, returned when [creating a passkey »](/api/passkeys.md#creating-a-passkey) or [listing passkeys »](/api/passkeys.md#list-passkeys).
* Added [account.passkeys](/constructor/account.passkeys.md) - List of [passkeys »](/api/passkeys.md#list-passkeys) associated to the current account.
* Added [account.passkeyRegistrationOptions](/constructor/account.passkeyRegistrationOptions.md) - Passkey registration options, see [here »](/api/passkeys.md#creating-a-passkey) for more info on the full flow.
* Added [auth.passkeyLoginOptions](/constructor/auth.passkeyLoginOptions.md) - Passkey login options, see [here »](/api/passkeys.md#logging-in-with-a-passkey) for more info on the full flow.
* Added [inputPasskeyResponseRegister](/constructor/inputPasskeyResponseRegister.md) - WebAuthn registration response used when registering a new passkey, see [here »](/api/passkeys.md#creating-a-passkey) for more info on the full flow.
* Added [inputPasskeyResponseLogin](/constructor/inputPasskeyResponseLogin.md) - WebAuthn authentication response used when logging in with a passkey, see [here »](/api/passkeys.md#logging-in-with-a-passkey) for more info on the full flow.
* Added [inputPasskeyCredentialPublicKey](/constructor/inputPasskeyCredentialPublicKey.md) - Public-key passkey credential used both for registration and for login, see [creating a passkey »](/api/passkeys.md#creating-a-passkey) and [logging in with a passkey »](/api/passkeys.md#logging-in-with-a-passkey) for the full flows.
##### Changed Constructors
* Added **offer** parameter in [starsTransaction](/constructor/starsTransaction.md)
#### [Schema](/schema.md)
### [Layer 218](/schema?layer=218)
This layer introduces the following features:
- [Collectible gift auctions »](/api/auctions.md)
#### API constants
##### Web page type values
Web page type values from the [webPage](/constructor/webPage.md) constructor.
- Added `telegram_auction`
#### [Schema](/schema.md) changes
##### New Methods
* Added [payments.getStarGiftAuctionState](/method/payments.getStarGiftAuctionState.md) - Returns info about a [collectible gift auction »](/api/auctions.md); also subscribes the user to auction updates, see [here »](/api/auctions.md) for more info on the full flow.
* Added [payments.getStarGiftAuctionAcquiredGifts](/method/payments.getStarGiftAuctionAcquiredGifts.md) - Fetches all the gifts that the current user won in an [auction](/api/auctions.md).
* Added [payments.getStarGiftActiveAuctions](/method/payments.getStarGiftActiveAuctions.md) - Fetches all currently active [gift auctions](/api/auctions.md) **the user has ever bid on** (including auctions where the user was outbid and their bid was returned), as long as the auction hasn't ended yet.
##### New Constructors
* Added [inputInvoiceStarGiftAuctionBid](/constructor/inputInvoiceStarGiftAuctionBid.md) - Used to place a bid in a [collectible gift auction »](/api/auctions.md).
* Added [auctionBidLevel](/constructor/auctionBidLevel.md) - Describes a bid in an [auction](/api/auctions.md).
* Added [starGiftAuctionStateNotModified](/constructor/starGiftAuctionStateNotModified.md) - Returned only by auction methods (never by updates) if the passed `version` is equal to the remote [auction »](/api/auctions.md).`version`, meaning auction information hasn't changed over the locally cached version.
* Added [starGiftAuctionState](/constructor/starGiftAuctionState.md) - Represents an active or pending [auction »](/api/auctions.md).
* Added [starGiftAuctionStateFinished](/constructor/starGiftAuctionStateFinished.md) - Represents a finished [auction »](/api/auctions.md).
* Added [starGiftAuctionUserState](/constructor/starGiftAuctionUserState.md) - Contains information about the current user's state in an [auction »](/api/auctions.md).
* Added [updateStarGiftAuctionState](/constructor/updateStarGiftAuctionState.md) - Contains updates to [auction state, see here »](/api/auctions.md) for more info on how to enable these updates.
* Added [updateStarGiftAuctionUserState](/constructor/updateStarGiftAuctionUserState.md) - Contains updates to [auction state related to the current user, see here »](/api/auctions.md) for more info on how to enable these updates.
* Added [payments.starGiftAuctionState](/constructor/payments.starGiftAuctionState.md) - Describes a [collectible gift auction »](/api/auctions.md).
* Added [starGiftAuctionAcquiredGift](/constructor/starGiftAuctionAcquiredGift.md) - Describes a gift that the current user won in an auction.
* Added [payments.starGiftAuctionAcquiredGifts](/constructor/payments.starGiftAuctionAcquiredGifts.md) - Describes all the gifts that the current user won in an [auction](/api/auctions.md).
* Added [starGiftActiveAuctionState](/constructor/starGiftActiveAuctionState.md) - Contains info about [an auction where the user has placed a bid »](/api/auctions.md).
* Added [payments.starGiftActiveAuctionsNotModified](/constructor/payments.starGiftActiveAuctionsNotModified.md) - The list of currently active [gift auctions](/api/auctions.md) **where the user has placed a bid** hasn't changed.
* Added [payments.starGiftActiveAuctions](/constructor/payments.starGiftActiveAuctions.md) - Describes all currently active [gift auctions](/api/auctions.md) **where the user has placed a bid**.
* Added [inputStarGiftAuction](/constructor/inputStarGiftAuction.md) - Used to fetch [auctions](/api/auctions.md) using the ID of the linked [collectible gift](/api/gifts.md#collectible-gifts).
* Added [inputStarGiftAuctionSlug](/constructor/inputStarGiftAuctionSlug.md) - Used to fetch [auctions](/api/auctions.md) using the [slug of an auction deep link »](/api/links.md#auction-links).
* Added [webPageAttributeStarGiftAuction](/constructor/webPageAttributeStarGiftAuction.md) - Contains info about a [collectible gift auction »](/api/auctions.md) for a [webPage](/constructor/webPage.md) preview of an [auction »](/api/auctions.md) (the [webPage](/constructor/webPage.md) will have a `type` of `telegram_auction`).
##### Changed Constructors
* Added **stargift_auction_bid** parameter in [starsTransaction](/constructor/starsTransaction.md)
* Added **auction**, **auction_slug**, **gifts_per_round** parameters in [starGift](/constructor/starGift.md)
* Added **auction_acquired**, **to_id** parameters in [messageActionStarGift](/constructor/messageActionStarGift.md)
#### [Changes in the file reference database map file »](/api/file-references.md)
##### New traversers incoming
* Added traverseIncomingConstructor{predicate: payments.starGiftActiveAuctions, params: [auctions], type: payments.StarGiftActiveAuctions}
* Added traverseIncomingConstructor{predicate: payments.starGiftAuctionState, params: [gift], type: payments.StarGiftAuctionState}
* Added traverseIncomingConstructor{predicate: starGiftActiveAuctionState, params: [gift], type: StarGiftActiveAuctionState}
* Added traverseIncomingConstructor{predicate: webPageAttributeStarGiftAuction, params: [gift], type: WebPageAttribute}
* Added traverseMethodResult{name: payments.getStarGiftActiveAuctions}
* Added traverseMethodResult{name: payments.getStarGiftAuctionState}
#### [Schema](/schema.md)
### [Layer 217](/schema?layer=217)
This layer introduces:
- [Live stories »](/api/group-calls.md#live-stories)
- [Recent story summaries »](/api/stories.md#recent-story-summaries)
- [Methods to delete group call messages and live story comments »](/api/group-calls.md#in-call-messages)
- [Repeating scheduled messages »](/api/scheduled-messages.md#repeating-scheduled-messages)
- [Privacy settings for the music tab on profiles »](/api/profile.md#music)
- [Anonymous group admins »](/api/rights.md#anonymous-admins) can now [toggle items in checklists »](/api/todo.md#mark-items-as-completed)
- [Suggestions to setup a login email »](/api/auth.md#email-verification)
#### API constants
##### Suggested actions
[Basic suggestion identifiers »](/api/config.md#basic-suggestions)
- Added [`SETUP_LOGIN_EMAIL` »](/api/config.md#setup-login-email)
- Added [`SETUP_LOGIN_EMAIL_NOSKIP` »](/api/config.md#setup-login-email-noskip)
#### [Schema](/schema.md) changes
##### New Methods
* Added [stories.startLive](/method/stories.startLive.md) - Start a live story, optionally using RTMP livestream mode, see [here »](/api/group-calls.md#live-stories) for the full flow.
* Added [phone.deleteGroupCallMessages](/method/phone.deleteGroupCallMessages.md) - Delete specific messages from the [in-call message overlay »](/api/group-calls.md#in-call-messages) of a video chat/livestream or live story, including in RTMP mode.
* Added [phone.deleteGroupCallParticipantMessages](/method/phone.deleteGroupCallParticipantMessages.md) - As an admin, delete all messages from a specific participant in the [in-call message overlay »](/api/group-calls.md#in-call-messages) of a video chat/livestream or live story, including in RTMP mode.
* Added [phone.getGroupCallStars](/method/phone.getGroupCallStars.md) - Fetch a live story's total donations and top donors, see [paid live story donations »](/api/group-calls.md#paid-live-story-donations).
* Added [phone.saveDefaultSendAs](/method/phone.saveDefaultSendAs.md) - Save the default peer displayed as the author of live story comments and reactions, see [in-call messages »](/api/group-calls.md#in-call-messages).
##### Changed Methods
* Added **schedule_repeat_period** parameter in [messages.sendMessage](/method/messages.sendMessage.md)
* Added **schedule_repeat_period** parameter in [messages.sendMedia](/method/messages.sendMedia.md)
* Added **schedule_repeat_period** parameter in [messages.forwardMessages](/method/messages.forwardMessages.md)
* Added **schedule_repeat_period** parameter in [messages.editMessage](/method/messages.editMessage.md)
* Added **send_paid_messages_stars** parameter in [phone.toggleGroupCallSettings](/method/phone.toggleGroupCallSettings.md)
* Added **for_live_stories** parameter in [channels.getSendAs](/method/channels.getSendAs.md)
* Added **flags**, **live_story** parameters in [phone.getGroupCallStreamRtmpUrl](/method/phone.getGroupCallStreamRtmpUrl.md)
* Changed type of [stories.getPeerMaxIDs](/method/stories.getPeerMaxIDs.md) from **Vector<int>** to **Vector<RecentStory>**
* Changed type of [phone.sendGroupCallMessage](/method/phone.sendGroupCallMessage.md) from **Bool** to **Updates**
* Added **flags**, **allow_paid_stars**, **send_as** parameters in [phone.sendGroupCallMessage](/method/phone.sendGroupCallMessage.md)
##### New Constructors
* Added [messageMediaVideoStream](/constructor/messageMediaVideoStream.md) - Identifies the active group call associated with a [live story »](/api/group-calls.md#live-stories).
* Added [updateDeleteGroupCallMessages](/constructor/updateDeleteGroupCallMessages.md) - Indicates that messages were deleted from the [in-call message overlay »](/api/group-calls.md#in-call-messages) of a video chat/livestream or live story, including in RTMP mode.
* Added [groupCallMessage](/constructor/groupCallMessage.md) - Represents an [in-call message »](/api/group-calls.md#in-call-messages), emoji reaction, paid live story comment or standalone paid live story donation.
* Added [inputPrivacyKeySavedMusic](/constructor/inputPrivacyKeySavedMusic.md) - Whether the user can see the [songs we pinned to our profile »](/api/profile.md#music).
* Added [privacyKeySavedMusic](/constructor/privacyKeySavedMusic.md) - Whether the user can see the [songs we pinned to our profile »](/api/profile.md#music).
* Added [groupCallDonor](/constructor/groupCallDonor.md) - Describes a live story donor in the [donation leaderboard »](/api/group-calls.md#paid-live-story-donations).
* Added [phone.groupCallStars](/constructor/phone.groupCallStars.md) - Contains a live story's total donations and top donors, see [paid live story donations »](/api/group-calls.md#paid-live-story-donations).
* Added [recentStory](/constructor/recentStory.md) - Summary of a peer's [active stories »](/api/stories.md#recent-story-summaries), embedded in [user](/constructor/user.md).`stories_max_id` and [channel](/constructor/channel.md).`stories_max_id` and returned by [stories.getPeerMaxIDs](/method/stories.getPeerMaxIDs.md).
##### Changed Constructors
* Added **schedule_repeat_period** parameter in [message](/constructor/message.md)
* Changed type of **stories_max_id** from **flags2.5?int** to **flags2.5?RecentStory** in [user](/constructor/user.md)
* Changed type of **stories_max_id** from **flags2.4?int** to **flags2.4?RecentStory** in [channel](/constructor/channel.md)
* Added **send_paid_messages_stars**, **default_send_as** parameters in [groupCall](/constructor/groupCall.md)
* Added **paid_stars_total** parameter in [groupCallParticipant](/constructor/groupCallParticipant.md)
* Added **live_story**, **peer** parameters, removed **chat_id** parameter in [updateGroupCall](/constructor/updateGroupCall.md)
* Added **days** parameter, removed **months** parameter in [messageActionGiftPremium](/constructor/messageActionGiftPremium.md)
* Added **live** parameter in [storyItemSkipped](/constructor/storyItemSkipped.md)
* Added **days** parameter, removed **months** parameter in [payments.checkedGiftCode](/constructor/payments.checkedGiftCode.md)
* Added **days** parameter, removed **months** parameter in [messageActionGiftCode](/constructor/messageActionGiftCode.md)
* Added **phonegroup_message** parameter in [starsTransaction](/constructor/starsTransaction.md)
* Added **disallow_stargifts_from_channels** parameter in [disallowedGiftsSettings](/constructor/disallowedGiftsSettings.md)
* Changed type of **completed_by** from **long** to **Peer** in [todoCompletion](/constructor/todoCompletion.md)
* Removed **from_id**, **random_id** parameters, changed type of **message** from **TextWithEntities** to **GroupCallMessage** in [updateGroupCallMessage](/constructor/updateGroupCallMessage.md)
#### [Schema](/schema.md)
### [Layer 216](/schema?layer=216)
This layer introduces the following new features:
- [Bot forums »](/api/forum.md#bot-forums)
- [Private contact notes »](/api/contacts.md#private-notes-for-contacts)
- [Suggested birthdays »](/api/profile.md#birthday)
- [Collectible gifts can now have associated message color palettes »](/api/colors.md#collectible-message-palettes)
- [Live bot response streaming »](/api/bots/ai.md#live-response-streaming).
- [Hosted collectible gifts: linking a collectible gift on the TON blockchain to a Telegram profile »](/api/gifts.md#hosted-collectible-gifts)
#### API constants
##### Client configs
[Client configuration keys »](/api/config.md#client-configuration).
- Added [`contact_note_length_limit` »](/api/config.md#contact-note-length-limit)
- Added [`group_call_message_length_limit` »](/api/config.md#group-call-message-length-limit)
- Added [`group_call_message_ttl` »](/api/config.md#group-call-message-ttl)
- Added [`message_typing_draft_ttl` »](/api/config.md#message-typing-draft-ttl)
#### [Schema](/schema.md) changes
##### New Methods
* Added [messages.getForumTopics](/method/messages.getForumTopics.md) - Get [topics of a forum](/api/forum.md)
* Added [messages.getForumTopicsByID](/method/messages.getForumTopicsByID.md) - Get forum topics by their ID
* Added [messages.editForumTopic](/method/messages.editForumTopic.md) - Edit [forum topic](/api/forum.md).
* Added [messages.updatePinnedForumTopic](/method/messages.updatePinnedForumTopic.md) - Pin or unpin [forum topics](/api/forum.md)
* Added [messages.reorderPinnedForumTopics](/method/messages.reorderPinnedForumTopics.md) - Reorder pinned forum topics
* Added [messages.createForumTopic](/method/messages.createForumTopic.md) - Create a [forum topic](/api/forum.md).
* Added [messages.deleteTopicHistory](/method/messages.deleteTopicHistory.md) - Delete message history of a [forum topic](/api/forum.md)
* Added [phone.sendGroupCallMessage](/method/phone.sendGroupCallMessage.md) - Send an in-call message to all participants of a video chat/livestream or live story, including in RTMP mode, see [here »](/api/group-calls.md#in-call-messages) for more info.
* Added [phone.sendGroupCallEncryptedMessage](/method/phone.sendGroupCallEncryptedMessage.md) - Send an E2E-encrypted message or emoji reaction to all participants of a conference call. This method can only be used with conferences; see [here »](/api/end-to-end/group-calls.md#conference-in-call-messages) for the serialization and encryption process.
* Added [contacts.updateContactNote](/method/contacts.updateContactNote.md) - Update the private note associated to a contact; see [here »](/api/contacts.md#private-notes-for-contacts) for more info.
* Added [users.suggestBirthday](/method/users.suggestBirthday.md) - Suggest a birthday to another user, see [here »](/api/profile.md#birthday) for more info on birthdays in the API.
##### Changed Methods
* Added **note** parameter in [contacts.addContact](/method/contacts.addContact.md)
* Added **messages_enabled** parameter in [phone.toggleGroupCallSettings](/method/phone.toggleGroupCallSettings.md)
* Removed **background_emoji_id** parameter, changed type of **color** from **flags.2?int** to **flags.2?PeerColor** in [account.updateColor](/method/account.updateColor.md)
* Added **peer_color_available**, **exclude_hosted** parameters in [payments.getSavedStarGifts](/method/payments.getSavedStarGifts.md)
##### Deleted Methods
* Removed channels.createForumTopic
* Removed channels.getForumTopics
* Removed channels.getForumTopicsByID
* Removed channels.editForumTopic
* Removed channels.updatePinnedForumTopic
* Removed channels.deleteTopicHistory
* Removed channels.reorderPinnedForumTopics
##### New Constructors
* Added [sendMessageTextDraftAction](/constructor/sendMessageTextDraftAction.md) - Used by bots to implement [live message streaming »](/api/bots/ai.md#live-response-streaming).
* Added [updateGroupCallMessage](/constructor/updateGroupCallMessage.md) - A new message, reaction, paid comment or donation was received through the [in-call message overlay »](/api/group-calls.md#in-call-messages).
* Added [updateGroupCallEncryptedMessage](/constructor/updateGroupCallEncryptedMessage.md) - A new E2E-encrypted message or emoji reaction was received in a conference call, see [here »](/api/end-to-end/group-calls.md#receiving-and-decrypting-a-message) for the decryption process.
* Added [updatePinnedForumTopic](/constructor/updatePinnedForumTopic.md) - A [forum topic »](/api/forum.md#forum-topics) was pinned or unpinned.
* Added [updatePinnedForumTopics](/constructor/updatePinnedForumTopics.md) - The [pinned topics](/api/forum.md#forum-topics) of a forum have changed.
* Added [peerColorCollectible](/constructor/peerColorCollectible.md) - Represents a [color palette »](/api/colors.md) associated to a [collectible gift »](/api/gifts.md#collectible-gifts), see [here »](/api/colors.md#collectible-gift-palettes) for more info.
* Added [inputPeerColorCollectible](/constructor/inputPeerColorCollectible.md) - Represents a [color palette »](/api/colors.md) associated to a [collectible gift »](/api/gifts.md#collectible-gifts), see [here »](/api/colors.md#collectible-gift-palettes) for more info.
* Added [messageActionSuggestBirthday](/constructor/messageActionSuggestBirthday.md) - A new birthday was suggested using [users.suggestBirthday](/method/users.suggestBirthday.md), see [here »](/api/profile.md#birthday) for more info on birthdays in the API.
##### Changed Constructors
* Added **flags**, **note** parameters in [inputPhoneContact](/constructor/inputPhoneContact.md)
* Added **note** parameter in [userFull](/constructor/userFull.md)
* Added **topics** parameter in [messages.messages](/constructor/messages.messages.md)
* Added **topics** parameter in [messages.messagesSlice](/constructor/messages.messagesSlice.md)
* Added **flags**, **top_msg_id** parameters in [updateUserTyping](/constructor/updateUserTyping.md)
* Added **top_msg_id** parameter in [updateReadHistoryInbox](/constructor/updateReadHistoryInbox.md)
* Added **bot_forum_view** parameter in [user](/constructor/user.md)
* Added **messages_enabled**, **can_change_messages_enabled**, **min** parameters in [groupCall](/constructor/groupCall.md)
* Added **title_missing**, **peer** parameters in [forumTopic](/constructor/forumTopic.md)
* Added **title_missing** parameter in [messageActionTopicCreate](/constructor/messageActionTopicCreate.md)
* Added **peer_color_available** parameter in [starGift](/constructor/starGift.md)
* Added **peer_color**, **host_id** parameters in [starGiftUnique](/constructor/starGiftUnique.md)
* Added **assigned** parameter in [messageActionStarGiftUnique](/constructor/messageActionStarGiftUnique.md)
##### Deleted Constructors
* Removed updateChannelPinnedTopic
* Removed updateChannelPinnedTopics
#### PUSH notification changes
##### New PUSH notifications
* Added [MESSAGE_SUGGEST_BIRTHDAY](/api/push-updates.md#message-suggest-birthday) - `{1} suggested you your birthday`
#### [Changes in the file reference database map file »](/api/file-references.md)
##### New traversers incoming
* Added traverseMethodResult{name: messages.getForumTopics}
* Added traverseMethodResult{name: messages.getForumTopicsByID}
##### Deleted Traversers incoming
* Removed traverseMethodResult{name: channels.getForumTopics}
* Removed traverseMethodResult{name: channels.getForumTopicsByID}
#### [End-to-end schema](/schema/end-to-end.md) changes
##### New Constructors
* Added [jsonObjectValue](/constructor/jsonObjectValue.md) - JSON key: value pair
* Added [jsonNull](/constructor/jsonNull.md) - null JSON value
* Added [jsonBool](/constructor/jsonBool.md) - JSON boolean value
* Added [jsonNumber](/constructor/jsonNumber.md) - JSON numeric value
* Added [jsonString](/constructor/jsonString.md) - JSON string
* Added [jsonArray](/constructor/jsonArray.md) - JSON array
* Added [jsonObject](/constructor/jsonObject.md) - JSON object value
* Added [textWithEntities](/constructor/textWithEntities.md) - Styled text with [message entities](/api/entities.md)
* Added [groupCallMessage](/constructor/groupCallMessage.md) - Represents an [in-call message »](/api/group-calls.md#in-call-messages), emoji reaction, paid live story comment or standalone paid live story donation.
#### [End-to-end schema](/schema/end-to-end.md)
#### [Schema](/schema.md)
### [Layer 215](/schema?layer=215)
This layer introduces the following new features and improvements:
- [Allow removing the starGiftAttributeOriginalDetails from an owned gift »](/api/gifts.md#dropping-the-original-details-of-an-upgraded-gift).
- [payments.starGiftUpgradePreview](/constructor/payments.starGiftUpgradePreview.md) now returns a list of future [gift upgrade](/api/gifts.md#collectible-gifts) prices in **prices** and **next\_prices**.
- Improved pagination for [account.getUniqueGiftChatThemes](/method/account.getUniqueGiftChatThemes.md), also added a note indicating that the method may return less than `limit` results, even if the actual number of remaining results is `>= limit`, pagination should be used to fetch them all.
#### [Schema](/schema.md) changes
##### New Methods
* Added [auth.checkPaidAuth](/method/auth.checkPaidAuth.md) - Checks the status of a [login payment](/api/auth.md#paid-auth).
##### Changed Methods
* Changed type of **offset** from **int** to **string** in [account.getUniqueGiftChatThemes](/method/account.getUniqueGiftChatThemes.md)
##### New Constructors
* Added [inputInvoicePremiumAuthCode](/constructor/inputInvoicePremiumAuthCode.md) - Used to pay for login codes, in case of high cost of SMS verification codes for the user's country/provider, see [here »](/api/auth.md#paid-auth) for more info.
* Added [inputInvoiceStarGiftDropOriginalDetails](/constructor/inputInvoiceStarGiftDropOriginalDetails.md) - Used to pay for for the removal of the [starGiftAttributeOriginalDetails](/constructor/starGiftAttributeOriginalDetails.md) attribute from a collectible gift, see [here »](/api/gifts.md#dropping-the-original-details-of-an-upgraded-gift) for the full flow.
* Added [starGiftUpgradePrice](/constructor/starGiftUpgradePrice.md) - Indicates the price for a [gift upgrade »](/api/gifts.md#collectible-gifts) starting from a specific point in time.
##### Changed Constructors
* Changed type of **next_offset** from **flags.0?int** to **flags.0?string** in [account.chatThemes](/constructor/account.chatThemes.md)
* Added **stargift_drop_original_details** parameter in [starsTransaction](/constructor/starsTransaction.md)
* Added **drop_original_details_stars** parameter in [messageActionStarGiftUnique](/constructor/messageActionStarGiftUnique.md)
* Added **prices**, **next_prices** parameters in [payments.starGiftUpgradePreview](/constructor/payments.starGiftUpgradePreview.md)
* Added **drop_original_details_stars** parameter in [savedStarGift](/constructor/savedStarGift.md)
* Added **currency**, **amount** parameters in [auth.sentCodePaymentRequired](/constructor/auth.sentCodePaymentRequired.md)
#### [Schema](/schema.md)
### [Layer 214](/schema?layer=214)
To view all changes since the last documentation refresh, start reading at [layer 196](#layer-196). This documentation refresh *also* brings the following changes:
- [A brand new file reference database map file »](/api/file-references.md): can be used to automatically codegen a fully functional file reference database, see [here »](/api/file-references.md) for more info.
- The map file generator is open source, and is specifically designed to be easy to run on newer, even experimental layers, see [here for more info »](/api/file-reference-generator.md).
- Layer diffs will now list changes to the file reference map file as well.
- [The RPC error database was updated »](/api/errors.md), and it now has the following extra fields:
- `business_supported` - Contains the full list of methods that can be used by bots over a [business connection with invokeWithBusinessConnection](/api/bots/connected-business-bots.md).
- `unauthed_allowed` - Contains the full list of methods that can be used by not yet logged in connections.
- All methods in the documentation now explicitly state if they can be used by bots, users or both, and if they can be used over a business connection or over an unauthorized connection.
- Updated the list of methods that can be used over a [business connection](/api/bots/connected-business-bots.md)
- [stories.sendStory](/method/stories.sendStory.md) and [stories.editStory](/method/stories.editStory.md) can also be used to post and edit stories on behalf of a connected business account: in this case, simply pass the business account's peer in `peer`, *without* wrapping the request in an [invokeWithBusinessConnection »](/method/invokeWithBusinessConnection.md) query.
Note that [stories.editStory](/method/stories.editStory.md) can only be used to edit stories posted by the same business bot on behalf of the user.
- Updated the list of methods that can be used over an [unauthed connection](/api/auth.md#we-are-authorized)
- The [documentation for the profile page was also reorganized, to include the full list of profile tabs to show, along with instructions on how to populate them »](/api/profile.md).
- [Corrected hash generation instructions for messages.getScheduledHistory, the correct order is id, edit\_date, date; not id, date, edit\_date »](/method/messages.getScheduledHistory.md)
- Added documentation on [frozen accounts »](/api/auth.md#frozen-accounts)
- [Added a new client configuration key for the maximum number of allowed quiz poll answers](/api/config.md#poll-answers-max)
- [Added a new client configuration key for the maximum amount of Telegram Stars that can be withdrawn from a channel or bot's balance »](/api/config.md#stars-revenue-withdrawal-max)
- [Added support for age verification, if required by the current country's legislation »](/api/age-verification.md).
- Added device storage and secure storage APIs for [mini apps](/api/bots/webapps.md), using the following events:
- [web\_app\_device\_storage\_save\_key](/api/web-events.md#web-app-device-storage-save-key) - Save or remove a value from the device's local storage associated with this user and mini app
- [web\_app\_device\_storage\_get\_key](/api/web-events.md#web-app-device-storage-get-key) - Get a value from the device's local storage associated with this user and mini app
- [web\_app\_device\_storage\_clear](/api/web-events.md#web-app-device-storage-clear) - Clear the device's local storage associated with this user and mini app
- [web\_app\_secure\_storage\_save\_key](/api/web-events.md#web-app-secure-storage-save-key) - Save or remove a value from the device's secure storage associated with this user and mini app
- [web\_app\_secure\_storage\_get\_key](/api/web-events.md#web-app-secure-storage-get-key) - Get a value from the device's secure storage associated with this user and mini app
- [web\_app\_secure\_storage\_restore\_key](/api/web-events.md#web-app-secure-storage-restore-key) - Restore a value to the device's secure storage associated with this user and mini app
- [web\_app\_secure\_storage\_clear](/api/web-events.md#web-app-secure-storage-clear) - Clear the device's secure storage associated with this user and mini app
- Add support for the new `manage_direct_messages` [admin right](/constructor/chatAdminRights.md) in [group/channel bot links](/api/links.md#group-channel-bot-links).
- Updated the documentation for bot API dialog IDs to include support for the new monoforum ID range, see [here »](/api/bots/ids.md#monoforum-ids) for more info.
- Specifically, the bot API dialog ID new ranges from `-4000000000000` to `1099511627775` (previously the range was `-2002147483648` to `1099511627775`).
- The transformed range for bot API monoforum dialog IDs is `-2002147483649` to `-4000000000000` inclusively.
- Push notifications can now have a custom `report_delivery_until_date` parameter for [Telegram Gateway verification messages](https://telegram.org/blog/star-messages-gateway-2-0-and-more#save-even-more-on-user-verification): if set, the message is a Telegram Gateway verification code, and [messages.reportMessagesDelivery](/method/messages.reportMessagesDelivery.md) should be invoked with the `push` flag set.
- Added a correction to the [paid reactions documentation »](/api/reactions.md#paid-reactions): the `random_id` argument of [messages.sendPaidReaction](/method/messages.sendPaidReaction.md) **must** be composed of a 64-bit integer where the lower 32 bits are random, and the higher 32 bits **are equal to the current unixtime**, i.e. `uint64_t random_id = (time() << 32) | ((uint64_t)random_uint32_t())`: this differs from the `random_id` format of all other methods in the API, which just take 64 random bits.
- Clarified that adding a new recent reaction should trigger modification of the cached list and regeneration of the hash with a custom algorithm, see [here »](/api/reactions.md#recent-reactions) for more info.
- Clarified that modifying saved message tags should trigger modification of the cached list and regeneration of the hash with a custom algorithm, see [here »](/api/saved-messages.md#tags) for more info.
- The [webpage type list »](/constructor/webPage.md) was updated.
- [Clarified](/api/invoking.md) that in some cases such as updates from big channels, the API may return constructors from older layers, different from the connection's current layer.
Clients should treat this as a `500` server error, and handle it by closing and reopening the TCP socket, re-reinitializing the session with [initConnection](/method/initConnection.md) and invoking [getDifference](/api/updates.md).
- A whole bunch of new features and articles, [start reading at layer 196](#layer-196) to view them all. And here are the changes in this layer:
- [Set a collectible gift as chat theme »](/api/themes.md#chat-themes)
- Allow sending an email to Telegram's support team when getting [auth.sentCodePaymentRequired](/constructor/auth.sentCodePaymentRequired.md) during login (official clients only).
#### [Schema](/schema.md) changes
##### New Methods
* Added [account.getUniqueGiftChatThemes](/method/account.getUniqueGiftChatThemes.md) - Obtain all [chat themes »](/api/themes.md#chat-themes) associated to owned or [hosted collectible gifts »](/api/gifts.md#hosted-collectible-gifts).
##### Changed Methods
* Added **theme** parameter, removed **emoticon** parameter in [messages.setChatTheme](/method/messages.setChatTheme.md)
##### New Constructors
* Added [chatTheme](/constructor/chatTheme.md) - A chat theme
* Added [chatThemeUniqueGift](/constructor/chatThemeUniqueGift.md) - A chat theme based on a [collectible gift »](/api/gifts.md#collectible-gifts).
* Added [account.chatThemesNotModified](/constructor/account.chatThemesNotModified.md) - The available chat themes were not modified
* Added [account.chatThemes](/constructor/account.chatThemes.md) - Available [chat themes](/api/themes.md#chat-themes)
* Added [inputChatThemeEmpty](/constructor/inputChatThemeEmpty.md) - Remove any currently configured theme.
* Added [inputChatTheme](/constructor/inputChatTheme.md) - Set an emoji-based chat theme, returned by [account.getChatThemes](/method/account.getChatThemes.md).
* Added [inputChatThemeUniqueGift](/constructor/inputChatThemeUniqueGift.md) - Set a theme based on an owned or [hosted collectible gift »](/api/gifts.md#hosted-collectible-gifts), returned by [account.getUniqueGiftChatThemes](/method/account.getUniqueGiftChatThemes.md).
##### Changed Constructors
* Added **theme** parameter, removed **emoticon** parameter in [messageActionSetChatTheme](/constructor/messageActionSetChatTheme.md)
* Added **support_email_address**, **support_email_subject** parameters in [auth.sentCodePaymentRequired](/constructor/auth.sentCodePaymentRequired.md)
* Added **theme** parameter, removed **theme_emoticon** parameter in [userFull](/constructor/userFull.md)
* Added **theme_available**, **theme_peer** parameters in [starGiftUnique](/constructor/starGiftUnique.md)
#### PUSH notification changes
##### New PUSH notifications
* Added [MESSAGE_STARGIFT_UNPACK_UPGRADE](/api/push-updates.md#message-stargift-unpack-upgrade) - `{1} unpacked the Gift that you helped upgrade`
#### [File reference map file schema »](/api/file-references.md) changes
##### New Constructors
* Added boolFalse - Constructor may be interpreted as a **boolean**`false` value.
* Added boolTrue - The constructor can be interpreted as a **boolean**`true` value.
* Added true - See [predefined identifiers](/mtproto/TL-formal.md#predefined-identifiers).
* Added vector - A universal vector constructor.
* Added fileReferenceMap
* Added traverseParam
* Added traverseMethodResult
* Added traverseIncomingConstructor
* Added traverseCommitSourceLocation
* Added predicate
* Added source
* Added traverseOutgoingConstructor
* Added traverseSwapLocation
* Added traverseMethodCall
* Added skippedSource
* Added refreshAction
* Added paramNotFlag
* Added paramIsFlagAbortIfEmpty
* Added paramIsFlagFallback
* Added paramIsFlagPassthrough
* Added pathPart
* Added path
* Added pathParent
* Added extractAndStore
* Added extractInputStickerSetFromDocumentAttributesAndStore
* Added extractInputStickerSetFromStickerSetAndStore
* Added extractPeerIdFromPeerAndStore
* Added extractPeerIdFromInputPeerAndStore
* Added extractChannelIdFromChannelAndStore
* Added extractChannelIdFromInputChannelAndStore
* Added extractUserIdFromUserAndStore
* Added extractUserIdFromInputUserAndStore
* Added callOp
* Added getMessageOp
* Added typedOpArg
* Added typedOp
* Added copyOp
* Added getInputChannelByIdOp
* Added getInputUserByIdOp
* Added getInputPeerByIdOp
* Added constructorOp
* Added vectorOp
* Added intLiteralOp
* Added longLiteralOp
* Added stringLiteralOp
* Added bytesLiteralOp
* Added boolLiteralOp
* Added doubleLiteralOp
* Added themeFormatLiteralOp
#### [File reference map file schema »](/api/file-references.md)
boolFalse#bc799737 = Bool;
boolTrue#997275b5 = Bool;\
true#3fedd339 = True;\
vector#1cb5c415 {t:Type} # [ t ] = Vector t;\
fileReferenceMap#72a99250 layer:int db_schema:string db_schema_json:string traversers_incoming:Vector<TraverserIncoming> traversers_outgoing:Vector<TraverserOutgoing> refresh_actions:Vector<RefreshAction> skipped_incoming_sources:Vector<SkippedSource> = FileReferenceMap;\
traverseParam#62161b67 flags:# name:string is_flag:flags.0?true is_vector:flags.1?true type:string = TraverseParam;
traverseMethodResult#fda9f236 name:string push_sources:Vector<Source> is_needed_parent:Bool = TraverserIncoming;
traverseIncomingConstructor#6e4d00b6 type:string predicate:string params:Vector<TraverseParam> push_sources:Vector<Source> is_needed_parent:Bool = TraverserIncoming;
traverseCommitSourceLocation#94cc59c5 type:string predicate:string push_sources:Vector<Source> stored_constructor:string = TraverserIncoming;\
predicate#de3bc05a predicate:string is_constructor:Bool = Predicate;\
source#4ec4751a flags:# predicate:Predicate stored_constructor:string stored_params:Vector<FieldExtractor> skipped_flags:Vector<string> needs_parent:flags.3?Predicate needs_not_parents:Vector<Predicate> = Source;\
traverseOutgoingConstructor#3fc5026d type:string predicate:string params:Vector<TraverseParam> = TraverserOutgoing;
traverseSwapLocation#032bf95d type:string predicate:string stored_constructor:string = TraverserOutgoing;
traverseMethodCall#9244f5bb name:string params:Vector<TraverseParam> = TraverserOutgoing;\
skippedSource#2b543f6f predicate:Predicate why:string = SkippedSource;\
refreshAction#d4e15689 stored_constructor:string action:ActionOp = RefreshAction;\
paramNotFlag#acd9d5cf = ParamFlag;
paramIsFlagAbortIfEmpty#f8fe9fee = ParamFlag;
paramIsFlagFallback#202b77a1 fallback:TypedOp = ParamFlag;
paramIsFlagPassthrough#1dc6e17d = ParamFlag;
pathPart#19a10fbf type:string constructor:string param:string param_type:string flag:ParamFlag = PathPart;
path#0c3586a2 parts:Vector<PathPart> = Path;
pathParent#58f13684 parts:Vector<PathPart> = Path;\
extractAndStore#72069549 from:Path to:string = FieldExtractor;
extractInputStickerSetFromDocumentAttributesAndStore#369d8d14 from:Path to:string = FieldExtractor;
extractInputStickerSetFromStickerSetAndStore#c167d470 from:Path to:string = FieldExtractor;
extractPeerIdFromPeerAndStore#7d33019c from:Path to:string = FieldExtractor;
extractPeerIdFromInputPeerAndStore#a51acfb4 from:Path to:string = FieldExtractor;
extractChannelIdFromChannelAndStore#5675bc97 from:Path to:string = FieldExtractor;
extractChannelIdFromInputChannelAndStore#b662660e from:Path to:string = FieldExtractor;
extractUserIdFromUserAndStore#4778ec63 from:Path to:string = FieldExtractor;
extractUserIdFromInputUserAndStore#7720aa2e from:Path to:string = FieldExtractor;\
callOp#c2ff3383 method:string args:Vector<TypedOpArg> = ActionOp;\
getMessageOp#8da4c2ae peer:TypedOp id:TypedOp quick_reply_shortcut_id:TypedOp = ActionOp;\
typedOpArg#3a2930c2 key:string value:TypedOp = TypedOpArg;
typedOp#705b10ec type:string op:TypedOpOp = TypedOp;\
copyOp#f48f418f from:string = TypedOpOp;\
getInputChannelByIdOp#3cb47531 from:string = TypedOpOp;
getInputUserByIdOp#c0ee4326 from:string = TypedOpOp;
getInputPeerByIdOp#19813750 from:string = TypedOpOp;\
constructorOp#107f8d8a constructor:string args:Vector<TypedOpArg> = TypedOpOp;\
vectorOp#f8fb8f72 values:Vector<TypedOp> = TypedOpOp;\
intLiteralOp#cbfabe7c value:int = TypedOpOp;\
longLiteralOp#d08b8d3a value:long = TypedOpOp;\
stringLiteralOp#2b56ea8e value:string = TypedOpOp;\
bytesLiteralOp#fdb395a4 value:bytes = TypedOpOp;
boolLiteralOp#37e07911 value:Bool = TypedOpOp;\
doubleLiteralOp#3651e3bf value:double = TypedOpOp;\
themeFormatLiteralOp#8e4f9208 = TypedOpOp;\
boolFalse#bc799737 = Bool;
boolTrue#997275b5 = Bool;\
true#3fedd339 = True;\
vector#1cb5c415 {t:Type} # [ t ] = Vector t;\
fileIdPhoto#47a0bd49 id:long = FileId;
fileIdDocument#461b1d89 id:long = FileId;
fileSourceMessage#b19f4c78 flags:# quick_reply_shortcut_id:flags.0?int peer:long id:int = FileSource;
fileSourceStarsTransaction#c1bac8c7 flags:# peer:long id:string refund:flags.0?true ton:flags.1?true = FileSource;
fileSourceScheduledMessage#9dc1f5f7 peer:long id:int = FileSource;
fileSourceStory#c820e3eb id:int peer:long = FileSource;
fileSourceWebPage#9e5b749c url:string = FileSource;
fileSourceBotApp#01cf8b7a id:long access_hash:long = FileSource;
fileSourceUserFull#70fdb7b0 id:long = FileSource;
fileSourceAdminLog#4797f959 channel:long max_id:long = FileSource;
fileSourceStoryAlbum#5e01f223 peer:long = FileSource;
fileSourceBotPreviewMedia#0aa91441 bot:long = FileSource;
fileSourceBotPreviewInfo#f9d2d6fc bot:long lang_code:string = FileSource;
fileSourcePaidMedia#b18d9042 id:int peer:long = FileSource;
fileSourceSavedMusic#dd1a7664 user_id:long id:long access_hash:long = FileSource;
fileSourceChatFull#9de75fde chat_id:long = FileSource;
fileSourceChannelFull#6fe19339 channel:long = FileSource;
fileSourcePremiumPromo#c907a44f = FileSource;
fileSourceAttachMenuBot#c3002694 bot:long = FileSource;
fileSourceTheme#92d05e0c id:long access_hash:long = FileSource;
fileSourceWallPaper#50dbf2f7 id:long access_hash:long = FileSource;
fileSourceStickerSet#34c73709 stickerset:InputStickerSet = FileSource;
fileSourceSavedGifs#13e78e07 = FileSource;
fileSourceSavedRingtones#2b25ef1b = FileSource;
fileSourceAvailableEffects#eb8578f0 = FileSource;
fileSourceAvailableReactions#0e432388 = FileSource;
fileSourceUserProfilePhoto#e39ee274 user_id:long max_id:long = FileSource;
fileSourceDocumentByHash#0f151e0f sha256:bytes size:long mime_type:string = FileSource;\
traverseCommitSourceLocation{predicate: document, stored_constructor: fileIdDocument, push_sources: [fileSourceStickerSet, fileSourceSavedMusic (needs users.getSavedMusic), fileSourceSavedMusic (needs users.getSavedMusicByID)], type: Document}
* Added traverseCommitSourceLocation{predicate: photo, stored_constructor: fileIdPhoto, push_sources: [fileSourceUserProfilePhoto (needs photos.getUserPhotos)], type: Photo}
##### New outgoing locations
* Added traverseSwapLocation{predicate: inputPhoto, stored_constructor: fileIdPhoto, type: InputPhoto}
* Added traverseSwapLocation{predicate: inputDocument, stored_constructor: fileIdDocument, type: InputDocument}
* Added traverseSwapLocation{predicate: inputDocumentFileLocation, stored_constructor: fileIdDocument, type: InputFileLocation}
* Added traverseSwapLocation{predicate: inputPhotoFileLocation, stored_constructor: fileIdPhoto, type: InputFileLocation}
##### New sources
* Added (1) [document](/constructor/document.md) - fileSourceStickerSet{stickerset: extractInputStickerSetFromDocumentAttributesAndStore([document](/constructor/document.md).attributes)}
* Added (2) [document](/constructor/document.md) - (needs users.getSavedMusic) fileSourceSavedMusic{user_id: extractUserIdFromInputUserAndStore(users.getSavedMusic.id), id: [document](/constructor/document.md).id, access_hash: [document](/constructor/document.md).access_hash}
* Added (3) [document](/constructor/document.md) - (needs users.getSavedMusicByID) fileSourceSavedMusic{user_id: extractUserIdFromInputUserAndStore(users.getSavedMusicByID.id), id: [document](/constructor/document.md).id, access_hash: [document](/constructor/document.md).access_hash}
* Added [photo](/constructor/photo.md) - (needs photos.getUserPhotos) fileSourceUserProfilePhoto{user_id: extractUserIdFromInputUserAndStore(photos.getUserPhotos.user_id), max_id: [photo](/constructor/photo.md).id}
* Added [account.savedRingtoneConverted](/constructor/account.savedRingtoneConverted.md) - fileSourceSavedRingtones{}
* Added [account.savedRingtones](/constructor/account.savedRingtones.md) - fileSourceSavedRingtones{}
* Added [attachMenuBot](/constructor/attachMenuBot.md) - fileSourceAttachMenuBot{bot: [attachMenuBot](/constructor/attachMenuBot.md).bot_id}
* Added [botApp](/constructor/botApp.md) - fileSourceBotApp{id: [botApp](/constructor/botApp.md).id, access_hash: [botApp](/constructor/botApp.md).access_hash}
* Added [botInfo](/constructor/botInfo.md) - fileSourceUserFull{id: [botInfo](/constructor/botInfo.md).user_id?abort_if_empty}
* Added [channelAdminLogEvent](/constructor/channelAdminLogEvent.md) - (needs channels.getAdminLog) fileSourceAdminLog{channel: extractChannelIdFromInputChannelAndStore(channels.getAdminLog.channel), max_id: [channelAdminLogEvent](/constructor/channelAdminLogEvent.md).id}
* Added [channelFull](/constructor/channelFull.md) - fileSourceChannelFull{channel: [channelFull](/constructor/channelFull.md).id}
* Added [chatFull](/constructor/chatFull.md) - fileSourceChatFull{chat_id: [chatFull](/constructor/chatFull.md).id}
* Added [foundStory](/constructor/foundStory.md) - fileSourceStory{id: [foundStory](/constructor/foundStory.md).story.storyItem.id, peer: extractPeerIdFromPeerAndStore([foundStory](/constructor/foundStory.md).peer)}
* Added (1) [message](/constructor/message.md) - (unless messages.getScheduledMessages, updateNewScheduledMessage) fileSourceMessage{quick_reply_shortcut_id: [message](/constructor/message.md).quick_reply_shortcut_id?passthrough, peer: extractPeerIdFromPeerAndStore([message](/constructor/message.md).peer_id), id: [message](/constructor/message.md).id}
* Added (2) [message](/constructor/message.md) - (needs messages.getScheduledMessages) fileSourceScheduledMessage{peer: extractPeerIdFromInputPeerAndStore(messages.getScheduledMessages.peer), id: [message](/constructor/message.md).id}
* Added (3) [message](/constructor/message.md) - (needs updateNewScheduledMessage) fileSourceScheduledMessage{peer: extractPeerIdFromPeerAndStore(updateNewScheduledMessage.message.[message](/constructor/message.md).peer_id), id: [message](/constructor/message.md).id}
* Added [messageMediaStory](/constructor/messageMediaStory.md) - fileSourceStory{id: [messageMediaStory](/constructor/messageMediaStory.md).story?abort_if_empty.storyItem.id, peer: extractPeerIdFromPeerAndStore([messageMediaStory](/constructor/messageMediaStory.md).peer)}
* Added [messageService](/constructor/messageService.md) - (unless messages.getScheduledMessages, updateNewScheduledMessage) fileSourceMessage{peer: extractPeerIdFromPeerAndStore([messageService](/constructor/messageService.md).peer_id), id: [messageService](/constructor/messageService.md).id, quick_reply_shortcut_id: false}
* Added [messages.availableEffects](/constructor/messages.availableEffects.md) - fileSourceAvailableEffects{}
* Added [messages.availableReactions](/constructor/messages.availableReactions.md) - fileSourceAvailableReactions{}
* Added [messages.savedGifs](/constructor/messages.savedGifs.md) - fileSourceSavedGifs{}
* Added [messages.stickerSet](/constructor/messages.stickerSet.md) - fileSourceStickerSet{stickerset: extractInputStickerSetFromStickerSetAndStore([messages.stickerSet](/constructor/messages.stickerSet.md).set)}
* Added [publicForwardStory](/constructor/publicForwardStory.md) - fileSourceStory{id: [publicForwardStory](/constructor/publicForwardStory.md).story.storyItem.id, peer: extractPeerIdFromPeerAndStore([publicForwardStory](/constructor/publicForwardStory.md).peer)}
* Added (1) [starsTransaction](/constructor/starsTransaction.md) - (needs payments.getStarsStatus) fileSourceStarsTransaction{peer: extractPeerIdFromInputPeerAndStore(payments.getStarsStatus.peer), ton: payments.getStarsStatus.ton?passthrough, id: [starsTransaction](/constructor/starsTransaction.md).id, refund: [starsTransaction](/constructor/starsTransaction.md).refund?passthrough}
* Added (2) [starsTransaction](/constructor/starsTransaction.md) - (needs payments.getStarsTransactions) fileSourceStarsTransaction{peer: extractPeerIdFromInputPeerAndStore(payments.getStarsTransactions.peer), ton: payments.getStarsTransactions.ton?passthrough, id: [starsTransaction](/constructor/starsTransaction.md).id, refund: [starsTransaction](/constructor/starsTransaction.md).refund?passthrough}
* Added (3) [starsTransaction](/constructor/starsTransaction.md) - (needs payments.getStarsTransactionsByID) fileSourceStarsTransaction{peer: extractPeerIdFromInputPeerAndStore(payments.getStarsTransactionsByID.peer), ton: payments.getStarsTransactionsByID.ton?passthrough, id: [starsTransaction](/constructor/starsTransaction.md).id, refund: [starsTransaction](/constructor/starsTransaction.md).refund?passthrough}
* Added (4) [starsTransaction](/constructor/starsTransaction.md) - (needs payments.getStarsSubscriptions) fileSourceStarsTransaction{peer: extractPeerIdFromInputPeerAndStore(payments.getStarsSubscriptions.peer), id: [starsTransaction](/constructor/starsTransaction.md).id, refund: [starsTransaction](/constructor/starsTransaction.md).refund?passthrough, ton: false}
* Added [stickerSetFullCovered](/constructor/stickerSetFullCovered.md) - fileSourceStickerSet{stickerset: extractInputStickerSetFromStickerSetAndStore([stickerSetFullCovered](/constructor/stickerSetFullCovered.md).set)}
* Added [stickerSetMultiCovered](/constructor/stickerSetMultiCovered.md) - fileSourceStickerSet{stickerset: extractInputStickerSetFromStickerSetAndStore([stickerSetMultiCovered](/constructor/stickerSetMultiCovered.md).set)}
* Added (1) [storyItem](/constructor/storyItem.md) - (needs stories.getPinnedStories) fileSourceStory{id: [storyItem](/constructor/storyItem.md).id, peer: extractPeerIdFromInputPeerAndStore(stories.getPinnedStories.peer)}
* Added (2) [storyItem](/constructor/storyItem.md) - (needs stories.getStoriesArchive) fileSourceStory{id: [storyItem](/constructor/storyItem.md).id, peer: extractPeerIdFromInputPeerAndStore(stories.getStoriesArchive.peer)}
* Added (3) [storyItem](/constructor/storyItem.md) - (needs stories.getStoriesByID) fileSourceStory{id: [storyItem](/constructor/storyItem.md).id, peer: extractPeerIdFromInputPeerAndStore(stories.getStoriesByID.peer)}
* Added (4) [storyItem](/constructor/storyItem.md) - (needs stories.getAlbumStories) fileSourceStory{id: [storyItem](/constructor/storyItem.md).id, peer: extractPeerIdFromInputPeerAndStore(stories.getAlbumStories.peer)}
* Added (5) [storyItem](/constructor/storyItem.md) - (needs peerStories) fileSourceStory{id: [storyItem](/constructor/storyItem.md).id, peer: extractPeerIdFromPeerAndStore(peerStories.peer)}
* Added (6) [storyItem](/constructor/storyItem.md) - fileSourceStory{id: [storyItem](/constructor/storyItem.md).id, peer: extractPeerIdFromPeerAndStore([storyItem](/constructor/storyItem.md).from_id?abort_if_empty)}
* Added [storyReactionPublicRepost](/constructor/storyReactionPublicRepost.md) - fileSourceStory{id: [storyReactionPublicRepost](/constructor/storyReactionPublicRepost.md).story.storyItem.id, peer: extractPeerIdFromPeerAndStore([storyReactionPublicRepost](/constructor/storyReactionPublicRepost.md).peer_id)}
* Added [storyViewPublicRepost](/constructor/storyViewPublicRepost.md) - fileSourceStory{id: [storyViewPublicRepost](/constructor/storyViewPublicRepost.md).story.storyItem.id, peer: extractPeerIdFromPeerAndStore([storyViewPublicRepost](/constructor/storyViewPublicRepost.md).peer_id)}
* Added [theme](/constructor/theme.md) - fileSourceTheme{id: [theme](/constructor/theme.md).id, access_hash: [theme](/constructor/theme.md).access_hash}
* Added [updateMessageExtendedMedia](/constructor/updateMessageExtendedMedia.md) - fileSourcePaidMedia{id: [updateMessageExtendedMedia](/constructor/updateMessageExtendedMedia.md).msg_id, peer: extractPeerIdFromPeerAndStore([updateMessageExtendedMedia](/constructor/updateMessageExtendedMedia.md).peer)}
* Added (1) [userFull](/constructor/userFull.md) - fileSourceUserFull{id: [userFull](/constructor/userFull.md).id}
* Added (2) [userFull](/constructor/userFull.md) - fileSourceSavedMusic{user_id: [userFull](/constructor/userFull.md).id, id: [userFull](/constructor/userFull.md).saved_music?abort_if_empty.document.id, access_hash: [userFull](/constructor/userFull.md).saved_music?abort_if_empty.document.access_hash}
* Added [wallPaper](/constructor/wallPaper.md) - fileSourceWallPaper{id: [wallPaper](/constructor/wallPaper.md).id, access_hash: [wallPaper](/constructor/wallPaper.md).access_hash}
* Added [webPage](/constructor/webPage.md) - fileSourceWebPage{url: [webPage](/constructor/webPage.md).url}
* Added [webPageAttributeStory](/constructor/webPageAttributeStory.md) - fileSourceStory{id: [webPageAttributeStory](/constructor/webPageAttributeStory.md).story?abort_if_empty.storyItem.id, peer: extractPeerIdFromPeerAndStore([webPageAttributeStory](/constructor/webPageAttributeStory.md).peer)}
* Added [account.uploadRingtone](/method/account.uploadRingtone.md) - fileSourceSavedRingtones{}
* Added [bots.addPreviewMedia](/method/bots.addPreviewMedia.md) - fileSourceBotPreviewInfo{bot: extractUserIdFromInputUserAndStore([bots.addPreviewMedia](/method/bots.addPreviewMedia.md).bot), lang_code: [bots.addPreviewMedia](/method/bots.addPreviewMedia.md).lang_code}
* Added [bots.editPreviewMedia](/method/bots.editPreviewMedia.md) - fileSourceBotPreviewInfo{bot: extractUserIdFromInputUserAndStore([bots.editPreviewMedia](/method/bots.editPreviewMedia.md).bot), lang_code: [bots.editPreviewMedia](/method/bots.editPreviewMedia.md).lang_code}
* Added [bots.getPreviewInfo](/method/bots.getPreviewInfo.md) - fileSourceBotPreviewInfo{bot: extractUserIdFromInputUserAndStore([bots.getPreviewInfo](/method/bots.getPreviewInfo.md).bot), lang_code: [bots.getPreviewInfo](/method/bots.getPreviewInfo.md).lang_code}
* Added [bots.getPreviewMedias](/method/bots.getPreviewMedias.md) - fileSourceBotPreviewMedia{bot: extractUserIdFromInputUserAndStore([bots.getPreviewMedias](/method/bots.getPreviewMedias.md).bot)}
* Added [help.getPremiumPromo](/method/help.getPremiumPromo.md) - fileSourcePremiumPromo{}
* Added [messages.getDocumentByHash](/method/messages.getDocumentByHash.md) - fileSourceDocumentByHash{sha256: [messages.getDocumentByHash](/method/messages.getDocumentByHash.md).sha256, size: [messages.getDocumentByHash](/method/messages.getDocumentByHash.md).size, mime_type: [messages.getDocumentByHash](/method/messages.getDocumentByHash.md).mime_type}
* Added [photos.updateProfilePhoto](/method/photos.updateProfilePhoto.md) - fileSourceUserProfilePhoto{user_id: extractUserIdFromInputUserAndStore([photos.updateProfilePhoto](/method/photos.updateProfilePhoto.md).bot?fallback(inputUserSelf{})), max_id: [photos.updateProfilePhoto](/method/photos.updateProfilePhoto.md).(return value).photos.photo.photo.photo.id}
* Added [photos.uploadContactProfilePhoto](/method/photos.uploadContactProfilePhoto.md) - fileSourceUserProfilePhoto{user_id: extractUserIdFromInputUserAndStore([photos.uploadContactProfilePhoto](/method/photos.uploadContactProfilePhoto.md).user_id), max_id: [photos.uploadContactProfilePhoto](/method/photos.uploadContactProfilePhoto.md).(return value).photos.photo.photo.photo.id}
* Added [photos.uploadProfilePhoto](/method/photos.uploadProfilePhoto.md) - fileSourceUserProfilePhoto{user_id: extractUserIdFromInputUserAndStore([photos.uploadProfilePhoto](/method/photos.uploadProfilePhoto.md).bot?fallback(inputUserSelf{})), max_id: [photos.uploadProfilePhoto](/method/photos.uploadProfilePhoto.md).(return value).photos.photo.photo.photo.id}
* Added [stories.createAlbum](/method/stories.createAlbum.md) - fileSourceStoryAlbum{peer: extractPeerIdFromInputPeerAndStore([stories.createAlbum](/method/stories.createAlbum.md).peer)}
* Added [stories.getAlbums](/method/stories.getAlbums.md) - fileSourceStoryAlbum{peer: extractPeerIdFromInputPeerAndStore([stories.getAlbums](/method/stories.getAlbums.md).peer)}
* Added [stories.updateAlbum](/method/stories.updateAlbum.md) - fileSourceStoryAlbum{peer: extractPeerIdFromInputPeerAndStore([stories.updateAlbum](/method/stories.updateAlbum.md).peer)}
##### New skipped incoming sources
* Added [messages.getSponsoredMessages](/method/messages.getSponsoredMessages.md) - Do not store file references from sponsored messages
* Added [help.getAppUpdate](/method/help.getAppUpdate.md) - Don't handle file references from ephemeral app update info
* Added [help.getRecentMeUrls](/method/help.getRecentMeUrls.md) - Don't handle file references from recent t.me URLs
* Added [recentMeUrlChatInvite](/constructor/recentMeUrlChatInvite.md) - Do not store references based on chat invite links
* Added [messages.checkChatInvite](/method/messages.checkChatInvite.md) - Do not store references based on chat invite links
* Added [messages.getInlineBotResults](/method/messages.getInlineBotResults.md) - Inline bot results are ephemeral
* Added [messages.getPreparedInlineMessage](/method/messages.getPreparedInlineMessage.md) - Inline bot results are ephemeral
* Added [messages.uploadMedia](/method/messages.uploadMedia.md) - A freshly uploaded media file will obtain a context only once it is sent to a chat
* Added [messages.uploadImportedMedia](/method/messages.uploadImportedMedia.md) - A freshly uploaded media file will obtain a context only once it is sent to a chat
* Added [updateServiceNotification](/constructor/updateServiceNotification.md) - Cannot refetch service notifications
* Added [messages.getWebPagePreview](/method/messages.getWebPagePreview.md) - No locations are added for the method call, as it doesn't use persistent IDs as input; the location is instead extracted from the persistent IDs in the returned WebPage object
* Added [payments.resaleStarGifts](/constructor/payments.resaleStarGifts.md) - Contexts for star gifts are not yet implemented
* Added [payments.starGiftUpgradePreview](/constructor/payments.starGiftUpgradePreview.md) - Contexts for star gifts are not yet implemented
* Added [starGift](/constructor/starGift.md) - Contexts for star gifts are not yet implemented
* Added [starGiftUnique](/constructor/starGiftUnique.md) - Contexts for star gifts are not yet implemented
* Added [starGiftCollection](/constructor/starGiftCollection.md) - Contexts for star gifts are not yet implemented
* Added [payments.starGiftCollections](/constructor/payments.starGiftCollections.md) - Contexts for star gifts are not yet implemented
* Added [messages.getCustomEmojiDocuments](/method/messages.getCustomEmojiDocuments.md) - Do not store file references in this context
* Added [account.uploadTheme](/method/account.uploadTheme.md) - A freshly uploaded theme file will obtain a context only once it is created via account.createTheme
##### New refresh actions
* Added fileSourceMessage - [getMessageOp](/api/file-references.md#getmessageop)(peer: getInputPeerByIdOp(peer), id: copyOp(id), quick_reply_shortcut_id: copyOp(quick_reply_shortcut_id))
* Added fileSourceScheduledMessage - messages.getScheduledMessages(peer: getInputPeerByIdOp(peer), id: [copyOp(id)])
* Added fileSourceStory - stories.getStoriesByID(id: [copyOp(id)], peer: getInputPeerByIdOp(peer))
* Added fileSourceWebPage - messages.getWebPage(url: copyOp(url), hash: 0)
* Added fileSourceBotApp - messages.getBotApp(app: inputBotAppID{id: copyOp(id), access_hash: copyOp(access_hash)}, hash: 0)
* Added fileSourceUserFull - users.getFullUser(id: getInputUserByIdOp(id))
* Added fileSourceAdminLog - channels.getAdminLog(channel: getInputChannelByIdOp(channel), max_id: copyOp(max_id), min_id: copyOp(max_id), limit: 1, q: "")
* Added fileSourceStoryAlbum - stories.getAlbums(peer: getInputPeerByIdOp(peer), hash: 0)
* Added fileSourceBotPreviewMedia - bots.getPreviewMedias(bot: getInputUserByIdOp(bot))
* Added fileSourceBotPreviewInfo - bots.getPreviewInfo(bot: getInputUserByIdOp(bot), lang_code: copyOp(lang_code))
* Added fileSourcePaidMedia - messages.getExtendedMedia(id: [copyOp(id)], peer: getInputPeerByIdOp(peer))
* Added fileSourceSavedMusic - users.getSavedMusicByID(id: getInputUserByIdOp(user_id), documents: [inputDocument{id: copyOp(id), access_hash: copyOp(access_hash), file_reference: base64_decode("")}])
* Added fileSourceChatFull - messages.getFullChat(chat_id: copyOp(chat_id))
* Added fileSourceChannelFull - channels.getFullChannel(channel: getInputChannelByIdOp(channel))
* Added fileSourcePremiumPromo - help.getPremiumPromo()
* Added fileSourceStarsTransaction - payments.getStarsTransactionsByID(peer: getInputPeerByIdOp(peer), ton: copyOp(ton), id: [inputStarsTransaction{id: copyOp(id), refund: copyOp(refund)}])
* Added fileSourceAttachMenuBot - messages.getAttachMenuBot(bot: getInputUserByIdOp(bot))
* Added fileSourceTheme - account.getTheme(theme: inputTheme{id: copyOp(id), access_hash: copyOp(access_hash)}, format: $themeFormat)
* Added fileSourceWallPaper - account.getWallPaper(wallpaper: inputWallPaper{id: copyOp(id), access_hash: copyOp(access_hash)})
* Added fileSourceStickerSet - messages.getStickerSet(stickerset: copyOp(stickerset), hash: 0)
* Added fileSourceSavedGifs - messages.getSavedGifs(hash: 0)
* Added fileSourceSavedRingtones - account.getSavedRingtones(hash: 0)
* Added fileSourceAvailableEffects - messages.getAvailableEffects(hash: 0)
* Added fileSourceAvailableReactions - messages.getAvailableReactions(hash: 0)
* Added fileSourceUserProfilePhoto - photos.getUserPhotos(user_id: getInputUserByIdOp(user_id), offset: -1, max_id: copyOp(max_id), limit: 1)
* Added fileSourceDocumentByHash - messages.getDocumentByHash(sha256: copyOp(sha256), size: copyOp(size), mime_type: copyOp(mime_type))
##### New traversers incoming
* Added traverseCommitSourceLocation{predicate: document, stored_constructor: fileIdDocument, push_sources: [fileSourceStickerSet, fileSourceSavedMusic (needs users.getSavedMusic), fileSourceSavedMusic (needs users.getSavedMusicByID)], type: Document}
* Added traverseCommitSourceLocation{predicate: photo, stored_constructor: fileIdPhoto, push_sources: [fileSourceUserProfilePhoto (needs photos.getUserPhotos)], type: Photo}
* Added traverseIncomingConstructor{predicate: account.chatThemes, params: [themes], type: account.ChatThemes}
* Added traverseIncomingConstructor{predicate: account.savedRingtoneConverted, params: [document], push_sources: [fileSourceSavedRingtones], type: account.SavedRingtone}
* Added traverseIncomingConstructor{predicate: account.savedRingtones, params: [ringtones], push_sources: [fileSourceSavedRingtones], type: account.SavedRingtones}
* Added traverseIncomingConstructor{predicate: account.themes, params: [themes], type: account.Themes}
* Added traverseIncomingConstructor{predicate: account.wallPapers, params: [wallpapers], type: account.WallPapers}
* Added traverseIncomingConstructor{predicate: attachMenuBot, params: [icons], push_sources: [fileSourceAttachMenuBot], type: AttachMenuBot}
* Added traverseIncomingConstructor{predicate: attachMenuBotIcon, params: [icon], type: AttachMenuBotIcon}
* Added traverseIncomingConstructor{predicate: attachMenuBots, params: [bots], type: AttachMenuBots}
* Added traverseIncomingConstructor{predicate: attachMenuBotsBot, params: [bot], type: AttachMenuBotsBot}
* Added traverseIncomingConstructor{predicate: availableReaction, params: [static_icon, appear_animation, select_animation, activate_animation, effect_animation, around_animation, center_icon], type: AvailableReaction}
* Added traverseIncomingConstructor{predicate: botApp, params: [photo, document], push_sources: [fileSourceBotApp], type: BotApp}
* Added traverseIncomingConstructor{predicate: botInfo, params: [description_photo, description_document], push_sources: [fileSourceUserFull], type: BotInfo}
* Added traverseIncomingConstructor{predicate: botInlineMediaResult, params: [document], type: BotInlineResult}
* Added traverseIncomingConstructor{predicate: botPreviewMedia, params: [media], type: BotPreviewMedia}
* Added traverseIncomingConstructor{predicate: bots.previewInfo, params: [media], type: bots.PreviewInfo}
* Added traverseIncomingConstructor{predicate: businessIntro, params: [sticker], type: BusinessIntro}
* Added traverseIncomingConstructor{predicate: channelAdminLogEvent, params: [action], push_sources: [fileSourceAdminLog (needs channels.getAdminLog)], type: ChannelAdminLogEvent}
* Added traverseIncomingConstructor{predicate: channelAdminLogEventActionChangePhoto, params: [prev_photo, new_photo], type: ChannelAdminLogEventAction}
* Added traverseIncomingConstructor{predicate: channelAdminLogEventActionChangeWallpaper, params: [prev_value, new_value], type: ChannelAdminLogEventAction}
* Added traverseIncomingConstructor{predicate: channelAdminLogEventActionDeleteMessage, params: [message], type: ChannelAdminLogEventAction}
* Added traverseIncomingConstructor{predicate: channelAdminLogEventActionEditMessage, params: [prev_message, new_message], type: ChannelAdminLogEventAction}
* Added traverseIncomingConstructor{predicate: channelAdminLogEventActionSendMessage, params: [message], type: ChannelAdminLogEventAction}
* Added traverseIncomingConstructor{predicate: channelAdminLogEventActionStopPoll, params: [message], type: ChannelAdminLogEventAction}
* Added traverseIncomingConstructor{predicate: channelAdminLogEventActionUpdatePinned, params: [message], type: ChannelAdminLogEventAction}
* Added traverseIncomingConstructor{predicate: channelFull, params: [chat_photo, bot_info, stories, wallpaper], push_sources: [fileSourceChannelFull], type: ChatFull}
* Added traverseIncomingConstructor{predicate: channels.adminLogResults, params: [events], type: channels.AdminLogResults}
* Added traverseIncomingConstructor{predicate: chatFull, params: [chat_photo, bot_info], push_sources: [fileSourceChatFull], type: ChatFull}
* Added traverseIncomingConstructor{predicate: chatThemeUniqueGift, params: [gift, theme_settings], type: ChatTheme}
* Added traverseIncomingConstructor{predicate: foundStory, params: [story], push_sources: [fileSourceStory], type: FoundStory}
* Added traverseIncomingConstructor{predicate: game, params: [photo, document], type: Game}
* Added traverseIncomingConstructor{predicate: help.appUpdate, params: [document, sticker], type: help.AppUpdate}
* Added traverseIncomingConstructor{predicate: help.premiumPromo, params: [videos], type: help.PremiumPromo}
* Added traverseIncomingConstructor{predicate: help.recentMeUrls, params: [urls], type: help.RecentMeUrls}
* Added traverseIncomingConstructor{predicate: message, params: [reply_to, media], push_sources: [fileSourceMessage (unless messages.getScheduledMessages, updateNewScheduledMessage), fileSourceScheduledMessage (needs messages.getScheduledMessages), fileSourceScheduledMessage (needs updateNewScheduledMessage)], type: Message}
* Added traverseIncomingConstructor{predicate: messageActionBotAllowed, params: [app], type: MessageAction}
* Added traverseIncomingConstructor{predicate: messageActionChatEditPhoto, params: [photo], type: MessageAction}
* Added traverseIncomingConstructor{predicate: messageActionRequestedPeerSentMe, params: [peers], type: MessageAction}
* Added traverseIncomingConstructor{predicate: messageActionSetChatTheme, params: [theme], type: MessageAction}
* Added traverseIncomingConstructor{predicate: messageActionSetChatWallPaper, params: [wallpaper], type: MessageAction}
* Added traverseIncomingConstructor{predicate: messageActionStarGift, params: [gift], type: MessageAction}
* Added traverseIncomingConstructor{predicate: messageActionStarGiftUnique, params: [gift], type: MessageAction}
* Added traverseIncomingConstructor{predicate: messageActionSuggestProfilePhoto, params: [photo], type: MessageAction}
* Added traverseIncomingConstructor{predicate: messageExtendedMedia, params: [media], type: MessageExtendedMedia}
* Added traverseIncomingConstructor{predicate: messageMediaDocument, params: [document, alt_documents, video_cover], type: MessageMedia}
* Added traverseIncomingConstructor{predicate: messageMediaGame, params: [game], type: MessageMedia}
* Added traverseIncomingConstructor{predicate: messageMediaInvoice, params: [extended_media], type: MessageMedia}
* Added traverseIncomingConstructor{predicate: messageMediaPaidMedia, params: [extended_media], type: MessageMedia}
* Added traverseIncomingConstructor{predicate: messageMediaPhoto, params: [photo], type: MessageMedia}
* Added traverseIncomingConstructor{predicate: messageMediaStory, params: [story], push_sources: [fileSourceStory], type: MessageMedia}
* Added traverseIncomingConstructor{predicate: messageMediaWebPage, params: [webpage], type: MessageMedia}
* Added traverseIncomingConstructor{predicate: messageReplyHeader, params: [reply_media], type: MessageReplyHeader}
* Added traverseIncomingConstructor{predicate: messageService, params: [reply_to, action], push_sources: [fileSourceMessage (unless messages.getScheduledMessages, updateNewScheduledMessage)], type: Message}
* Added traverseIncomingConstructor{predicate: messages.archivedStickers, params: [sets], type: messages.ArchivedStickers}
* Added traverseIncomingConstructor{predicate: messages.availableEffects, params: [documents], push_sources: [fileSourceAvailableEffects], type: messages.AvailableEffects}
* Added traverseIncomingConstructor{predicate: messages.availableReactions, params: [reactions], push_sources: [fileSourceAvailableReactions], type: messages.AvailableReactions}
* Added traverseIncomingConstructor{predicate: messages.botApp, params: [app], type: messages.BotApp}
* Added traverseIncomingConstructor{predicate: messages.botResults, params: [results], type: messages.BotResults}
* Added traverseIncomingConstructor{predicate: messages.channelMessages, params: [messages], type: messages.Messages}
* Added traverseIncomingConstructor{predicate: messages.chatFull, params: [full_chat], type: messages.ChatFull}
* Added traverseIncomingConstructor{predicate: messages.dialogs, params: [messages], type: messages.Dialogs}
* Added traverseIncomingConstructor{predicate: messages.dialogsSlice, params: [messages], type: messages.Dialogs}
* Added traverseIncomingConstructor{predicate: messages.discussionMessage, params: [messages], type: messages.DiscussionMessage}
* Added traverseIncomingConstructor{predicate: messages.favedStickers, params: [stickers], type: messages.FavedStickers}
* Added traverseIncomingConstructor{predicate: messages.featuredStickers, params: [sets], type: messages.FeaturedStickers}
* Added traverseIncomingConstructor{predicate: messages.forumTopics, params: [messages], type: messages.ForumTopics}
* Added traverseIncomingConstructor{predicate: messages.foundStickerSets, params: [sets], type: messages.FoundStickerSets}
* Added traverseIncomingConstructor{predicate: messages.foundStickers, params: [stickers], type: messages.FoundStickers}
* Added traverseIncomingConstructor{predicate: messages.messages, params: [messages], type: messages.Messages}
* Added traverseIncomingConstructor{predicate: messages.messagesSlice, params: [messages], type: messages.Messages}
* Added traverseIncomingConstructor{predicate: messages.myStickers, params: [sets], type: messages.MyStickers}
* Added traverseIncomingConstructor{predicate: messages.peerDialogs, params: [messages], type: messages.PeerDialogs}
* Added traverseIncomingConstructor{predicate: messages.preparedInlineMessage, params: [result], type: messages.PreparedInlineMessage}
* Added traverseIncomingConstructor{predicate: messages.quickReplies, params: [messages], type: messages.QuickReplies}
* Added traverseIncomingConstructor{predicate: messages.recentStickers, params: [stickers], type: messages.RecentStickers}
* Added traverseIncomingConstructor{predicate: messages.savedDialogs, params: [messages], type: messages.SavedDialogs}
* Added traverseIncomingConstructor{predicate: messages.savedDialogsSlice, params: [messages], type: messages.SavedDialogs}
* Added traverseIncomingConstructor{predicate: messages.savedGifs, params: [gifs], push_sources: [fileSourceSavedGifs], type: messages.SavedGifs}
* Added traverseIncomingConstructor{predicate: messages.searchResultsCalendar, params: [messages], type: messages.SearchResultsCalendar}
* Added traverseIncomingConstructor{predicate: messages.sponsoredMessages, params: [messages], type: messages.SponsoredMessages}
* Added traverseIncomingConstructor{predicate: messages.stickerSet, params: [documents], push_sources: [fileSourceStickerSet], type: messages.StickerSet}
* Added traverseIncomingConstructor{predicate: messages.stickerSetInstallResultArchive, params: [sets], type: messages.StickerSetInstallResult}
* Added traverseIncomingConstructor{predicate: messages.stickers, params: [stickers], type: messages.Stickers}
* Added traverseIncomingConstructor{predicate: messages.webPage, params: [webpage], type: messages.WebPage}
* Added traverseIncomingConstructor{predicate: messages.webPagePreview, params: [media], type: messages.WebPagePreview}
* Added traverseIncomingConstructor{predicate: page, params: [photos, documents], type: Page}
* Added traverseIncomingConstructor{predicate: payments.resaleStarGifts, params: [gifts, attributes], type: payments.ResaleStarGifts}
* Added traverseIncomingConstructor{predicate: payments.savedStarGifts, params: [gifts], type: payments.SavedStarGifts}
* Added traverseIncomingConstructor{predicate: payments.starGiftCollections, params: [collections], type: payments.StarGiftCollections}
* Added traverseIncomingConstructor{predicate: payments.starGiftUpgradePreview, params: [sample_attributes], type: payments.StarGiftUpgradePreview}
* Added traverseIncomingConstructor{predicate: payments.starGifts, params: [gifts], type: payments.StarGifts}
* Added traverseIncomingConstructor{predicate: payments.starsStatus, params: [history], type: payments.StarsStatus}
* Added traverseIncomingConstructor{predicate: payments.uniqueStarGift, params: [gift], type: payments.UniqueStarGift}
* Added traverseIncomingConstructor{predicate: peerStories, params: [stories], is_needed_parent: true, type: PeerStories}
* Added traverseIncomingConstructor{predicate: photos.photo, params: [photo], type: photos.Photo}
* Added traverseIncomingConstructor{predicate: photos.photos, params: [photos], type: photos.Photos}
* Added traverseIncomingConstructor{predicate: photos.photosSlice, params: [photos], type: photos.Photos}
* Added traverseIncomingConstructor{predicate: publicForwardMessage, params: [message], type: PublicForward}
* Added traverseIncomingConstructor{predicate: publicForwardStory, params: [story], push_sources: [fileSourceStory], type: PublicForward}
* Added traverseIncomingConstructor{predicate: recentMeUrlStickerSet, params: [set], type: RecentMeUrl}
* Added traverseIncomingConstructor{predicate: requestedPeerChannel, params: [photo], type: RequestedPeer}
* Added traverseIncomingConstructor{predicate: requestedPeerChat, params: [photo], type: RequestedPeer}
* Added traverseIncomingConstructor{predicate: requestedPeerUser, params: [photo], type: RequestedPeer}
* Added traverseIncomingConstructor{predicate: savedStarGift, params: [gift], type: SavedStarGift}
* Added traverseIncomingConstructor{predicate: sponsoredMessage, params: [media], type: SponsoredMessage}
* Added traverseIncomingConstructor{predicate: starGift, params: [sticker], type: StarGift}
* Added traverseIncomingConstructor{predicate: starGiftAttributeModel, params: [document], type: StarGiftAttribute}
* Added traverseIncomingConstructor{predicate: starGiftAttributePattern, params: [document], type: StarGiftAttribute}
* Added traverseIncomingConstructor{predicate: starGiftCollection, params: [icon], type: StarGiftCollection}
* Added traverseIncomingConstructor{predicate: starGiftUnique, params: [attributes], type: StarGift}
* Added traverseIncomingConstructor{predicate: starsTransaction, params: [extended_media, stargift], push_sources: [fileSourceStarsTransaction (needs payments.getStarsStatus), fileSourceStarsTransaction (needs payments.getStarsTransactions), fileSourceStarsTransaction (needs payments.getStarsTransactionsByID), fileSourceStarsTransaction (needs payments.getStarsSubscriptions)], type: StarsTransaction}
* Added traverseIncomingConstructor{predicate: stats.publicForwards, params: [forwards], type: stats.PublicForwards}
* Added traverseIncomingConstructor{predicate: stickerSetCovered, params: [cover], type: StickerSetCovered}
* Added traverseIncomingConstructor{predicate: stickerSetFullCovered, params: [documents], push_sources: [fileSourceStickerSet], type: StickerSetCovered}
* Added traverseIncomingConstructor{predicate: stickerSetMultiCovered, params: [covers], push_sources: [fileSourceStickerSet], type: StickerSetCovered}
* Added traverseIncomingConstructor{predicate: stories.albums, params: [albums], type: stories.Albums}
* Added traverseIncomingConstructor{predicate: stories.allStories, params: [peer_stories], type: stories.AllStories}
* Added traverseIncomingConstructor{predicate: stories.foundStories, params: [stories], type: stories.FoundStories}
* Added traverseIncomingConstructor{predicate: stories.peerStories, params: [stories], type: stories.PeerStories}
* Added traverseIncomingConstructor{predicate: stories.stories, params: [stories], type: stories.Stories}
* Added traverseIncomingConstructor{predicate: stories.storyReactionsList, params: [reactions], type: stories.StoryReactionsList}
* Added traverseIncomingConstructor{predicate: stories.storyViewsList, params: [views], type: stories.StoryViewsList}
* Added traverseIncomingConstructor{predicate: storyAlbum, params: [icon_photo, icon_video], type: StoryAlbum}
* Added traverseIncomingConstructor{predicate: storyItem, params: [media], push_sources: [fileSourceStory (needs stories.getPinnedStories), fileSourceStory (needs stories.getStoriesArchive), fileSourceStory (needs stories.getStoriesByID), fileSourceStory (needs stories.getAlbumStories), fileSourceStory (needs peerStories), fileSourceStory], type: StoryItem}
* Added traverseIncomingConstructor{predicate: storyReactionPublicForward, params: [message], type: StoryReaction}
* Added traverseIncomingConstructor{predicate: storyReactionPublicRepost, params: [story], push_sources: [fileSourceStory], type: StoryReaction}
* Added traverseIncomingConstructor{predicate: storyViewPublicForward, params: [message], type: StoryView}
* Added traverseIncomingConstructor{predicate: storyViewPublicRepost, params: [story], push_sources: [fileSourceStory], type: StoryView}
* Added traverseIncomingConstructor{predicate: theme, params: [document, settings], push_sources: [fileSourceTheme], type: Theme}
* Added traverseIncomingConstructor{predicate: themeSettings, params: [wallpaper], type: ThemeSettings}
* Added traverseIncomingConstructor{predicate: updateBotEditBusinessMessage, params: [message, reply_to_message], type: Update}
* Added traverseIncomingConstructor{predicate: updateBotNewBusinessMessage, params: [message, reply_to_message], type: Update}
* Added traverseIncomingConstructor{predicate: updateBusinessBotCallbackQuery, params: [message, reply_to_message], type: Update}
* Added traverseIncomingConstructor{predicate: updateChannelWebPage, params: [webpage], type: Update}
* Added traverseIncomingConstructor{predicate: updateEditChannelMessage, params: [message], type: Update}
* Added traverseIncomingConstructor{predicate: updateEditMessage, params: [message], type: Update}
* Added traverseIncomingConstructor{predicate: updateMessageExtendedMedia, params: [extended_media], push_sources: [fileSourcePaidMedia], type: Update}
* Added traverseIncomingConstructor{predicate: updateNewChannelMessage, params: [message], type: Update}
* Added traverseIncomingConstructor{predicate: updateNewMessage, params: [message], type: Update}
* Added traverseIncomingConstructor{predicate: updateNewScheduledMessage, params: [message], is_needed_parent: true, type: Update}
* Added traverseIncomingConstructor{predicate: updateNewStickerSet, params: [stickerset], type: Update}
* Added traverseIncomingConstructor{predicate: updatePeerWallpaper, params: [wallpaper], type: Update}
* Added traverseIncomingConstructor{predicate: updateQuickReplyMessage, params: [message], type: Update}
* Added traverseIncomingConstructor{predicate: updateServiceNotification, params: [media], type: Update}
* Added traverseIncomingConstructor{predicate: updateStory, params: [story], type: Update}
* Added traverseIncomingConstructor{predicate: updateTheme, params: [theme], type: Update}
* Added traverseIncomingConstructor{predicate: updateWebPage, params: [webpage], type: Update}
* Added traverseIncomingConstructor{predicate: updates.channelDifference, params: [new_messages], type: updates.ChannelDifference}
* Added traverseIncomingConstructor{predicate: updates.channelDifferenceTooLong, params: [messages], type: updates.ChannelDifference}
* Added traverseIncomingConstructor{predicate: updates.difference, params: [new_messages], type: updates.Difference}
* Added traverseIncomingConstructor{predicate: updates.differenceSlice, params: [new_messages], type: updates.Difference}
* Added traverseIncomingConstructor{predicate: userFull, params: [personal_photo, profile_photo, fallback_photo, bot_info, theme, wallpaper, stories, business_intro, saved_music], push_sources: [fileSourceUserFull, fileSourceSavedMusic], type: UserFull}
* Added traverseIncomingConstructor{predicate: users.savedMusic, params: [documents], type: users.SavedMusic}
* Added traverseIncomingConstructor{predicate: users.userFull, params: [full_user], type: users.UserFull}
* Added traverseIncomingConstructor{predicate: wallPaper, params: [document], push_sources: [fileSourceWallPaper], type: WallPaper}
* Added traverseIncomingConstructor{predicate: webPage, params: [photo, document, cached_page, attributes], push_sources: [fileSourceWebPage], type: WebPage}
* Added traverseIncomingConstructor{predicate: webPageAttributeStarGiftCollection, params: [icons], type: WebPageAttribute}
* Added traverseIncomingConstructor{predicate: webPageAttributeStickerSet, params: [stickers], type: WebPageAttribute}
* Added traverseIncomingConstructor{predicate: webPageAttributeStory, params: [story], push_sources: [fileSourceStory], type: WebPageAttribute}
* Added traverseIncomingConstructor{predicate: webPageAttributeTheme, params: [documents, settings], type: WebPageAttribute}
* Added traverseIncomingConstructor{predicate: webPageAttributeUniqueStarGift, params: [gift], type: WebPageAttribute}
* Added traverseMethodResult{name: account.createTheme}
* Added traverseMethodResult{name: account.getChatThemes}
* Added traverseMethodResult{name: account.getMultiWallPapers}
* Added traverseMethodResult{name: account.getSavedRingtones}
* Added traverseMethodResult{name: account.getTheme}
* Added traverseMethodResult{name: account.getThemes}
* Added traverseMethodResult{name: account.getUniqueGiftChatThemes}
* Added traverseMethodResult{name: account.getWallPaper}
* Added traverseMethodResult{name: account.getWallPapers}
* Added traverseMethodResult{name: account.saveRingtone}
* Added traverseMethodResult{name: account.updateTheme}
* Added traverseMethodResult{name: account.uploadRingtone, push_sources: [fileSourceSavedRingtones]}
* Added traverseMethodResult{name: account.uploadTheme}
* Added traverseMethodResult{name: account.uploadWallPaper}
* Added traverseMethodResult{name: bots.addPreviewMedia, push_sources: [fileSourceBotPreviewInfo]}
* Added traverseMethodResult{name: bots.editPreviewMedia, push_sources: [fileSourceBotPreviewInfo]}
* Added traverseMethodResult{name: bots.getPreviewInfo, push_sources: [fileSourceBotPreviewInfo]}
* Added traverseMethodResult{name: bots.getPreviewMedias, push_sources: [fileSourceBotPreviewMedia]}
* Added traverseMethodResult{name: channels.getAdminLog, is_needed_parent: true}
* Added traverseMethodResult{name: channels.getForumTopics}
* Added traverseMethodResult{name: channels.getForumTopicsByID}
* Added traverseMethodResult{name: channels.getFullChannel}
* Added traverseMethodResult{name: channels.getMessages}
* Added traverseMethodResult{name: channels.searchPosts}
* Added traverseMethodResult{name: help.getAppUpdate}
* Added traverseMethodResult{name: help.getPremiumPromo, push_sources: [fileSourcePremiumPromo]}
* Added traverseMethodResult{name: help.getRecentMeUrls}
* Added traverseMethodResult{name: messages.getArchivedStickers}
* Added traverseMethodResult{name: messages.getAttachMenuBot}
* Added traverseMethodResult{name: messages.getAttachMenuBots}
* Added traverseMethodResult{name: messages.getAttachedStickers}
* Added traverseMethodResult{name: messages.getAvailableEffects}
* Added traverseMethodResult{name: messages.getAvailableReactions}
* Added traverseMethodResult{name: messages.getBotApp}
* Added traverseMethodResult{name: messages.getCustomEmojiDocuments}
* Added traverseMethodResult{name: messages.getDialogs}
* Added traverseMethodResult{name: messages.getDiscussionMessage}
* Added traverseMethodResult{name: messages.getDocumentByHash, push_sources: [fileSourceDocumentByHash]}
* Added traverseMethodResult{name: messages.getFavedStickers}
* Added traverseMethodResult{name: messages.getFeaturedEmojiStickers}
* Added traverseMethodResult{name: messages.getFeaturedStickers}
* Added traverseMethodResult{name: messages.getFullChat}
* Added traverseMethodResult{name: messages.getHistory}
* Added traverseMethodResult{name: messages.getInlineBotResults}
* Added traverseMethodResult{name: messages.getMessages}
* Added traverseMethodResult{name: messages.getMyStickers}
* Added traverseMethodResult{name: messages.getOldFeaturedStickers}
* Added traverseMethodResult{name: messages.getPeerDialogs}
* Added traverseMethodResult{name: messages.getPinnedDialogs}
* Added traverseMethodResult{name: messages.getPinnedSavedDialogs}
* Added traverseMethodResult{name: messages.getPreparedInlineMessage}
* Added traverseMethodResult{name: messages.getQuickReplies}
* Added traverseMethodResult{name: messages.getQuickReplyMessages}
* Added traverseMethodResult{name: messages.getRecentLocations}
* Added traverseMethodResult{name: messages.getRecentStickers}
* Added traverseMethodResult{name: messages.getReplies}
* Added traverseMethodResult{name: messages.getSavedDialogs}
* Added traverseMethodResult{name: messages.getSavedDialogsByID}
* Added traverseMethodResult{name: messages.getSavedGifs}
* Added traverseMethodResult{name: messages.getSavedHistory}
* Added traverseMethodResult{name: messages.getScheduledHistory}
* Added traverseMethodResult{name: messages.getScheduledMessages, is_needed_parent: true}
* Added traverseMethodResult{name: messages.getSearchResultsCalendar}
* Added traverseMethodResult{name: messages.getSponsoredMessages}
* Added traverseMethodResult{name: messages.getStickerSet}
* Added traverseMethodResult{name: messages.getStickers}
* Added traverseMethodResult{name: messages.getUnreadMentions}
* Added traverseMethodResult{name: messages.getUnreadReactions}
* Added traverseMethodResult{name: messages.getWebPage}
* Added traverseMethodResult{name: messages.getWebPagePreview}
* Added traverseMethodResult{name: messages.installStickerSet}
* Added traverseMethodResult{name: messages.search}
* Added traverseMethodResult{name: messages.searchEmojiStickerSets}
* Added traverseMethodResult{name: messages.searchGlobal}
* Added traverseMethodResult{name: messages.searchSentMedia}
* Added traverseMethodResult{name: messages.searchStickerSets}
* Added traverseMethodResult{name: messages.searchStickers}
* Added traverseMethodResult{name: messages.uploadImportedMedia}
* Added traverseMethodResult{name: messages.uploadMedia}
* Added traverseMethodResult{name: payments.createStarGiftCollection}
* Added traverseMethodResult{name: payments.getResaleStarGifts}
* Added traverseMethodResult{name: payments.getSavedStarGift}
* Added traverseMethodResult{name: payments.getSavedStarGifts}
* Added traverseMethodResult{name: payments.getStarGiftCollections}
* Added traverseMethodResult{name: payments.getStarGiftUpgradePreview}
* Added traverseMethodResult{name: payments.getStarGifts}
* Added traverseMethodResult{name: payments.getStarsStatus, is_needed_parent: true}
* Added traverseMethodResult{name: payments.getStarsSubscriptions, is_needed_parent: true}
* Added traverseMethodResult{name: payments.getStarsTransactions, is_needed_parent: true}
* Added traverseMethodResult{name: payments.getStarsTransactionsByID, is_needed_parent: true}
* Added traverseMethodResult{name: payments.getUniqueStarGift}
* Added traverseMethodResult{name: payments.updateStarGiftCollection}
* Added traverseMethodResult{name: photos.getUserPhotos, is_needed_parent: true}
* Added traverseMethodResult{name: photos.updateProfilePhoto, push_sources: [fileSourceUserProfilePhoto]}
* Added traverseMethodResult{name: photos.uploadContactProfilePhoto, push_sources: [fileSourceUserProfilePhoto]}
* Added traverseMethodResult{name: photos.uploadProfilePhoto, push_sources: [fileSourceUserProfilePhoto]}
* Added traverseMethodResult{name: stats.getMessagePublicForwards}
* Added traverseMethodResult{name: stats.getStoryPublicForwards}
* Added traverseMethodResult{name: stickers.addStickerToSet}
* Added traverseMethodResult{name: stickers.changeSticker}
* Added traverseMethodResult{name: stickers.changeStickerPosition}
* Added traverseMethodResult{name: stickers.createStickerSet}
* Added traverseMethodResult{name: stickers.removeStickerFromSet}
* Added traverseMethodResult{name: stickers.renameStickerSet}
* Added traverseMethodResult{name: stickers.replaceSticker}
* Added traverseMethodResult{name: stickers.setStickerSetThumb}
* Added traverseMethodResult{name: stories.createAlbum, push_sources: [fileSourceStoryAlbum]}
* Added traverseMethodResult{name: stories.getAlbumStories, is_needed_parent: true}
* Added traverseMethodResult{name: stories.getAlbums, push_sources: [fileSourceStoryAlbum]}
* Added traverseMethodResult{name: stories.getAllStories}
* Added traverseMethodResult{name: stories.getPeerStories}
* Added traverseMethodResult{name: stories.getPinnedStories, is_needed_parent: true}
* Added traverseMethodResult{name: stories.getStoriesArchive, is_needed_parent: true}
* Added traverseMethodResult{name: stories.getStoriesByID, is_needed_parent: true}
* Added traverseMethodResult{name: stories.getStoryReactionsList}
* Added traverseMethodResult{name: stories.getStoryViewsList}
* Added traverseMethodResult{name: stories.searchPosts}
* Added traverseMethodResult{name: stories.updateAlbum, push_sources: [fileSourceStoryAlbum]}
* Added traverseMethodResult{name: updates.getChannelDifference}
* Added traverseMethodResult{name: updates.getDifference}
* Added traverseMethodResult{name: users.getFullUser}
* Added traverseMethodResult{name: users.getSavedMusic, is_needed_parent: true}
* Added traverseMethodResult{name: users.getSavedMusicByID, is_needed_parent: true}
##### New traversers outgoing
* Added traverseMethodCall{name: account.createTheme, params: [document]}
* Added traverseMethodCall{name: account.reportProfilePhoto, params: [photo_id]}
* Added traverseMethodCall{name: account.saveMusic, params: [id, after_id]}
* Added traverseMethodCall{name: account.saveRingtone, params: [id]}
* Added traverseMethodCall{name: account.updateBusinessIntro, params: [intro]}
* Added traverseMethodCall{name: account.updateTheme, params: [document]}
* Added traverseMethodCall{name: account.uploadRingtone, params: [file]}
* Added traverseMethodCall{name: account.uploadTheme, params: [file, thumb]}
* Added traverseMethodCall{name: account.uploadWallPaper, params: [file]}
* Added traverseMethodCall{name: bots.addPreviewMedia, params: [media]}
* Added traverseMethodCall{name: bots.deletePreviewMedia, params: [media]}
* Added traverseMethodCall{name: bots.editPreviewMedia, params: [media, new_media]}
* Added traverseMethodCall{name: bots.reorderPreviewMedias, params: [order]}
* Added traverseMethodCall{name: channels.editPhoto, params: [photo]}
* Added traverseMethodCall{name: messages.editChatPhoto, params: [photo]}
* Added traverseMethodCall{name: messages.editInlineBotMessage, params: [media]}
* Added traverseMethodCall{name: messages.editMessage, params: [media]}
* Added traverseMethodCall{name: messages.faveSticker, params: [id]}
* Added traverseMethodCall{name: messages.getAttachedStickers, params: [media]}
* Added traverseMethodCall{name: messages.initHistoryImport, params: [file]}
* Added traverseMethodCall{name: messages.saveDraft, params: [media]}
* Added traverseMethodCall{name: messages.saveGif, params: [id]}
* Added traverseMethodCall{name: messages.savePreparedInlineMessage, params: [result]}
* Added traverseMethodCall{name: messages.saveRecentSticker, params: [id]}
* Added traverseMethodCall{name: messages.sendMedia, params: [media]}
* Added traverseMethodCall{name: messages.sendMultiMedia, params: [multi_media]}
* Added traverseMethodCall{name: messages.sendWebViewResultMessage, params: [result]}
* Added traverseMethodCall{name: messages.setInlineBotResults, params: [results]}
* Added traverseMethodCall{name: messages.uploadImportedMedia, params: [media]}
* Added traverseMethodCall{name: messages.uploadMedia, params: [media]}
* Added traverseMethodCall{name: payments.exportInvoice, params: [invoice_media]}
* Added traverseMethodCall{name: phone.saveCallLog, params: [file]}
* Added traverseMethodCall{name: photos.deletePhotos, params: [id]}
* Added traverseMethodCall{name: photos.updateProfilePhoto, params: [id]}
* Added traverseMethodCall{name: photos.uploadContactProfilePhoto, params: [file, video]}
* Added traverseMethodCall{name: photos.uploadProfilePhoto, params: [file, video]}
* Added traverseMethodCall{name: stickers.addStickerToSet, params: [sticker]}
* Added traverseMethodCall{name: stickers.changeSticker, params: [sticker]}
* Added traverseMethodCall{name: stickers.changeStickerPosition, params: [sticker]}
* Added traverseMethodCall{name: stickers.createStickerSet, params: [thumb, stickers]}
* Added traverseMethodCall{name: stickers.removeStickerFromSet, params: [sticker]}
* Added traverseMethodCall{name: stickers.replaceSticker, params: [sticker, new_sticker]}
* Added traverseMethodCall{name: stickers.setStickerSetThumb, params: [thumb]}
* Added traverseMethodCall{name: stories.editStory, params: [media]}
* Added traverseMethodCall{name: stories.sendStory, params: [media]}
* Added traverseMethodCall{name: upload.getFile, params: [location]}
* Added traverseMethodCall{name: upload.getFileHashes, params: [location]}
* Added traverseMethodCall{name: upload.getWebFile, params: [location]}
* Added traverseMethodCall{name: users.getSavedMusicByID, params: [documents]}
* Added traverseOutgoingConstructor{predicate: inputBotInlineResultDocument, params: [document], type: InputBotInlineResult}
* Added traverseOutgoingConstructor{predicate: inputBotInlineResultPhoto, params: [photo], type: InputBotInlineResult}
* Added traverseOutgoingConstructor{predicate: inputBusinessIntro, params: [sticker], type: InputBusinessIntro}
* Added traverseOutgoingConstructor{predicate: inputChatPhoto, params: [id], type: InputChatPhoto}
* Added traverseOutgoingConstructor{predicate: inputChatUploadedPhoto, params: [file, video], type: InputChatPhoto}
* Added traverseOutgoingConstructor{predicate: inputFileStoryDocument, params: [id], type: InputFile}
* Added traverseOutgoingConstructor{predicate: inputMediaDocument, params: [id, video_cover], type: InputMedia}
* Added traverseOutgoingConstructor{predicate: inputMediaDocumentExternal, params: [video_cover], type: InputMedia}
* Added traverseOutgoingConstructor{predicate: inputMediaInvoice, params: [extended_media], type: InputMedia}
* Added traverseOutgoingConstructor{predicate: inputMediaPaidMedia, params: [extended_media], type: InputMedia}
* Added traverseOutgoingConstructor{predicate: inputMediaPhoto, params: [id], type: InputMedia}
* Added traverseOutgoingConstructor{predicate: inputMediaUploadedDocument, params: [file, thumb, stickers, video_cover], type: InputMedia}
* Added traverseOutgoingConstructor{predicate: inputMediaUploadedPhoto, params: [file, stickers], type: InputMedia}
* Added traverseOutgoingConstructor{predicate: inputSingleMedia, params: [media], type: InputSingleMedia}
* Added traverseOutgoingConstructor{predicate: inputStickerSetItem, params: [document], type: InputStickerSetItem}
* Added traverseOutgoingConstructor{predicate: inputStickeredMediaDocument, params: [id], type: InputStickeredMedia}
* Added traverseOutgoingConstructor{predicate: inputStickeredMediaPhoto, params: [id], type: InputStickeredMedia}
* Added traverseOutgoingConstructor{predicate: inputWebFileAudioAlbumThumbLocation, params: [document], type: InputWebFileLocation}
* Added traverseSwapLocation{predicate: inputDocument, stored_constructor: fileIdDocument, type: InputDocument}
* Added traverseSwapLocation{predicate: inputDocumentFileLocation, stored_constructor: fileIdDocument, type: InputFileLocation}
* Added traverseSwapLocation{predicate: inputPhoto, stored_constructor: fileIdPhoto, type: InputPhoto}
* Added traverseSwapLocation{predicate: inputPhotoFileLocation, stored_constructor: fileIdPhoto, type: InputFileLocation}
#### [Schema](/schema.md)
### [Layer 213](/schema?layer=213)
This layer introduces the following new features:
- [Changing the default profile tab »](/api/profile.md#tabs)
- [Saving music to the profile »](/api/profile.md#music)
- [Added a `locked_until_date` flag to starGift, for locked gifts that cannot be sent until the specified date](/constructor/starGift.md).
- [Added the payments.checkCanSendGift method, to check if a non-locked gift can't be sent yet for other reasons](/method/payments.checkCanSendGift.md).
- [Added an optional `spend_purpose_peer` flag to inputStorePaymentStarsTopup, that should be populated with the peer where the topup process was initiated due to low funds (i.e. a bot for bot payments, a channel for paid media/reactions, etc) »](/constructor/inputStorePaymentStarsTopup.md)[Documentation for the profile page was also reorganized, to include the full list of tabs to show, along with instructions on how to populate them »](/api/profile.md).
#### [Schema](/schema.md) changes
##### New Methods
* Added [account.setMainProfileTab](/method/account.setMainProfileTab.md) - Changes the main profile tab of the current user, see [here »](/api/profile.md#tabs) for more info.
* Added [account.saveMusic](/method/account.saveMusic.md) - Adds or removes a song from the current user's profile [see here »](/api/profile.md#music) for more info on the music tab of the profile page.
* Added [account.getSavedMusicIds](/method/account.getSavedMusicIds.md) - Fetch the full list of only the IDs of [songs currently added to the profile, see here »](/api/profile.md#music) for more info.
* Added [users.getSavedMusic](/method/users.getSavedMusic.md) - Get songs [pinned to the user's profile, see here »](/api/profile.md#music) for more info.
* Added [users.getSavedMusicByID](/method/users.getSavedMusicByID.md) - Check if the passed songs are still pinned to the user's profile, or refresh the file references of songs pinned on a user's profile [see here »](/api/profile.md#music) for more info.
* Added [channels.setMainProfileTab](/method/channels.setMainProfileTab.md) - Changes the main profile tab of a channel, see [here »](/api/profile.md#tabs) for more info.
* Added [payments.checkCanSendGift](/method/payments.checkCanSendGift.md) - Check if the specified [gift »](/api/gifts.md) can be sent.
##### New Constructors
* Added [profileTabPosts](/constructor/profileTabPosts.md) - Represents the [stories](/api/stories.md) tab of a profile page.
* Added [profileTabGifts](/constructor/profileTabGifts.md) - Represents the [gifts](/api/gifts.md) tab of a profile page.
* Added [profileTabMedia](/constructor/profileTabMedia.md) - Represents the media tab of a profile page.
* Added [profileTabFiles](/constructor/profileTabFiles.md) - Represents the shared files tab of a profile.
* Added [profileTabMusic](/constructor/profileTabMusic.md) - Represents the [music](/api/profile.md#music) tab of a profile page.
* Added [profileTabVoice](/constructor/profileTabVoice.md) - Represents the voice messages tab of a profile page.
* Added [profileTabLinks](/constructor/profileTabLinks.md) - Represents the shared links tab of a profile page.
* Added [profileTabGifs](/constructor/profileTabGifs.md) - Represents the gifs tab of a profile page.
* Added [users.savedMusicNotModified](/constructor/users.savedMusicNotModified.md) - This subset of the songs currently pinned on a user's profile hasn't changed, see [here »](/api/profile.md#music) for more info.
* Added [users.savedMusic](/constructor/users.savedMusic.md) - List of songs currently pinned on a user's profile, see [here »](/api/profile.md#music) for more info.
* Added [account.savedMusicIdsNotModified](/constructor/account.savedMusicIdsNotModified.md) - The list of IDs of songs ([document](/constructor/document.md).`id`s) currently pinned on our profile hasn't changed.
* Added [account.savedMusicIds](/constructor/account.savedMusicIds.md) - List of IDs of songs ([document](/constructor/document.md).`id`s) currently pinned on our profile, see [here »](/api/profile.md#music) for more info.
* Added [payments.checkCanSendGiftResultOk](/constructor/payments.checkCanSendGiftResultOk.md) - The specified gift can be sent.
* Added [payments.checkCanSendGiftResultFail](/constructor/payments.checkCanSendGiftResultFail.md) - The specified gift cannot be sent yet for the specified reason.
##### Changed Constructors
* Added **main_tab** parameter in [channelFull](/constructor/channelFull.md)
* Added **upgrade_separate** parameter in [messageActionStarGift](/constructor/messageActionStarGift.md)
* Added **main_tab**, **saved_music** parameters in [userFull](/constructor/userFull.md)
* Added **flags**, **spend_purpose_peer** parameters in [inputStorePaymentStarsTopup](/constructor/inputStorePaymentStarsTopup.md)
* Added **locked_until_date** parameter in [starGift](/constructor/starGift.md)
* Added **chats** parameter in [payments.uniqueStarGift](/constructor/payments.uniqueStarGift.md)
* Added **chats** parameter in [messages.webPagePreview](/constructor/messages.webPagePreview.md)
* Added **upgrade_separate** parameter in [savedStarGift](/constructor/savedStarGift.md)
#### [Schema](/schema.md)
### [Layer 212](/schema?layer=212)
This layer introduces the following features:
- [Separately prepay for the upgrade of a gift »](/api/gifts.md#prepaying-for-someone-elses-upgrade).
- [Get info about the value of a collectible gift »](/method/payments.getUniqueStarGiftValueInfo.md)
#### [Schema](/schema.md) changes
##### New Methods
* Added [payments.getUniqueStarGiftValueInfo](/method/payments.getUniqueStarGiftValueInfo.md) - Get information about the value of a [collectible gift »](/api/gifts.md#collectible-gifts).
##### Changed Methods
* Added **exclude_upgradable**, **exclude_unupgradable** parameters, removed **exclude_limited** parameter in [payments.getSavedStarGifts](/method/payments.getSavedStarGifts.md)
##### New Constructors
* Added [inputInvoiceStarGiftPrepaidUpgrade](/constructor/inputInvoiceStarGiftPrepaidUpgrade.md) - [Separately prepay for the upgrade of a gift »](/api/gifts.md#prepaying-for-someone-elses-upgrade).
* Added [payments.uniqueStarGiftValueInfo](/constructor/payments.uniqueStarGiftValueInfo.md) - Information about the value of a [collectible gift »](/api/gifts.md#collectible-gifts).
##### Changed Constructors
* Added **prepaid_upgrade**, **prepaid_upgrade_hash**, **gift_msg_id** parameters in [messageActionStarGift](/constructor/messageActionStarGift.md)
* Added **prepaid_upgrade** parameter in [messageActionStarGiftUnique](/constructor/messageActionStarGiftUnique.md)
* Added **posts_search**, **stargift_prepaid_upgrade** parameters in [starsTransaction](/constructor/starsTransaction.md)
* Added **gift_id**, **value_amount**, **value_currency** parameters in [starGiftUnique](/constructor/starGiftUnique.md)
* Added **prepaid_upgrade_hash** parameter in [savedStarGift](/constructor/savedStarGift.md)
#### [End-to-end group call schema »](/api/end-to-end/group-calls.md) changes
##### New Constructors
* Added [e2e.chain.groupBroadcastNonceCommit](/constructor/e2e.chain.groupBroadcastNonceCommit.md) - Commit message for the [E2E conference call emoji verification protocol](/api/end-to-end/group-calls.md#commit-reveal-protocol-workflow).
* Added [e2e.chain.groupBroadcastNonceReveal](/constructor/e2e.chain.groupBroadcastNonceReveal.md) - Reveal message for the [E2E conference call emoji verification protocol](/api/end-to-end/group-calls.md#commit-reveal-protocol-workflow).
* Added [e2e.chain.groupParticipant](/constructor/e2e.chain.groupParticipant.md) - A participant and their permissions in an [E2E conference call group state »](/api/end-to-end/group-calls.md#participants-and-permissions).
* Added [e2e.chain.groupState](/constructor/e2e.chain.groupState.md) - The participant list and external permission mask for an [E2E conference call blockchain state »](/api/end-to-end/group-calls.md#participants-and-permissions).
* Added [e2e.chain.sharedKey](/constructor/e2e.chain.sharedKey.md) - Encrypted [shared group key material](/api/end-to-end/group-calls.md#shared-key-encryption) for an E2E conference call.
* Added [e2e.chain.changeNoop](/constructor/e2e.chain.changeNoop.md) - A no-operation [E2E conference call blockchain change](/api/end-to-end/group-calls.md#change-types-for-group-calls), potentially used only to randomize the resulting block hash.
* Added [e2e.chain.changeSetValue](/constructor/e2e.chain.changeSetValue.md) - Updates the [key-value trie state for an E2E conference call blockchain](/api/end-to-end/group-calls.md#change-types-for-group-calls).
* Added [e2e.chain.changeSetGroupState](/constructor/e2e.chain.changeSetGroupState.md) - Updates the [E2E conference call participant list and permissions](/api/end-to-end/group-calls.md#change-types-for-group-calls), clearing the current shared key state.
* Added [e2e.chain.changeSetSharedKey](/constructor/e2e.chain.changeSetSharedKey.md) - Establishes a new shared encryption key for an E2E conference call, see [change types for group calls »](/api/end-to-end/group-calls.md#change-types-for-group-calls).
* Added [e2e.chain.stateProof](/constructor/e2e.chain.stateProof.md) - Proof of the [E2E conference call blockchain state](/api/end-to-end/group-calls.md#block-application-process) after a block has been applied.
* Added [e2e.chain.block](/constructor/e2e.chain.block.md) - A block in the [main E2E conference call blockchain](/api/end-to-end/group-calls.md#block-structure), containing state changes for the call and the resulting state proof.
* Added [e2e.callPacket](/constructor/e2e.callPacket.md) - Marker constructor whose CRC32 constructor ID is used when deriving and authenticating [encrypted group call packets](/api/end-to-end/group-calls.md#packet-encryption).
* Added [e2e.callPacketLargeMsgId](/constructor/e2e.callPacketLargeMsgId.md) - Marker constructor whose CRC32 constructor ID is used when signing the large message ID produced while encrypting [group call packets](/api/end-to-end/group-calls.md#packet-encryption).
#### [End-to-end group call schema »](/api/end-to-end/group-calls.md)
#### [Schema](/schema.md)
### [Layer 211](/schema?layer=211)
This layer introduces:
- [Story albums »](/api/stories.md#story-albums)
- [Star gift collection link previews »](/constructor/webPageAttributeStarGiftCollection.md)
- [Full text global channel post search »](/api/search.md#posts-tab)
- [Allow specification of the resale price of a collectible gift in TON »](/constructor/messageActionStarGiftUnique.md)
- [Pending star ratings »](/api/stars.md#star-rating)
#### [Schema](/schema.md) changes
##### New Methods
* Added [channels.checkSearchPostsFlood](/method/channels.checkSearchPostsFlood.md) - Check if the specified [global post search »](/api/search.md#posts-tab) requires payment.
* Added [stories.createAlbum](/method/stories.createAlbum.md) - Creates a [story album](/api/stories.md#story-albums).
* Added [stories.updateAlbum](/method/stories.updateAlbum.md) - Rename a [story albums »](/api/stories.md#story-albums), or add, delete or reorder stories in it.
* Added [stories.reorderAlbums](/method/stories.reorderAlbums.md) - Reorder [story albums on a profile »](/api/stories.md#story-albums).
* Added [stories.deleteAlbum](/method/stories.deleteAlbum.md) - Delete a [story album](/api/stories.md#story-albums).
* Added [stories.getAlbums](/method/stories.getAlbums.md) - Get [story albums](/api/stories.md#story-albums) created by a peer.
* Added [stories.getAlbumStories](/method/stories.getAlbumStories.md) - Get stories in a [story album »](/api/stories.md#story-albums).
##### Changed Methods
* Added **flags**, **query**, **allow_paid_stars** parameters, changed type of **hashtag** from **string** to **flags.0?string** in [channels.searchPosts](/method/channels.searchPosts.md)
* Added **resell_amount** parameter, removed **resell_stars** parameter in [payments.updateStarGiftPrice](/method/payments.updateStarGiftPrice.md)
* Added **albums** parameter in [stories.sendStory](/method/stories.sendStory.md)
##### New Constructors
* Added [webPageAttributeStarGiftCollection](/constructor/webPageAttributeStarGiftCollection.md) - Contains info about a [gift collection »](/api/gifts.md#gift-collections) for a [webPage](/constructor/webPage.md) preview of a [gift collection »](/api/gifts.md#gift-collections) (the [webPage](/constructor/webPage.md) will have a `type` of `telegram_collection`).
* Added [storyAlbum](/constructor/storyAlbum.md) - Represents a [story album »](/api/stories.md#story-albums).
* Added [stories.albumsNotModified](/constructor/stories.albumsNotModified.md) - The [story album list »](/api/stories.md#story-albums) hasn't changed.
* Added [stories.albums](/constructor/stories.albums.md) - [Story albums »](/api/stories.md#story-albums).
* Added [searchPostsFlood](/constructor/searchPostsFlood.md) - Indicates if the specified [global post search »](/api/search.md#posts-tab) requires payment.
##### Changed Constructors
* Added **resale_amount** parameter, removed **resale_stars** parameter in [messageActionStarGiftUnique](/constructor/messageActionStarGiftUnique.md)
* Added **stars_my_pending_rating**, **stars_my_pending_rating_date** parameters in [userFull](/constructor/userFull.md)
* Added **search_flood** parameter in [messages.messagesSlice](/constructor/messages.messagesSlice.md)
* Added **flags**, **ton** parameters in [inputInvoiceStarGiftResale](/constructor/inputInvoiceStarGiftResale.md)
* Added **albums** parameter in [storyItem](/constructor/storyItem.md)
* Added **resale_ton_only**, **resell_amount** parameters, removed **resell_stars** parameter in [starGiftUnique](/constructor/starGiftUnique.md)
#### [Schema](/schema.md)
### [Layer 210](/schema?layer=210)
This layer introduces:
- [Star gift collections »](/api/gifts.md#gift-collections)
- Premium-only gifts (`require_premium`) and per-user gift limits for certain gift types (`per_user_total`, `per_user_remains`).
- [Star ratings »](/api/stars.md#star-rating)
#### [Schema](/schema.md) changes
##### New Methods
* Added [payments.createStarGiftCollection](/method/payments.createStarGiftCollection.md) - Create a [star gift collection »](/api/gifts.md#gift-collections).
* Added [payments.updateStarGiftCollection](/method/payments.updateStarGiftCollection.md) - Add or remove gifts from a [star gift collection »](/api/gifts.md#gift-collections), or rename the collection.
* Added [payments.reorderStarGiftCollections](/method/payments.reorderStarGiftCollections.md) - Reorder the [star gift collections »](/api/gifts.md#gift-collections) on an owned peer's profile.
* Added [payments.deleteStarGiftCollection](/method/payments.deleteStarGiftCollection.md) - Delete a [star gift collection »](/api/gifts.md#gift-collections).
* Added [payments.getStarGiftCollections](/method/payments.getStarGiftCollections.md) - Fetches all [star gift collections »](/api/gifts.md#gift-collections) of a peer.
##### Changed Methods
* Added **collection_id** parameter in [payments.getSavedStarGifts](/method/payments.getSavedStarGifts.md)
##### New Constructors
* Added [starsRating](/constructor/starsRating.md) - Represents the profile's [star rating, see here »](/api/stars.md#star-rating) for more info.
* Added [starGiftCollection](/constructor/starGiftCollection.md) - Represents a [star gift collection »](/api/gifts.md#gift-collections).
* Added [payments.starGiftCollectionsNotModified](/constructor/payments.starGiftCollectionsNotModified.md) - The list of [star gift collections »](/api/gifts.md#gift-collections) hasn't changed.
* Added [payments.starGiftCollections](/constructor/payments.starGiftCollections.md) - Represents a list of [star gift collections »](/api/gifts.md#gift-collections).
##### Changed Constructors
* Added **stars_rating** parameter in [userFull](/constructor/userFull.md)
* Added **require_premium**, **limited_per_user**, **per_user_total**, **per_user_remains** parameters in [starGift](/constructor/starGift.md)
* Added **require_premium** parameter in [starGiftUnique](/constructor/starGiftUnique.md)
* Added **collection_id** parameter in [savedStarGift](/constructor/savedStarGift.md)
#### [Schema](/schema.md)
### [Layer 208](/schema?layer=208)
This layer introduces:
- [Suggested channel posts »](/api/suggested-posts.md)
- Add a new `manage_direct_messages` [admin right](/constructor/chatAdminRights.md)
- Add support for the new `manage_direct_messages` [admin right](/constructor/chatAdminRights.md) in [group/channel bot links](/api/links.md#group-channel-bot-links)
- [Allow replying to specific todo tasks »](/api/todo.md)
- Unify channel revenue statistics and withdrawal methods with the equivalent ones used for stars, by simply adding a `ton` flag and the missing parameters:
- [Balance and transaction history »](/api/stars.md#balance-and-transaction-history)
- [Revenue statistics »](/api/stars.md#revenue-statistics)
- [Withdrawing revenue »](/api/stars.md#withdrawing-revenue)
- In some places in the API, it's possible to use Grams instead of Stars, see [here »](/api/stars.md#gram) for more info.
#### [Schema](/schema.md) changes
##### Changed Constructors
* Added **todo_item_id** parameter in [messageReplyHeader](/constructor/messageReplyHeader.md)
* Added **todo_item_id** parameter in [inputReplyToMessage](/constructor/inputReplyToMessage.md)
* Removed **posts_search** parameter in [starsTransaction](/constructor/starsTransaction.md)
#### [Schema](/schema.md)
### [Layer 207](/schema?layer=207)
This layer introduces:
- [Suggested posts »](/api/suggested-posts.md), letting users propose paid posts to channels, with approval, success and refund [service messages](/constructor/messageActionSuggestedPostApproval.md)
- A new `manage_direct_messages` [admin right](/constructor/chatAdminRights.md)
- The ability to gift, hold and withdraw [Gram »](/api/stars.md#gram) alongside Telegram Stars: TON balances and transactions in the stars status/transaction/revenue methods, TON gifts ([messageActionGiftTon](/constructor/messageActionGiftTon.md), [starsTonAmount](/constructor/starsTonAmount.md)), and the unification of channel revenue statistics and withdrawals with the equivalent Stars methods
- [Global post search »](/api/search.md#posts-tab)
#### [Schema](/schema.md) changes
##### New Methods
* Added [messages.toggleSuggestedPostApproval](/method/messages.toggleSuggestedPostApproval.md) - Approve or reject a [suggested post »](/api/suggested-posts.md).
##### Changed Methods
* Added **suggested_post** parameter in [messages.sendMessage](/method/messages.sendMessage.md)
* Added **suggested_post** parameter in [messages.sendMedia](/method/messages.sendMedia.md)
* Added **suggested_post** parameter in [messages.forwardMessages](/method/messages.forwardMessages.md)
* Added **suggested_post** parameter in [messages.saveDraft](/method/messages.saveDraft.md)
* Added **flags**, **ton** parameters in [payments.getStarsStatus](/method/payments.getStarsStatus.md)
* Added **ton** parameter in [payments.getStarsTransactions](/method/payments.getStarsTransactions.md)
* Added **ton** parameter in [payments.getStarsRevenueStats](/method/payments.getStarsRevenueStats.md)
* Added **flags**, **ton**, **amount** parameters, removed **stars** parameter in [payments.getStarsRevenueWithdrawalUrl](/method/payments.getStarsRevenueWithdrawalUrl.md)
* Added **flags**, **ton** parameters in [payments.getStarsTransactionsByID](/method/payments.getStarsTransactionsByID.md)
##### Deleted Methods
* Removed stats.getBroadcastRevenueStats
* Removed stats.getBroadcastRevenueWithdrawalUrl
* Removed stats.getBroadcastRevenueTransactions
##### New Constructors
* Added [suggestedPost](/constructor/suggestedPost.md) - Contains info about a [suggested post »](/api/suggested-posts.md).
* Added [messageActionSuggestedPostApproval](/constructor/messageActionSuggestedPostApproval.md) - A [suggested post »](/api/suggested-posts.md) was approved or rejected.
* Added [messageActionSuggestedPostSuccess](/constructor/messageActionSuggestedPostSuccess.md) - A [suggested post »](/api/suggested-posts.md) was successfully posted, and payment for it was successfully received.
* Added [messageActionSuggestedPostRefund](/constructor/messageActionSuggestedPostRefund.md) - A [suggested post »](/api/suggested-posts.md) was accepted and posted or scheduled, but either the channel deleted the posted/scheduled post before [stars\_suggested\_post\_age\_min](/api/config.md#stars-suggested-post-age-min) seconds have elapsed, or the user refunded the payment for the stars used to pay for the suggested post.
* Added [starsTonAmount](/constructor/starsTonAmount.md) - Describes an amount of Gram in nanograms (i.e. `1/1_000_000_000` of a Gram).
* Added [messageActionGiftTon](/constructor/messageActionGiftTon.md) - You were gifted some Grams.
* Added [inputStickerSetTonGifts](/constructor/inputStickerSetTonGifts.md) - TON gifts stickerset.
##### Changed Constructors
* Added **paid_suggested_post_stars**, **paid_suggested_post_ton**, **suggested_post** parameters in [message](/constructor/message.md)
* Added **suggested_post** parameter in [draftMessage](/constructor/draftMessage.md)
* Added **manage_direct_messages** parameter in [chatAdminRights](/constructor/chatAdminRights.md)
* Added **posts_search**, **amount**, **ads_proceeds_from_date**, **ads_proceeds_to_date** parameters, removed **stars** parameter in [starsTransaction](/constructor/starsTransaction.md)
* Added **flags**, **top_hours_graph** parameters in [payments.starsRevenueStats](/constructor/payments.starsRevenueStats.md)
* Added **released_by** parameter in [starGift](/constructor/starGift.md)
* Added **chats**, **users** parameters in [payments.starGifts](/constructor/payments.starGifts.md)
* Added **released_by** parameter in [starGiftUnique](/constructor/starGiftUnique.md)
##### Deleted Constructors
* Removed stats.broadcastRevenueStats
* Removed stats.broadcastRevenueWithdrawalUrl
* Removed broadcastRevenueTransactionProceeds
* Removed broadcastRevenueTransactionWithdrawal
* Removed broadcastRevenueTransactionRefund
* Removed stats.broadcastRevenueTransactions
* Removed broadcastRevenueBalances
* Removed updateBroadcastRevenueTransactions
#### [Schema](/schema.md)
### [Layer 205](/schema?layer=205)
This layer introduces:
- [Sponsored messages to show on channel videos »](/api/sponsored-messages.md#getting-sponsored-video-advertisements)
- [To-do lists »](/api/todo.md)
- [Rename account.addNoPaidMessagesException to account.toggleNoPaidMessagesException, and add a `require_payment` flag to refund all Stars transferred to us by a peer with paid messages »](/method/account.toggleNoPaidMessagesException.md)
- Allow invoking [account.toggleNoPaidMessagesException](/method/account.toggleNoPaidMessagesException.md) for monoforum topics, and add a new [updateMonoForumNoPaidException](/constructor/updateMonoForumNoPaidException.md) to signal changes to [monoForumDialog](/constructor/monoForumDialog.md).`nopaid_messages_exception` to other admins and to other currently logged in sessions of the current monoforum admin.
#### [Schema](/schema.md) changes
##### New Methods
* Added [messages.toggleTodoCompleted](/method/messages.toggleTodoCompleted.md) - Mark one or more items of a [todo list »](/api/todo.md) as completed or not completed.
* Added [messages.appendTodoList](/method/messages.appendTodoList.md) - Appends one or more items to a [todo list »](/api/todo.md).
* Added [account.toggleNoPaidMessagesException](/method/account.toggleNoPaidMessagesException.md) - Allow a user to send us messages without paying if [paid messages »](/api/paid-messages.md) are enabled.
##### Changed Methods
* Added **flags**, **msg_id** parameters in [messages.getSponsoredMessages](/method/messages.getSponsoredMessages.md)
* Added **flags**, **parent_peer** parameters in [account.getPaidMessagesRevenue](/method/account.getPaidMessagesRevenue.md)
##### Deleted Methods
* Removed account.addNoPaidMessagesException
##### New Constructors
* Added [todoItem](/constructor/todoItem.md) - An item of a [todo list »](/api/todo.md).
* Added [todoList](/constructor/todoList.md) - Represents a [todo list »](/api/todo.md).
* Added [todoCompletion](/constructor/todoCompletion.md) - A completed [todo list »](/api/todo.md) item.
* Added [inputMediaTodo](/constructor/inputMediaTodo.md) - Creates a [todo list »](/api/todo.md).
* Added [messageMediaToDo](/constructor/messageMediaToDo.md) - Represents a [todo list »](/api/todo.md).
* Added [messageActionTodoCompletions](/constructor/messageActionTodoCompletions.md) - Items were marked as completed or not completed in a [todo list »](/api/todo.md).
* Added [messageActionTodoAppendTasks](/constructor/messageActionTodoAppendTasks.md) - Items were appended to the [todo list »](/api/todo.md).
* Added [updateMonoForumNoPaidException](/constructor/updateMonoForumNoPaidException.md) - An admin has (un)exempted this [monoforum topic »](/api/monoforum.md) from payment to send messages using [account.toggleNoPaidMessagesException](/method/account.toggleNoPaidMessagesException.md).
##### Changed Constructors
* Added **saved_peer_id** parameter in [messageService](/constructor/messageService.md)
* Added **send_paid_messages_stars** parameter in [channelFull](/constructor/channelFull.md)
* Added **min_display_duration**, **max_display_duration** parameters in [sponsoredMessage](/constructor/sponsoredMessage.md)
* Added **start_delay**, **between_delay** parameters in [messages.sponsoredMessages](/constructor/messages.sponsoredMessages.md)
* Added **nopaid_messages_exception** parameter in [monoForumDialog](/constructor/monoForumDialog.md)
#### PUSH notification changes
##### New PUSH notifications
* Added [CHANNEL_MESSAGE_TODO](/api/push-updates.md#channel-message-todo) - `{1} posted a checklist {2}`
* Added [CHANNEL_MESSAGE_TODO_APPEND](/api/push-updates.md#channel-message-todo-append) - `{1} added {2} tasks`
* Added [CHANNEL_MESSAGE_TODO_DONE](/api/push-updates.md#channel-message-todo-done) - `{1} toggled {2} tasks`
* Added [CHAT_MESSAGE_TODO](/api/push-updates.md#chat-message-todo) - `{1} sent a checklist {3} to the group {2}`
* Added [CHAT_MESSAGE_TODO_APPEND](/api/push-updates.md#chat-message-todo-append) - `{1} added {3} tasks in the group {2}`
* Added [CHAT_MESSAGE_TODO_DONE](/api/push-updates.md#chat-message-todo-done) - `{1} toggled {3} tasks in the group {2}`
* Added [CHAT_REACT_TODO](/api/push-updates.md#chat-react-todo) - `{1}: {3} to your checklist {4} in {2}`
* Added [MESSAGE_TODO](/api/push-updates.md#message-todo) - `{1} sent you a checklist {2}`
* Added [PINNED_TODO](/api/push-updates.md#pinned-todo) - `{1} pinned a checklist {2}`
* Added [REACT_TODO](/api/push-updates.md#react-todo) - `{1}: {2} to your checklist {3}`
#### [Schema](/schema.md)
### [Layer 204](/schema?layer=204)
This layer introduces:
- [Monoforums »](/api/monoforum.md)
- [Bot API monoforum IDs »](/api/bots/ids.md#monoforum-ids)
- [Tabbed forum UI »](/api/forum.md#tabbed-or-list-based-forum-ui)
- All flags added to [channel](/constructor/channel.md) (listed below) are valid `min` flags, meaning they must be applied over the locally stored version even if the `min` flag of the incoming [channel](/constructor/channel.md) is set.
#### [Schema](/schema.md) changes
##### New Methods
* Added [messages.getSavedDialogsByID](/method/messages.getSavedDialogsByID.md) - Obtain information about specific [saved message dialogs »](/api/saved-messages.md#saved-message-dialogs) or [monoforum topics »](/api/monoforum.md).
* Added [messages.readSavedHistory](/method/messages.readSavedHistory.md) - Mark messages as read in a [monoforum topic »](/api/monoforum.md).
* Added [channels.getMessageAuthor](/method/channels.getMessageAuthor.md) - Can only be invoked by non-bot admins of a [monoforum »](/api/monoforum.md), obtains the original sender of a message sent by other monoforum admins to the monoforum, on behalf of the channel associated to the monoforum.
##### Changed Methods
* Added **reply_to** parameter in [messages.forwardMessages](/method/messages.forwardMessages.md)
* Added **parent_peer** parameter in [messages.markDialogUnread](/method/messages.markDialogUnread.md)
* Added **flags**, **parent_peer** parameters in [messages.getDialogUnreadMarks](/method/messages.getDialogUnreadMarks.md)
* Added **saved_peer_id** parameter in [messages.unpinAllMessages](/method/messages.unpinAllMessages.md)
* Added **saved_peer_id** parameter in [messages.getUnreadReactions](/method/messages.getUnreadReactions.md)
* Added **saved_peer_id** parameter in [messages.readReactions](/method/messages.readReactions.md)
* Added **tabs** parameter in [channels.toggleForum](/method/channels.toggleForum.md)
* Added **parent_peer** parameter in [messages.getSavedDialogs](/method/messages.getSavedDialogs.md)
* Added **flags**, **parent_peer** parameters in [messages.getSavedHistory](/method/messages.getSavedHistory.md)
* Added **parent_peer** parameter in [messages.deleteSavedHistory](/method/messages.deleteSavedHistory.md)
* Added **flags**, **broadcast_messages_allowed** parameters in [channels.updatePaidMessagesPrice](/method/channels.updatePaidMessagesPrice.md)
##### New Constructors
* Added [inputReplyToMonoForum](/constructor/inputReplyToMonoForum.md) - Used to send messages to a [monoforum topic](/api/monoforum.md).
* Added [monoForumDialog](/constructor/monoForumDialog.md) - Represents a [monoforum topic »](/api/monoforum.md).
* Added [updateReadMonoForumInbox](/constructor/updateReadMonoForumInbox.md) - Incoming messages in a [monoforum topic](/api/monoforum.md) were read
* Added [updateReadMonoForumOutbox](/constructor/updateReadMonoForumOutbox.md) - Outgoing messages in a [monoforum](/api/monoforum.md) were read.
##### Changed Constructors
* Added **broadcast_messages_allowed**, **monoforum**, **forum_tabs**, **linked_monoforum_id** parameters in [channel](/constructor/channel.md)
* Added **saved_peer_id** parameter in [updateDraftMessage](/constructor/updateDraftMessage.md)
* Added **saved_peer_id** parameter in [updateChannelReadMessagesContents](/constructor/updateChannelReadMessagesContents.md)
* Added **saved_peer_id** parameter in [updateDialogUnreadMark](/constructor/updateDialogUnreadMark.md)
* Added **saved_peer_id** parameter in [updateMessageReactions](/constructor/updateMessageReactions.md)
* Added **monoforum_peer_id** parameter in [inputReplyToMessage](/constructor/inputReplyToMessage.md)
* Added **flags**, **broadcast_messages_allowed** parameters in [messageActionPaidMessagesPrice](/constructor/messageActionPaidMessagesPrice.md)
#### [Schema](/schema.md)
### [Layer 203](/schema?layer=203)
This layer introduces:
- [Methods to resell collectible gifts »](/api/gifts.md#reselling-collectible-gifts)
- [Autotranslation for all users of a channel »](/api/translation.md#autotranslation-for-channels)
- [stories.canSendStory now returns the number of available active story slots »](/method/stories.canSendStory.md)
- [Collectible gift links »](/api/links.md#collectible-gift-link)
- [Custom suggestions »](/api/config.md#custom-suggestions)
- [All suggestion fields were moved from the client configuration object to help.getPromoData »](/api/config.md#suggestions)
- All flags added to [channel](/constructor/channel.md) (listed below) are valid `min` flags, meaning they must be applied over the locally stored version even if the `min` flag of the incoming [channel](/constructor/channel.md) is set.
#### [Schema](/schema.md) changes
##### New Methods
* Added [payments.getResaleStarGifts](/method/payments.getResaleStarGifts.md) - Get [collectible gifts](/api/gifts.md#collectible-gifts) of a specific type currently on resale, see [here »](/api/gifts.md#reselling-collectible-gifts) for more info.
* Added [payments.updateStarGiftPrice](/method/payments.updateStarGiftPrice.md) - A [collectible gift we own »](/api/gifts.md#collectible-gifts) can be put up for sale on the [gift marketplace »](https://telegram.org/blog/gift-marketplace-and-more) with this method, see [here »](/api/gifts.md#reselling-collectible-gifts) for more info.
* Added [channels.toggleAutotranslation](/method/channels.toggleAutotranslation.md) - Toggle autotranslation in a channel, for all users: see [here »](/api/translation.md#autotranslation-for-channels) for more info.
##### Changed Methods
* Changed type of [stories.canSendStory](/method/stories.canSendStory.md) from **Bool** to **stories.CanSendStoryCount**
##### New Constructors
* Added [inputSavedStarGiftSlug](/constructor/inputSavedStarGiftSlug.md) - Points to a [collectible gift obtained from a collectible gift link »](/api/links.md#collectible-gift-link).
* Added [starGiftAttributeIdModel](/constructor/starGiftAttributeIdModel.md) - The ID of a model of a [collectible gift »](/api/gifts.md#collectible-gifts).
* Added [starGiftAttributeIdPattern](/constructor/starGiftAttributeIdPattern.md) - The ID of a pattern of a [collectible gift »](/api/gifts.md#collectible-gifts).
* Added [starGiftAttributeIdBackdrop](/constructor/starGiftAttributeIdBackdrop.md) - The ID of a backdrop of a [collectible gift »](/api/gifts.md#collectible-gifts).
* Added [starGiftAttributeCounter](/constructor/starGiftAttributeCounter.md) - Indicates the total number of gifts that have the specified attribute.
* Added [payments.resaleStarGifts](/constructor/payments.resaleStarGifts.md) - List of gifts currently on [resale »](/api/gifts.md#reselling-collectible-gifts).
* Added [inputInvoiceStarGiftResale](/constructor/inputInvoiceStarGiftResale.md) - Used to buy a [collectible gift](/api/gifts.md#collectible-gifts) currently up on resale, see [here](/api/gifts.md#reselling-collectible-gifts) for more info on the full flow.
* Added [channelAdminLogEventActionToggleAutotranslation](/constructor/channelAdminLogEventActionToggleAutotranslation.md) - [Channel autotranslation was toggled »](/api/translation.md#autotranslation-for-channels).
* Added [stories.canSendStoryCount](/constructor/stories.canSendStoryCount.md) - Contains the number of available active story slots (equal to the value of the [`story_expiring_limit_*` client configuration parameter](/api/config.md#story-expiring-limit-default) minus the number of currently active stories).
* Added [pendingSuggestion](/constructor/pendingSuggestion.md) - Represents a [custom pending suggestion »](/api/config.md#custom-suggestions).
##### Changed Constructors
* Added **autotranslation** parameter in [channel](/constructor/channel.md)
* Added **pending_suggestions**, **dismissed_suggestions**, **custom_pending_suggestion** parameters, changed type of **peer** from **Peer** to **flags.3?Peer** in [help.promoData](/constructor/help.promoData.md)
* Added **availability_resale**, **resell_min_stars**, **title** parameters in [starGift](/constructor/starGift.md)
* Added **backdrop_id** parameter in [starGiftAttributeBackdrop](/constructor/starGiftAttributeBackdrop.md)
* Added **resell_stars** parameter in [starGiftUnique](/constructor/starGiftUnique.md)
* Added **resale_stars**, **can_transfer_at**, **can_resell_at** parameters in [messageActionStarGiftUnique](/constructor/messageActionStarGiftUnique.md)
* Added **can_transfer_at**, **can_resell_at** parameters in [savedStarGift](/constructor/savedStarGift.md)
#### [Schema](/schema.md)
### [Layer 202](/schema?layer=202)
This layer introduces:
- [End-to-end group calls »](/api/end-to-end/group-calls.md)
- [Conference deep links »](/api/links.md#conference-links)
- [Service messages for paid message refunds »](/constructor/messageActionPaidMessagesRefunded.md)
- [Service messages for paid message price changes »](/constructor/messageActionPaidMessagesPrice.md)
- Gift privacy settings:
- [globalPrivacySettings](/constructor/globalPrivacySettings.md).`disallowed_gifts`/[userFull](/constructor/userFull.md).`disallowed_gifts`: [Disallow the reception of specific gift types »](/constructor/disallowedGiftsSettings.md)
- [globalPrivacySettings](/constructor/globalPrivacySettings.md).`display_gifts_button`/[userFull](/constructor/userFull.md).`display_gifts_button`: show or hide the gift button in the text field of private chats.
- [Transferring stars from a business account to the business bot » ](/api/stars.md#transferring-stars-from-a-business-account-to-the-business-bot)
- [Sponsored peer search results »](/api/sponsored-messages.md#getting-sponsored-search-results)
- [Business bot rights »](/constructor/businessBotRights.md)
- [Sponsored message methods now don't require specification of the `peer` where the sponsored message is visible »](/api/sponsored-messages.md)
- [Renamed the method used by official apps to check whether an in-store purchase is possible »](/method/payments.canPurchaseStore.md)
- [Paid auth codes for official apps](/constructor/auth.sentCodePaymentRequired.md)
#### [Schema](/schema.md) changes
##### New Methods
* Added [payments.canPurchaseStore](/method/payments.canPurchaseStore.md) - Checks whether a purchase is possible. Must be called before in-store purchase, official apps only.
* Added [contacts.getSponsoredPeers](/method/contacts.getSponsoredPeers.md) - Obtain a list of sponsored peer search results for a given query
* Added [phone.deleteConferenceCallParticipants](/method/phone.deleteConferenceCallParticipants.md) - Remove participants from a [conference call »](/api/end-to-end/group-calls.md#removing-a-participant).
* Added [phone.sendConferenceCallBroadcast](/method/phone.sendConferenceCallBroadcast.md) - Submit a verification message to conference call subchain `1`, see [subchains »](/api/end-to-end/group-calls.md#subchains).
* Added [phone.inviteConferenceCallParticipant](/method/phone.inviteConferenceCallParticipant.md) - Invite a user to a [conference call](/api/group-calls.md#conference-calls).
* Added [phone.declineConferenceCallInvite](/method/phone.declineConferenceCallInvite.md) - Decline a [conference call](/api/group-calls.md#conference-calls) invite.
* Added [phone.getGroupCallChainBlocks](/method/phone.getGroupCallChainBlocks.md) - Fetch blocks from a conference call [subchain »](/api/end-to-end/group-calls.md#subchains); handle the returned [updateGroupCallChainBlocks](/constructor/updateGroupCallChainBlocks.md) as [specified here »](/api/end-to-end/group-calls.md#handling-updates).
##### Changed Methods
* Removed **conference_call** parameter in [phone.requestCall](/method/phone.requestCall.md)
* Added **public_key**, **block** parameters, removed **key_fingerprint** parameter in [phone.joinGroupCall](/method/phone.joinGroupCall.md)
* Added **rights** parameter, removed **can_reply** parameter in [account.updateConnectedBot](/method/account.updateConnectedBot.md)
* Removed **peer** parameter in [messages.viewSponsoredMessage](/method/messages.viewSponsoredMessage.md)
* Removed **peer** parameter in [messages.clickSponsoredMessage](/method/messages.clickSponsoredMessage.md)
* Removed **peer** parameter in [messages.reportSponsoredMessage](/method/messages.reportSponsoredMessage.md)
* Changed type of [phone.createConferenceCall](/method/phone.createConferenceCall.md) from **phone.PhoneCall** to **Updates**
* Added **flags**, **muted**, **video_stopped**, **join**, **random_id**, **public_key**, **block**, **params** parameters, removed **peer**, **key_fingerprint** parameters in [phone.createConferenceCall](/method/phone.createConferenceCall.md)
##### Deleted Methods
* Removed payments.canPurchasePremium
##### New Constructors
* Added [auth.sentCodePaymentRequired](/constructor/auth.sentCodePaymentRequired.md) - Official apps may receive this constructor, indicating that due to the high cost of SMS verification codes for the user's country/provider, the user must purchase a [Telegram Premium](/api/premium.md) subscription in order to proceed with the login/signup, see [here »](/api/auth.md#paid-auth) for more info.
* Added [inputStorePaymentAuthCode](/constructor/inputStorePaymentAuthCode.md) - Indicates payment for a login code.
* Added [updateSentPhoneCode](/constructor/updateSentPhoneCode.md) - A paid login SMS code was successfully sent.
* Added [businessBotRights](/constructor/businessBotRights.md) - [Business bot rights](/api/bots/connected-business-bots.md).
* Added [messageActionPaidMessagesRefunded](/constructor/messageActionPaidMessagesRefunded.md) - Sent from peer A to B, indicates that A refunded all [stars](/api/stars.md) B previously paid to send messages to A, see [here »](/api/paid-messages.md) for more info on paid messages.
* Added [messageActionPaidMessagesPrice](/constructor/messageActionPaidMessagesPrice.md) - The price of [paid messages »](/api/paid-messages.md) in this chat was changed.
* Added [disallowedGiftsSettings](/constructor/disallowedGiftsSettings.md) - Disallow the reception of specific [gift](/api/gifts.md) types.
* Added [sponsoredPeer](/constructor/sponsoredPeer.md) - A sponsored peer.
* Added [contacts.sponsoredPeersEmpty](/constructor/contacts.sponsoredPeersEmpty.md) - There are no sponsored peers for this query.
* Added [contacts.sponsoredPeers](/constructor/contacts.sponsoredPeers.md) - Sponsored peers.
* Added [inputInvoiceBusinessBotTransferStars](/constructor/inputInvoiceBusinessBotTransferStars.md) - Transfer stars from the balance of a user account [connected to a business bot](/api/bots/connected-business-bots.md), to the balance of the [business bot](/api/bots/connected-business-bots.md), see [here »](/api/stars.md#transferring-stars-from-a-business-account-to-the-business-bot) for more info on the full flow.
* Added [inputGroupCallSlug](/constructor/inputGroupCallSlug.md) - Identify a [conference call »](/api/group-calls.md#conference-calls) using the slug from its invitation link.
* Added [inputGroupCallInviteMessage](/constructor/inputGroupCallInviteMessage.md) - Identifies a [conference call »](/api/group-calls.md#conference-calls) using its [messageActionConferenceCall](/constructor/messageActionConferenceCall.md) invitation service message.
* Added [updateGroupCallChainBlocks](/constructor/updateGroupCallChainBlocks.md) - Contains conference call blockchain blocks, see [handling E2E group call updates »](/api/end-to-end/group-calls.md#handling-updates).
* Added [messageActionConferenceCall](/constructor/messageActionConferenceCall.md) - Represents a [conference call »](/api/group-calls.md#conference-calls), or an invitation to one if neither the `missed` nor `active` flags are set.
* Added [phoneCallDiscardReasonMigrateConferenceCall](/constructor/phoneCallDiscardReasonMigrateConferenceCall.md) - This phone call was migrated to a [conference call](/api/end-to-end/group-calls.md).
##### Changed Constructors
* Added **display_gifts_button**, **disallowed_gifts** parameters in [userFull](/constructor/userFull.md)
* Removed **conference_call** parameter in [phoneCallWaiting](/constructor/phoneCallWaiting.md)
* Removed **conference_call** parameter in [phoneCallRequested](/constructor/phoneCallRequested.md)
* Removed **conference_call** parameter in [phoneCallAccepted](/constructor/phoneCallAccepted.md)
* Added **conference_supported** parameter, removed **conference_call** parameter in [phoneCall](/constructor/phoneCall.md)
* Removed **conference_call** parameter in [phoneCallDiscarded](/constructor/phoneCallDiscarded.md)
* Added **display_gifts_button**, **disallowed_gifts** parameters in [globalPrivacySettings](/constructor/globalPrivacySettings.md)
* Added **conference**, **creator**, **invite_link** parameters, removed **conference_from_call** parameter in [groupCall](/constructor/groupCall.md)
* Added **rights** parameter, removed **can_reply** parameter in [connectedBot](/constructor/connectedBot.md)
* Added **rights** parameter, removed **can_reply** parameter in [botBusinessConnection](/constructor/botBusinessConnection.md)
#### PUSH notification changes
##### New PUSH notifications
* Added [CONF_CALL_MISSED](/api/push-updates.md#conf-call-missed) - `You missed a call from {1}`
#### [Schema](/schema.md)
### [Layer 200](/schema?layer=200)
This layer introduces:
- [Detailed account information for new private chats »](/api/action-bar.md#account-information)
- [Paid messages »](/api/paid-messages.md)
- [Pinning a specific received gift to the profile »](/api/gifts.md#pinning-a-received-gift)
- [Sending paid reactions as a channel »](/api/reactions.md#paid-reaction-privacy)
- [Added a `paid_messages_available` flag to channelFull, indicating whether paid messages can be enabled in this supergroup](/constructor/channelFull.md)
- [Gift a Telegram Premium subscription, paying with Telegram Stars »](/api/premium.md#gifting-telegram-premium)
This change also simplifies the Telegram Premium gift flow, fully replacing the [userFull](/constructor/userFull.md).`premium_gifts` flag with [payments.getPremiumGiftCodeOptions](/method/payments.getPremiumGiftCodeOptions.md).
- [Blockchain addresses for collectible gifts moved to the TON blockchain as NFTs »](/api/gifts.md#withdraw-a-collectible-gift-to-the-ton-blockchain)
- All flags added to [channel](/constructor/channel.md) (listed below) are valid `min` flags, meaning they must be applied over the locally stored version even if the `min` flag of the incoming [channel](/constructor/channel.md) is set.
- All flags added to [user](/constructor/user.md) (listed below) are valid `min` flags, meaning they must be applied over the locally stored version even if the `min` flag of the incoming [user](/constructor/user.md) is set.
#### [Schema](/schema.md) changes
##### New Methods
* Added [invokeWithReCaptcha](/method/invokeWithReCaptcha.md) - Official clients only: re-execute a method call that required reCAPTCHA verification via a `RECAPTCHA_CHECK_%s__%s`, where the first placeholder is the `action`, and the second one is the reCAPTCHA key ID.
* Added [account.addNoPaidMessagesException](/method/account.addNoPaidMessagesException.md)
* Added [account.getPaidMessagesRevenue](/method/account.getPaidMessagesRevenue.md) - Get the number of stars we have received from the specified user thanks to [paid messages »](/api/paid-messages.md); the received amount will be equal to the sent amount multiplied by [stars\_paid\_message\_commission\_permille](/api/config.md#stars-paid-message-commission-permille) divided by 1000.
* Added [channels.updatePaidMessagesPrice](/method/channels.updatePaidMessagesPrice.md) - Enable or disable [paid messages »](/api/paid-messages.md) in this [supergroup](/api/channel.md) or [monoforum](/api/monoforum.md).
* Added [users.getRequirementsToContact](/method/users.getRequirementsToContact.md) - Check whether we can write to the specified users, used to implement bulk checks for [Premium-only messages »](/api/privacy.md#require-premium-for-new-non-contact-users) and [paid messages »](/api/paid-messages.md).
* Added [payments.toggleStarGiftsPinnedToTop](/method/payments.toggleStarGiftsPinnedToTop.md) - Pins a received gift on top of the profile of the user or owned channels by using [payments.toggleStarGiftsPinnedToTop](/method/payments.toggleStarGiftsPinnedToTop.md).
##### Changed Methods
* Added **allow_paid_stars** parameter in [messages.sendMessage](/method/messages.sendMessage.md)
* Added **allow_paid_stars** parameter in [messages.sendMedia](/method/messages.sendMedia.md)
* Added **allow_paid_stars** parameter in [messages.forwardMessages](/method/messages.forwardMessages.md)
* Added **allow_paid_stars** parameter in [messages.sendInlineBotResult](/method/messages.sendInlineBotResult.md)
* Added **allow_paid_stars** parameter in [messages.sendMultiMedia](/method/messages.sendMultiMedia.md)
* Added **flags**, **for_paid_reactions** parameters in [channels.getSendAs](/method/channels.getSendAs.md)
* Changed type of **private** from **flags.0?Bool** to **flags.0?PaidReactionPrivacy** in [messages.sendPaidReaction](/method/messages.sendPaidReaction.md)
* Changed type of **private** from **Bool** to **PaidReactionPrivacy** in [messages.togglePaidReactionPrivacy](/method/messages.togglePaidReactionPrivacy.md)
##### Deleted Methods
* Removed users.getIsPremiumRequiredToContact
##### New Constructors
* Added [paidReactionPrivacyDefault](/constructor/paidReactionPrivacyDefault.md) - Uses the default reaction privacy, set using [messages.togglePaidReactionPrivacy](/method/messages.togglePaidReactionPrivacy.md).
* Added [paidReactionPrivacyAnonymous](/constructor/paidReactionPrivacyAnonymous.md) - Send paid reactions anonymously.
* Added [paidReactionPrivacyPeer](/constructor/paidReactionPrivacyPeer.md) - Send paid reactions as the specified peer, fetched using [channels.getSendAs](/method/channels.getSendAs.md) with the `for_paid_reactions` flag set.
* Added [inputPrivacyKeyNoPaidMessages](/constructor/inputPrivacyKeyNoPaidMessages.md) - Who can send you messages without paying, if [paid messages »](/api/paid-messages.md) are enabled.
* Added [privacyKeyNoPaidMessages](/constructor/privacyKeyNoPaidMessages.md) - Who can send you messages without paying, if [paid messages »](/api/paid-messages.md) are enabled.
* Added [account.paidMessagesRevenue](/constructor/account.paidMessagesRevenue.md) - Total number of non-refunded [Telegram Stars](/api/stars.md) a user has spent on sending us messages either directly or through a channel, see [here »](/api/paid-messages.md) for more info on paid messages.
* Added [requirementToContactEmpty](/constructor/requirementToContactEmpty.md) - This user can be freely contacted.
* Added [requirementToContactPremium](/constructor/requirementToContactPremium.md) - This user requires us to buy a [Premium](/api/premium.md) subscription in order to contact them.
* Added [requirementToContactPaidMessages](/constructor/requirementToContactPaidMessages.md) - This user requires us to pay the specified amount of [Telegram Stars](/api/stars.md) to send them a message, see [here »](/api/paid-messages.md) for the full flow.
* Added [inputInvoicePremiumGiftStars](/constructor/inputInvoicePremiumGiftStars.md) - Used to gift a [Telegram Premium](/api/premium.md) subscription to another user, paying with [Telegram Stars](/api/stars.md).
##### Changed Constructors
* Added **paid_message_stars** parameter in [message](/constructor/message.md)
* Added **charge_paid_message_stars**, **registration_month**, **phone_country**, **name_change_date**, **photo_change_date** parameters in [peerSettings](/constructor/peerSettings.md)
* Added **send_paid_messages_stars** parameter, removed **premium_gifts** parameter in [userFull](/constructor/userFull.md)
* Added **send_paid_messages_stars** parameter in [user](/constructor/user.md)
* Added **send_paid_messages_stars** parameter in [channel](/constructor/channel.md)
* Added **paid_messages_available** parameter in [channelFull](/constructor/channelFull.md)
* Added **noncontact_peers_paid_stars** parameter in [globalPrivacySettings](/constructor/globalPrivacySettings.md)
* Added **business_transfer**, **stargift_resale**, **paid_messages**, **premium_gift_months** parameters in [starsTransaction](/constructor/starsTransaction.md)
* Changed type of **private** from **Bool** to **PaidReactionPrivacy** in [updatePaidReactionPrivacy](/constructor/updatePaidReactionPrivacy.md)
* Added **gift_address** parameter in [starGiftUnique](/constructor/starGiftUnique.md)
##### Deleted Constructors
* Removed premiumGiftOption
#### [Schema](/schema.md)
### [Layer 198](/schema?layer=198)
This layer introduces:
- [Collectibles as emoji statuses (and minor tweaks to the emoji status API) »](/api/emoji-status.md#collectibles-as-emoji-statuses)
- Send gifts to channels
- [Notifications for gifts received by channels »](/api/gifts.md#notifications-for-received-channel-gifts)
- [Get all gifts received by a peer »](/api/gifts.md#list-all-received-gifts)
- [Fetch info about specific gifts owned by a peer we control »](/api/gifts.md#list-specific-owned-gifts)
- [Withdraw a collectible gift to the TON blockchain »](/api/gifts.md#withdraw-a-collectible-gift-to-the-ton-blockchain)
- [Custom video covers »](/api/files.md#video-covers)
- [Custom starting timestamps for videos »](/api/files.md#start-video-at-timestamp)
#### [Schema](/schema.md) changes
##### New Methods
* Added [account.getCollectibleEmojiStatuses](/method/account.getCollectibleEmojiStatuses.md) - Obtain a list of [emoji statuses »](/api/emoji-status.md) for owned or [hosted collectible gifts »](/api/gifts.md#hosted-collectible-gifts).
* Added [payments.getSavedStarGifts](/method/payments.getSavedStarGifts.md) - Fetch the full list of [gifts »](/api/gifts.md#list-all-received-gifts) owned, received or [hosted »](/api/gifts.md#hosted-collectible-gifts) by a peer.
* Added [payments.getSavedStarGift](/method/payments.getSavedStarGift.md) - Fetch info about specific [gifts](/api/gifts.md) owned by a peer we control.
* Added [payments.getStarGiftWithdrawalUrl](/method/payments.getStarGiftWithdrawalUrl.md) - Convert a [collectible gift »](/api/gifts.md) to an NFT on the TON blockchain.
* Added [payments.toggleChatStarGiftNotifications](/method/payments.toggleChatStarGiftNotifications.md) - Enables or disables the reception of notifications every time a [gift »](/api/gifts.md) is received by the specified channel, can only be invoked by admins with `post_messages` [admin rights](/constructor/chatAdminRights.md).
##### Changed Methods
* Added **video_timestamp** parameter in [messages.forwardMessages](/method/messages.forwardMessages.md)
* Added **stargift** parameter, removed **msg_id** parameter in [payments.saveStarGift](/method/payments.saveStarGift.md)
* Added **stargift** parameter, removed **msg_id** parameter in [payments.convertStarGift](/method/payments.convertStarGift.md)
* Added **stargift** parameter, removed **msg_id** parameter in [payments.upgradeStarGift](/method/payments.upgradeStarGift.md)
* Added **stargift** parameter, removed **msg_id** parameter, changed type of **to_id** from **InputUser** to **InputPeer** in [payments.transferStarGift](/method/payments.transferStarGift.md)
##### Deleted Methods
* Removed payments.getUserStarGifts
* Removed payments.getUserStarGift
##### New Constructors
* Added [emojiStatusCollectible](/constructor/emojiStatusCollectible.md) - An owned or [hosted collectible gift »](/api/gifts.md#hosted-collectible-gifts) as emoji status.
* Added [inputEmojiStatusCollectible](/constructor/inputEmojiStatusCollectible.md) - An owned or [hosted collectible gift »](/api/gifts.md#hosted-collectible-gifts) as emoji status: can only be used in [account.updateEmojiStatus](/method/account.updateEmojiStatus.md), is never returned by the API.
* Added [savedStarGift](/constructor/savedStarGift.md) - Represents a [gift](/api/gifts.md) owned by a peer.
* Added [payments.savedStarGifts](/constructor/payments.savedStarGifts.md) - Represents a list of [gifts](/api/gifts.md).
* Added [inputSavedStarGiftUser](/constructor/inputSavedStarGiftUser.md) - A gift received in a private chat with another user.
* Added [inputSavedStarGiftChat](/constructor/inputSavedStarGiftChat.md) - A gift received by a channel we own.
* Added [payments.starGiftWithdrawalUrl](/constructor/payments.starGiftWithdrawalUrl.md) - A URL that can be used to import the exported NFT on Fragment.
##### Changed Constructors
* Added **video_cover**, **video_timestamp** parameters in [inputMediaUploadedDocument](/constructor/inputMediaUploadedDocument.md)
* Added **video_cover**, **video_timestamp** parameters in [inputMediaDocument](/constructor/inputMediaDocument.md)
* Added **video_cover**, **video_timestamp** parameters in [messageMediaDocument](/constructor/messageMediaDocument.md)
* Added **stargifts_available**, **stargifts_count** parameters in [channelFull](/constructor/channelFull.md)
* Added **video_cover**, **video_timestamp** parameters in [inputMediaDocumentExternal](/constructor/inputMediaDocumentExternal.md)
* Added **flags**, **until** parameters in [emojiStatus](/constructor/emojiStatus.md)
* Added **peer** parameter, removed **user_id** parameter in [inputInvoiceStarGift](/constructor/inputInvoiceStarGift.md)
* Added **from_id**, **peer**, **saved_id** parameters in [messageActionStarGift](/constructor/messageActionStarGift.md)
* Changed type of **sender_id** from **flags.0?long** to **flags.0?Peer**, **recipient_id** from **long** to **Peer** in [starGiftAttributeOriginalDetails](/constructor/starGiftAttributeOriginalDetails.md)
* Added **owner_address** parameter, changed type of **owner_id** from **flags.0?long** to **flags.0?Peer** in [starGiftUnique](/constructor/starGiftUnique.md)
* Added **from_id**, **peer**, **saved_id** parameters in [messageActionStarGiftUnique](/constructor/messageActionStarGiftUnique.md)
* Added **stargift** parameter, removed **msg_id** parameter in [inputInvoiceStarGiftUpgrade](/constructor/inputInvoiceStarGiftUpgrade.md)
* Added **stargift** parameter, removed **msg_id** parameter, changed type of **to_id** from **InputUser** to **InputPeer** in [inputInvoiceStarGiftTransfer](/constructor/inputInvoiceStarGiftTransfer.md)
##### Deleted Constructors
* Removed emojiStatusUntil
* Removed userStarGift
* Removed payments.userStarGifts
#### [Schema](/schema.md)
### [Layer 197](/schema?layer=197)
This layer introduces:
- [Collectible gift links »](/api/links.md#collectible-gift-link)
- [Collectible gift story media areas »](/api/stories.md#collectible-gifts)
- [Collectible webpage previews »](/constructor/webPageAttributeUniqueStarGift.md)
- [Similar bot recommendations »](/api/recommend.md#similar-bots)
#### [Schema](/schema.md) changes
##### New Methods
* Added [bots.getBotRecommendations](/method/bots.getBotRecommendations.md) - Obtain a list of similarly themed bots, selected based on similarities in their subscriber bases, see [here »](/api/recommend.md) for more info.
* Added [payments.getUniqueStarGift](/method/payments.getUniqueStarGift.md) - Obtain info about a [collectible gift »](/api/gifts.md#collectible-gifts) using a slug obtained from a [collectible gift link »](/api/links.md#collectible-gift-link).
##### Changed Methods
* Changed type of [messages.getWebPagePreview](/method/messages.getWebPagePreview.md) from **MessageMedia** to **messages.WebPagePreview**
##### New Constructors
* Added [users.users](/constructor/users.users.md) - Describes a list of users (or bots).
* Added [users.usersSlice](/constructor/users.usersSlice.md) - Describes a partial list of users.
* Added [payments.uniqueStarGift](/constructor/payments.uniqueStarGift.md) - Represents a [collectible gift »](/api/gifts.md#collectible-gifts).
* Added [webPageAttributeUniqueStarGift](/constructor/webPageAttributeUniqueStarGift.md) - Contains info about [collectible gift »](/api/gifts.md#collectible-gifts) for a [webPage](/constructor/webPage.md) preview of a [collectible gift »](/api/gifts.md#collectible-gifts) (the [webPage](/constructor/webPage.md) will have a `type` of `telegram_nft`).
* Added [mediaAreaStarGift](/constructor/mediaAreaStarGift.md) - Represents a [collectible gift »](/api/gifts.md#collectible-gifts).
* Added [messages.webPagePreview](/constructor/messages.webPagePreview.md) - Represents a webpage preview.
##### Changed Constructors
* Added **flags**, **slug**, **owner_name** parameters, changed type of **owner_id** from **long** to **flags.0?long** in [starGiftUnique](/constructor/starGiftUnique.md)
#### [Schema](/schema.md)
### [Layer 196](/schema?layer=196)
This layer introduces:
- [Extra secure group calls »](https://telegram.org/blog/group-calls-made-easy)
- [Explicit delivery acknowledgement for Telegram Gateway verification messages »](/method/messages.reportMessagesDelivery.md).
- [Third-party verification »](/api/bots/verification.md)
- [Reactions for service messages »](/api/reactions.md)
- [Collectible gifts »](/api/gifts.md#collectible-gifts)
- Add support for entities in folder titles, and a new `title_noanimate` flag to optionally freeze animated emoji entities in the title.
- All flags added to [channel](/constructor/channel.md) (listed below) are valid `min` flags, meaning they must be applied over the locally stored version even if the `min` flag of the incoming [channel](/constructor/channel.md) is set.
- All flags added to [user](/constructor/user.md) (listed below) are valid `min` flags, meaning they must be applied over the locally stored version even if the `min` flag of the incoming [user](/constructor/user.md) is set.
#### PUSH notification changes
##### New PUSH notifications
* Added [MESSAGE_STARGIFT_UPGRADE](/api/push-updates.md#message-stargift-upgrade) - `{1} upgraded your Gift`
* Added [MESSAGE_UNIQUE_STARGIFT](/api/push-updates.md#message-unique-stargift) - `{1} transferred you a Gift!`