Layers

Below you will find information on scheme changes. For more details on the use of layers, see Invoking API methods.

Layer 133

Scheme changes

New Methods

Added messages.getMessageReadParticipants - Get which users read a specific message

Changed Methods

Changed type of id from int to long in auth.importAuthorization
Changed type of other_uids from Vector<int> to Vector<long> in account.registerDevice
Changed type of other_uids from Vector<int> to Vector<long> in account.unregisterDevice
Changed type of hash from int to long in account.getWallPapers
Changed type of hash from int to long in contacts.getContactIDs
Changed type of hash from int to long in contacts.getContacts
Changed type of hash from int to long in messages.getDialogs
Changed type of hash from int to long in messages.getHistory
Changed type of hash from int to long in messages.search
Changed type of id from Vector<int> to Vector<long> in messages.getChats
Changed type of chat_id from int to long in messages.getFullChat
Changed type of chat_id from int to long in messages.editChatTitle
Changed type of chat_id from int to long in messages.editChatPhoto
Changed type of chat_id from int to long in messages.addChatUser
Changed type of chat_id from int to long in messages.deleteChatUser
Changed type of hash from int to long in messages.getStickers
Changed type of hash from int to long in messages.getAllStickers
Changed type of hash from int to long in channels.getParticipants
Changed type of chat_id from int to long in messages.editChatAdmin
Changed type of chat_id from int to long in messages.migrateChat
Changed type of hash from int to long in messages.getSavedGifs
Changed type of hash from int to long in contacts.getTopPeers
Changed type of hash from int to long in messages.getFeaturedStickers
Changed type of hash from int to long in messages.getRecentStickers
Changed type of hash from int to long in messages.getMaskStickers
Changed type of max_id from int to long in messages.getCommonChats
Changed type of except_ids from Vector<int> to Vector<long> in messages.getAllChats
Changed type of hash from int to long in messages.getFavedStickers
Changed type of hash from int to long in messages.getRecentLocations
Changed type of hash from int to long in messages.searchStickerSets
Changed type of bot_id from int to long in account.getAuthorizationForm
Changed type of bot_id from int to long in account.acceptAuthorization
Changed type of hash from int to long in messages.getScheduledHistory
Changed type of hash from int to long in account.getThemes
Changed type of except_ids from Vector<int> to Vector<long> in auth.exportLoginToken
Changed type of hash from int to long in messages.getOldFeaturedStickers
Changed type of hash from int to long in messages.getReplies
Changed type of chat_id from int to long in messages.deleteChat

New Constructors

Added inputBotInlineMessageID64 - Represents a sent inline message from the perspective of a bot

Changed Constructors

Changed type of chat_id from int to long in inputPeerChat
Changed type of user_id from int to long in peerUser
Changed type of chat_id from int to long in peerChat
Changed type of id from int to long in userEmpty
Changed type of id from int to long in chatEmpty
Changed type of id from int to long in chat
Changed type of id from int to long in chatForbidden
Changed type of id from int to long in chatFull
Changed type of user_id from int to long, inviter_id from int to long in chatParticipant
Changed type of chat_id from int to long in chatParticipantsForbidden
Changed type of chat_id from int to long in chatParticipants
Changed type of via_bot_id from flags.11?int to flags.11?long in message
Changed type of user_id from int to long in messageMediaContact
Changed type of users from Vector<int> to Vector<long> in messageActionChatCreate
Changed type of users from Vector<int> to Vector<long> in messageActionChatAddUser
Changed type of user_id from int to long in messageActionChatDeleteUser
Changed type of id from int to long in auth.exportedAuthorization
Changed type of user_id from int to long in contact
Changed type of user_id from int to long in importedContact
Changed type of user_id from int to long in contactStatus
Changed type of user_id from int to long in updateUserTyping
Changed type of chat_id from int to long in updateChatUserTyping
Changed type of user_id from int to long in updateUserStatus
Changed type of user_id from int to long in updateUserName
Changed type of user_id from int to long in updateUserPhoto
Changed type of user_id from int to long, via_bot_id from flags.11?int to flags.11?long in updateShortMessage
Changed type of from_id from int to long, chat_id from int to long, via_bot_id from flags.11?int to flags.11?long in updateShortChatMessage
Changed type of admin_id from int to long, participant_id from int to long in encryptedChatWaiting
Changed type of admin_id from int to long, participant_id from int to long in encryptedChatRequested
Changed type of admin_id from int to long, participant_id from int to long in encryptedChat
Changed type of chat_id from int to long, user_id from int to long, inviter_id from int to long in updateChatParticipantAdd
Changed type of chat_id from int to long, user_id from int to long in updateChatParticipantDelete
Changed type of users from Vector<int> to Vector<long> in privacyValueAllowUsers
Changed type of users from Vector<int> to Vector<long> in privacyValueDisallowUsers
Changed type of user_id from int to long in updateUserPhone
Changed type of hash from int to long in messages.stickers
Changed type of hash from int to long in messages.allStickers
Changed type of admin_id from int to long in chatInviteExported
Changed type of inviter_id from int to long in messageActionChatJoinedByLink
Changed type of id from int to long in user
Changed type of user_id from int to long in botInfo
Changed type of user_id from int to long in inputPeerUser
Changed type of user_id from int to long in inputUser
Changed type of channel_id from int to long in inputChannel
Changed type of channel_id from int to long in peerChannel
Changed type of channel_id from int to long in inputPeerChannel
Removed version parameter, changed type of id from int to long in channel
Changed type of id from int to long in channelForbidden
Changed type of id from int to long, migrated_from_chat_id from flags.4?int to flags.4?long, linked_chat_id from flags.14?int to flags.14?long in channelFull
Changed type of channel_id from int to long in updateChannelTooLong
Changed type of channel_id from int to long in updateChannel
Changed type of channel_id from int to long in updateReadChannelInbox
Changed type of channel_id from int to long in updateDeleteChannelMessages
Changed type of channel_id from int to long in updateChannelMessageViews
Changed type of user_id from int to long in channelParticipant
Changed type of user_id from int to long, inviter_id from int to long in channelParticipantSelf
Changed type of user_id from int to long in channelParticipantCreator
Changed type of user_id from int to long in chatParticipantCreator
Changed type of user_id from int to long, inviter_id from int to long in chatParticipantAdmin
Changed type of chat_id from int to long, user_id from int to long in updateChatParticipantAdmin
Changed type of channel_id from int to long in messageActionChatMigrateTo
Changed type of chat_id from int to long in messageActionChannelMigrateFrom
Changed type of hash from int to long in messages.savedGifs
Changed type of user_id from int to long in updateBotInlineQuery
Changed type of user_id from int to long in updateBotInlineSend
Changed type of user_id from int to long in updateBotCallbackQuery
Changed type of user_id from int to long in updateInlineBotCallbackQuery
Changed type of user_id from int to long in messageEntityMentionName
Changed type of channel_id from int to long in updateReadChannelOutbox
Changed type of hash from int to long in messages.featuredStickers
Changed type of hash from int to long in messages.recentStickers
Changed type of user_id from int to long in highScore
Changed type of channel_id from int to long in updateChannelWebPage
Changed type of bot_id from int to long, provider_id from int to long in payments.paymentForm
Changed type of bot_id from int to long, provider_id from int to long in payments.paymentReceipt
Changed type of user_id from int to long in updateBotShippingQuery
Changed type of user_id from int to long in updateBotPrecheckoutQuery
Changed type of admin_id from int to long, participant_id from int to long in phoneCallWaiting
Changed type of admin_id from int to long, participant_id from int to long in phoneCallRequested
Changed type of admin_id from int to long, participant_id from int to long in phoneCallAccepted
Changed type of admin_id from int to long, participant_id from int to long in phoneCall
Changed type of user_id from int to long, inviter_id from flags.1?int to flags.1?long, promoted_by from int to long in channelParticipantAdmin
Changed type of kicked_by from int to long in channelParticipantBanned
Changed type of user_id from int to long in channelAdminLogEvent
Changed type of hash from int to long in messages.favedStickers
Changed type of channel_id from int to long in updateChannelReadMessagesContents
Changed type of channel_id from int to long in updateChannelAvailableMessages
Changed type of user_id from int to long in recentMeUrlUser
Changed type of chat_id from int to long in recentMeUrlChat
Changed type of bot_id from int to long in webAuthorization
Changed type of hash from int to long in messages.foundStickerSets
Changed type of recent_voters from flags.3?Vector<int> to flags.3?Vector<long> in pollResults
Changed type of hash from int to long in account.wallPapers
Changed type of user_id from int to long in inputUserFromMessage
Changed type of channel_id from int to long in inputChannelFromMessage
Changed type of user_id from int to long in inputPeerUserFromMessage
Changed type of channel_id from int to long in inputPeerChannelFromMessage
Changed type of prev_value from int to long, new_value from int to long in channelAdminLogEventActionChangeLinkedChat
Changed type of chats from Vector<int> to Vector<long> in inputPrivacyValueAllowChatParticipants
Changed type of chats from Vector<int> to Vector<long> in inputPrivacyValueDisallowChatParticipants
Changed type of chats from Vector<int> to Vector<long> in privacyValueAllowChatParticipants
Changed type of chats from Vector<int> to Vector<long> in privacyValueDisallowChatParticipants
Changed type of hash from int to long in account.themes
Added outbox_accent_color parameter in inputThemeSettings
Added outbox_accent_color parameter in themeSettings
Changed type of user_id from int to long in updateMessagePollVote
Changed type of user_id from int to long in messageUserVote
Changed type of user_id from int to long in messageUserVoteInputOption
Changed type of user_id from int to long in messageUserVoteMultiple
Changed type of user_id from int to long in statsGroupTopPoster
Changed type of user_id from int to long in statsGroupTopAdmin
Changed type of user_id from int to long in statsGroupTopInviter
Changed type of channel_id from int to long in updateChannelMessageForwards
Changed type of channel_id from int to long, broadcast_id from flags.0?int to flags.0?long in updateReadChannelDiscussionInbox
Changed type of channel_id from int to long in updateReadChannelDiscussionOutbox
Changed type of channel_id from flags.0?int to flags.0?long in messageReplies
Changed type of channel_id from int to long in updateChannelUserTyping
Changed type of channel_id from int to long in updatePinnedChannelMessages
Changed type of users from Vector<int> to Vector<long> in messageActionInviteToGroupCall
Changed type of chat_id from int to long in updateChat
Changed type of chat_id from int to long in updateGroupCall
Changed type of chat_id from int to long, actor_id from int to long, user_id from int to long in updateChatParticipant
Changed type of channel_id from int to long, actor_id from int to long, user_id from int to long in updateChannelParticipant
Changed type of user_id from int to long in updateBotStopped
Changed type of user_id from int to long in chatInviteImporter
Changed type of admin_id from int to long in chatAdminWithInvites
Changed type of bot_id from int to long in updateBotCommands

Scheme

inputPeerChat#35a95cb9 chat_id:long = InputPeer;

peerUser#59511722 user_id:long = Peer;
peerChat#36c6019a chat_id:long = Peer;

userEmpty#d3bc4b7a id:long = User;

chatEmpty#29562865 id:long = Chat;
chat#41cbf256 flags:# creator:flags.0?true kicked:flags.1?true left:flags.2?true deactivated:flags.5?true call_active:flags.23?true call_not_empty:flags.24?true id:long title:string photo:ChatPhoto participants_count:int date:int version:int migrated_to:flags.6?InputChannel admin_rights:flags.14?ChatAdminRights default_banned_rights:flags.18?ChatBannedRights = Chat;
chatForbidden#6592a1a7 id:long title:string = Chat;
chatFull#4dbdc099 flags:# can_set_username:flags.7?true has_scheduled:flags.8?true id:long about:string participants:ChatParticipants chat_photo:flags.2?Photo notify_settings:PeerNotifySettings exported_invite:flags.13?ExportedChatInvite bot_info:flags.3?Vector<BotInfo> pinned_msg_id:flags.6?int folder_id:flags.11?int call:flags.12?InputGroupCall ttl_period:flags.14?int groupcall_default_join_as:flags.15?Peer theme_emoticon:flags.16?string = ChatFull;
chatParticipant#c02d4007 user_id:long inviter_id:long date:int = ChatParticipant;
chatParticipantsForbidden#8763d3e1 flags:# chat_id:long self_participant:flags.0?ChatParticipant = ChatParticipants;
chatParticipants#3cbc93f8 chat_id:long participants:Vector<ChatParticipant> version:int = ChatParticipants;

message#85d6cbe2 flags:# out:flags.1?true mentioned:flags.4?true media_unread:flags.5?true silent:flags.13?true post:flags.14?true from_scheduled:flags.18?true legacy:flags.19?true edit_hide:flags.21?true pinned:flags.24?true id:int from_id:flags.8?Peer peer_id:Peer fwd_from:flags.2?MessageFwdHeader via_bot_id:flags.11?long reply_to:flags.3?MessageReplyHeader date:int message:string media:flags.9?MessageMedia reply_markup:flags.6?ReplyMarkup entities:flags.7?Vector<MessageEntity> views:flags.10?int forwards:flags.10?int replies:flags.23?MessageReplies edit_date:flags.15?int post_author:flags.16?string grouped_id:flags.17?long restriction_reason:flags.22?Vector<RestrictionReason> ttl_period:flags.25?int = Message;
messageMediaContact#70322949 phone_number:string first_name:string last_name:string vcard:string user_id:long = MessageMedia;
messageActionChatCreate#bd47cbad title:string users:Vector<long> = MessageAction;
messageActionChatAddUser#15cefd00 users:Vector<long> = MessageAction;
messageActionChatDeleteUser#a43f30cc user_id:long = MessageAction;

auth.exportedAuthorization#b434e2b8 id:long bytes:bytes = auth.ExportedAuthorization;

contact#145ade0b user_id:long mutual:Bool = Contact;

importedContact#c13e3c50 user_id:long client_id:long = ImportedContact;

contactStatus#16d9703b user_id:long status:UserStatus = ContactStatus;

updateUserTyping#c01e857f user_id:long action:SendMessageAction = Update;
updateChatUserTyping#83487af0 chat_id:long from_id:Peer action:SendMessageAction = Update;
updateUserStatus#e5bdf8de user_id:long status:UserStatus = Update;
updateUserName#c3f202e0 user_id:long first_name:string last_name:string username:string = Update;
updateUserPhoto#f227868c user_id:long date:int photo:UserProfilePhoto previous:Bool = Update;
updateShortMessage#313bc7f8 flags:# out:flags.1?true mentioned:flags.4?true media_unread:flags.5?true silent:flags.13?true id:int user_id:long message:string pts:int pts_count:int date:int fwd_from:flags.2?MessageFwdHeader via_bot_id:flags.11?long reply_to:flags.3?MessageReplyHeader entities:flags.7?Vector<MessageEntity> ttl_period:flags.25?int = Updates;
updateShortChatMessage#4d6deea5 flags:# out:flags.1?true mentioned:flags.4?true media_unread:flags.5?true silent:flags.13?true id:int from_id:long chat_id:long message:string pts:int pts_count:int date:int fwd_from:flags.2?MessageFwdHeader via_bot_id:flags.11?long reply_to:flags.3?MessageReplyHeader entities:flags.7?Vector<MessageEntity> ttl_period:flags.25?int = Updates;

encryptedChatWaiting#66b25953 id:int access_hash:long date:int admin_id:long participant_id:long = EncryptedChat;
encryptedChatRequested#48f1d94c flags:# folder_id:flags.0?int id:int access_hash:long date:int admin_id:long participant_id:long g_a:bytes = EncryptedChat;
encryptedChat#61f0d4c7 id:int access_hash:long date:int admin_id:long participant_id:long g_a_or_b:bytes key_fingerprint:long = EncryptedChat;

updateChatParticipantAdd#3dda5451 chat_id:long user_id:long inviter_id:long date:int version:int = Update;
updateChatParticipantDelete#e32f3d77 chat_id:long user_id:long version:int = Update;

privacyValueAllowUsers#b8905fb2 users:Vector<long> = PrivacyRule;
privacyValueDisallowUsers#e4621141 users:Vector<long> = PrivacyRule;

updateUserPhone#05492a13 user_id:long phone:string = Update;

messages.stickers#30a6ec7e hash:long stickers:Vector<Document> = messages.Stickers;
messages.allStickers#cdbbcebb hash:long sets:Vector<StickerSet> = messages.AllStickers;

chatInviteExported#b18105e8 flags:# revoked:flags.0?true permanent:flags.5?true link:string admin_id:long date:int start_date:flags.4?int expire_date:flags.1?int usage_limit:flags.2?int usage:flags.3?int = ExportedChatInvite;

messageActionChatJoinedByLink#031224c3 inviter_id:long = MessageAction;

user#3ff6ecb0 flags:# self:flags.10?true contact:flags.11?true mutual_contact:flags.12?true deleted:flags.13?true bot:flags.14?true bot_chat_history:flags.15?true bot_nochats:flags.16?true verified:flags.17?true restricted:flags.18?true min:flags.20?true bot_inline_geo:flags.21?true support:flags.23?true scam:flags.24?true apply_min_photo:flags.25?true fake:flags.26?true id:long access_hash:flags.0?long first_name:flags.1?string last_name:flags.2?string username:flags.3?string phone:flags.4?string photo:flags.5?UserProfilePhoto status:flags.6?UserStatus bot_info_version:flags.14?int restriction_reason:flags.18?Vector<RestrictionReason> bot_inline_placeholder:flags.19?string lang_code:flags.22?string = User;

botInfo#1b74b335 user_id:long description:string commands:Vector<BotCommand> = BotInfo;

inputPeerUser#dde8a54c user_id:long access_hash:long = InputPeer;
inputUser#f21158c6 user_id:long access_hash:long = InputUser;
inputChannel#f35aec28 channel_id:long access_hash:long = InputChannel;

peerChannel#a2a5371e channel_id:long = Peer;

inputPeerChannel#27bcbbfc channel_id:long access_hash:long = InputPeer;

channel#8261ac61 flags:# creator:flags.0?true left:flags.2?true broadcast:flags.5?true verified:flags.7?true megagroup:flags.8?true restricted:flags.9?true signatures:flags.11?true min:flags.12?true scam:flags.19?true has_link:flags.20?true has_geo:flags.21?true slowmode_enabled:flags.22?true call_active:flags.23?true call_not_empty:flags.24?true fake:flags.25?true gigagroup:flags.26?true id:long access_hash:flags.13?long title:string username:flags.6?string photo:ChatPhoto date:int restriction_reason:flags.9?Vector<RestrictionReason> admin_rights:flags.14?ChatAdminRights banned_rights:flags.15?ChatBannedRights default_banned_rights:flags.18?ChatBannedRights participants_count:flags.17?int = Chat;
channelForbidden#17d493d5 flags:# broadcast:flags.5?true megagroup:flags.8?true id:long access_hash:long title:string until_date:flags.16?int = Chat;
channelFull#e9b27a17 flags:# can_view_participants:flags.3?true can_set_username:flags.6?true can_set_stickers:flags.7?true hidden_prehistory:flags.10?true can_set_location:flags.16?true has_scheduled:flags.19?true can_view_stats:flags.20?true blocked:flags.22?true id:long about:string participants_count:flags.0?int admins_count:flags.1?int kicked_count:flags.2?int banned_count:flags.2?int online_count:flags.13?int read_inbox_max_id:int read_outbox_max_id:int unread_count:int chat_photo:Photo notify_settings:PeerNotifySettings exported_invite:flags.23?ExportedChatInvite bot_info:Vector<BotInfo> migrated_from_chat_id:flags.4?long migrated_from_max_id:flags.4?int pinned_msg_id:flags.5?int stickerset:flags.8?StickerSet available_min_id:flags.9?int folder_id:flags.11?int linked_chat_id:flags.14?long location:flags.15?ChannelLocation slowmode_seconds:flags.17?int slowmode_next_send_date:flags.18?int stats_dc:flags.12?int pts:int call:flags.21?InputGroupCall ttl_period:flags.24?int pending_suggestions:flags.25?Vector<string> groupcall_default_join_as:flags.26?Peer theme_emoticon:flags.27?string = ChatFull;

updateChannelTooLong#108d941f flags:# channel_id:long pts:flags.0?int = Update;
updateChannel#635b4c09 channel_id:long = Update;
updateReadChannelInbox#922e6e10 flags:# folder_id:flags.0?int channel_id:long max_id:int still_unread_count:int pts:int = Update;
updateDeleteChannelMessages#c32d5b12 channel_id:long messages:Vector<int> pts:int pts_count:int = Update;
updateChannelMessageViews#f226ac08 channel_id:long id:int views:int = Update;

channelParticipant#c00c07c0 user_id:long date:int = ChannelParticipant;
channelParticipantSelf#28a8bc67 user_id:long inviter_id:long date:int = ChannelParticipant;
channelParticipantCreator#2fe601d3 flags:# user_id:long admin_rights:ChatAdminRights rank:flags.0?string = ChannelParticipant;
chatParticipantCreator#e46bcee4 user_id:long = ChatParticipant;
chatParticipantAdmin#a0933f5b user_id:long inviter_id:long date:int = ChatParticipant;

updateChatParticipantAdmin#d7ca61a2 chat_id:long user_id:long is_admin:Bool version:int = Update;

messageActionChatMigrateTo#e1037f92 channel_id:long = MessageAction;
messageActionChannelMigrateFrom#ea3948e9 title:string chat_id:long = MessageAction;
messages.savedGifs#84a02a0d hash:long gifs:Vector<Document> = messages.SavedGifs;

updateBotInlineQuery#496f379c flags:# query_id:long user_id:long query:string geo:flags.0?GeoPoint peer_type:flags.1?InlineQueryPeerType offset:string = Update;
updateBotInlineSend#12f12a07 flags:# user_id:long query:string geo:flags.0?GeoPoint id:string msg_id:flags.1?InputBotInlineMessageID = Update;
updateBotCallbackQuery#b9cfc48d flags:# query_id:long user_id:long peer:Peer msg_id:int chat_instance:long data:flags.0?bytes game_short_name:flags.1?string = Update;
updateInlineBotCallbackQuery#691e9052 flags:# query_id:long user_id:long msg_id:InputBotInlineMessageID chat_instance:long data:flags.0?bytes game_short_name:flags.1?string = Update;

messageEntityMentionName#dc7b1140 offset:int length:int user_id:long = MessageEntity;

updateReadChannelOutbox#b75f99a9 channel_id:long max_id:int = Update;

messages.featuredStickers#84c02310 hash:long count:int sets:Vector<StickerSetCovered> unread:Vector<long> = messages.FeaturedStickers;
messages.recentStickers#88d37c56 hash:long packs:Vector<StickerPack> stickers:Vector<Document> dates:Vector<int> = messages.RecentStickers;

highScore#73a379eb pos:int user_id:long score:int = HighScore;

updateChannelWebPage#2f2ba99f channel_id:long webpage:WebPage pts:int pts_count:int = Update;

payments.paymentForm#1694761b flags:# can_save_credentials:flags.2?true password_missing:flags.3?true form_id:long bot_id:long invoice:Invoice provider_id:long url:string native_provider:flags.4?string native_params:flags.4?DataJSON saved_info:flags.0?PaymentRequestedInfo saved_credentials:flags.1?PaymentSavedCredentials users:Vector<User> = payments.PaymentForm;
payments.paymentReceipt#70c4fe03 flags:# date:int bot_id:long provider_id:long title:string description:string photo:flags.2?WebDocument invoice:Invoice info:flags.0?PaymentRequestedInfo shipping:flags.1?ShippingOption tip_amount:flags.3?long currency:string total_amount:long credentials_title:string users:Vector<User> = payments.PaymentReceipt;

updateBotShippingQuery#b5aefd7d query_id:long user_id:long payload:bytes shipping_address:PostAddress = Update;
updateBotPrecheckoutQuery#8caa9a96 flags:# query_id:long user_id:long payload:bytes info:flags.0?PaymentRequestedInfo shipping_option_id:flags.1?string currency:string total_amount:long = Update;

phoneCallWaiting#c5226f17 flags:# video:flags.6?true id:long access_hash:long date:int admin_id:long participant_id:long protocol:PhoneCallProtocol receive_date:flags.0?int = PhoneCall;
phoneCallRequested#14b0ed0c flags:# video:flags.6?true id:long access_hash:long date:int admin_id:long participant_id:long g_a_hash:bytes protocol:PhoneCallProtocol = PhoneCall;
phoneCallAccepted#3660c311 flags:# video:flags.6?true id:long access_hash:long date:int admin_id:long participant_id:long g_b:bytes protocol:PhoneCallProtocol = PhoneCall;
phoneCall#967f7c67 flags:# p2p_allowed:flags.5?true video:flags.6?true id:long access_hash:long date:int admin_id:long participant_id:long g_a_or_b:bytes key_fingerprint:long protocol:PhoneCallProtocol connections:Vector<PhoneConnection> start_date:int = PhoneCall;

channelParticipantAdmin#34c3bb53 flags:# can_edit:flags.0?true self:flags.1?true user_id:long inviter_id:flags.1?long promoted_by:long date:int admin_rights:ChatAdminRights rank:flags.2?string = ChannelParticipant;
channelParticipantBanned#6df8014e flags:# left:flags.0?true peer:Peer kicked_by:long date:int banned_rights:ChatBannedRights = ChannelParticipant;
channelAdminLogEvent#1fad68cd id:long date:int user_id:long action:ChannelAdminLogEventAction = ChannelAdminLogEvent;

messages.favedStickers#2cb51097 hash:long packs:Vector<StickerPack> stickers:Vector<Document> = messages.FavedStickers;

updateChannelReadMessagesContents#44bdd535 channel_id:long messages:Vector<int> = Update;
updateChannelAvailableMessages#b23fc698 channel_id:long available_min_id:int = Update;

recentMeUrlUser#b92c09e2 url:string user_id:long = RecentMeUrl;
recentMeUrlChat#b2da71d2 url:string chat_id:long = RecentMeUrl;

webAuthorization#a6f8f452 hash:long bot_id:long domain:string browser:string platform:string date_created:int date_active:int ip:string region:string = WebAuthorization;

messages.foundStickerSets#8af09dd2 hash:long sets:Vector<StickerSetCovered> = messages.FoundStickerSets;

pollResults#dcb82ea3 flags:# min:flags.0?true results:flags.1?Vector<PollAnswerVoters> total_voters:flags.2?int recent_voters:flags.3?Vector<long> solution:flags.4?string solution_entities:flags.4?Vector<MessageEntity> = PollResults;

account.wallPapers#cdc3858c hash:long wallpapers:Vector<WallPaper> = account.WallPapers;

inputUserFromMessage#1da448e2 peer:InputPeer msg_id:int user_id:long = InputUser;
inputChannelFromMessage#5b934f9d peer:InputPeer msg_id:int channel_id:long = InputChannel;
inputPeerUserFromMessage#a87b0a1c peer:InputPeer msg_id:int user_id:long = InputPeer;
inputPeerChannelFromMessage#bd2a0840 peer:InputPeer msg_id:int channel_id:long = InputPeer;

channelAdminLogEventActionChangeLinkedChat#050c7ac8 prev_value:long new_value:long = ChannelAdminLogEventAction;

inputPrivacyValueAllowChatParticipants#840649cf chats:Vector<long> = InputPrivacyRule;
inputPrivacyValueDisallowChatParticipants#e94f0f86 chats:Vector<long> = InputPrivacyRule;

privacyValueAllowChatParticipants#6b134e8e chats:Vector<long> = PrivacyRule;
privacyValueDisallowChatParticipants#41c87565 chats:Vector<long> = PrivacyRule;

account.themes#9a3d8c6d hash:long themes:Vector<Theme> = account.Themes;

inputThemeSettings#8fde504f flags:# message_colors_animated:flags.2?true base_theme:BaseTheme accent_color:int outbox_accent_color:flags.3?int message_colors:flags.0?Vector<int> wallpaper:flags.1?InputWallPaper wallpaper_settings:flags.1?WallPaperSettings = InputThemeSettings;

themeSettings#fa58b6d4 flags:# message_colors_animated:flags.2?true base_theme:BaseTheme accent_color:int outbox_accent_color:flags.3?int message_colors:flags.0?Vector<int> wallpaper:flags.1?WallPaper = ThemeSettings;

updateMessagePollVote#106395c9 poll_id:long user_id:long options:Vector<bytes> qts:int = Update;

messageUserVote#34d247b4 user_id:long option:bytes date:int = MessageUserVote;
messageUserVoteInputOption#3ca5b0ec user_id:long date:int = MessageUserVote;
messageUserVoteMultiple#8a65e557 user_id:long options:Vector<bytes> date:int = MessageUserVote;

statsGroupTopPoster#9d04af9b user_id:long messages:int avg_chars:int = StatsGroupTopPoster;
statsGroupTopAdmin#d7584c87 user_id:long deleted:int kicked:int banned:int = StatsGroupTopAdmin;
statsGroupTopInviter#535f779d user_id:long invitations:int = StatsGroupTopInviter;

updateChannelMessageForwards#d29a27f4 channel_id:long id:int forwards:int = Update;
updateReadChannelDiscussionInbox#d6b19546 flags:# channel_id:long top_msg_id:int read_max_id:int broadcast_id:flags.0?long broadcast_post:flags.0?int = Update;
updateReadChannelDiscussionOutbox#695c9e7c channel_id:long top_msg_id:int read_max_id:int = Update;

messageReplies#83d60fc2 flags:# comments:flags.0?true replies:int replies_pts:int recent_repliers:flags.1?Vector<Peer> channel_id:flags.0?long max_id:flags.2?int read_max_id:flags.3?int = MessageReplies;

updateChannelUserTyping#8c88c923 flags:# channel_id:long top_msg_id:flags.0?int from_id:Peer action:SendMessageAction = Update;
updatePinnedChannelMessages#5bb98608 flags:# pinned:flags.0?true channel_id:long messages:Vector<int> pts:int pts_count:int = Update;

messageActionInviteToGroupCall#502f92f7 call:InputGroupCall users:Vector<long> = MessageAction;

updateChat#f89a6a4e chat_id:long = Update;
updateGroupCall#14b24500 chat_id:long call:GroupCall = Update;
updateChatParticipant#d087663a flags:# chat_id:long date:int actor_id:long user_id:long prev_participant:flags.0?ChatParticipant new_participant:flags.1?ChatParticipant invite:flags.2?ExportedChatInvite qts:int = Update;
updateChannelParticipant#985d3abb flags:# channel_id:long date:int actor_id:long user_id:long prev_participant:flags.0?ChannelParticipant new_participant:flags.1?ChannelParticipant invite:flags.2?ExportedChatInvite qts:int = Update;
updateBotStopped#c4870a49 user_id:long date:int stopped:Bool qts:int = Update;

chatInviteImporter#0b5cd5f4 user_id:long date:int = ChatInviteImporter;
chatAdminWithInvites#f2ecef23 admin_id:long invites_count:int revoked_invites_count:int = ChatAdminWithInvites;

updateBotCommands#4d712f2e peer:Peer bot_id:long commands:Vector<BotCommand> = Update;

inputBotInlineMessageID64#b6d915d7 dc_id:int owner_id:long id:int access_hash:long = InputBotInlineMessageID;

---functions---

auth.importAuthorization#a57a7dad id:long bytes:bytes = auth.Authorization;
account.registerDevice#ec86017a flags:# no_muted:flags.0?true token_type:int token:string app_sandbox:Bool secret:bytes other_uids:Vector<long> = Bool;
account.unregisterDevice#6a0d3206 token_type:int token:string other_uids:Vector<long> = Bool;
account.getWallPapers#07967d36 hash:long = account.WallPapers;

contacts.getContactIDs#7adc669d hash:long = Vector<int>;
contacts.getContacts#5dd69e12 hash:long = contacts.Contacts;

messages.getDialogs#a0f4cb4f flags:# exclude_pinned:flags.0?true folder_id:flags.1?int offset_date:int offset_id:int offset_peer:InputPeer limit:int hash:long = messages.Dialogs;
messages.getHistory#4423e6c5 peer:InputPeer offset_id:int offset_date:int add_offset:int limit:int max_id:int min_id:int hash:long = messages.Messages;
messages.search#a0fda762 flags:# peer:InputPeer q:string from_id:flags.0?InputPeer top_msg_id:flags.1?int filter:MessagesFilter min_date:int max_date:int offset_id:int add_offset:int limit:int max_id:int min_id:int hash:long = messages.Messages;
messages.getChats#49e9528f id:Vector<long> = messages.Chats;
messages.getFullChat#aeb00b34 chat_id:long = messages.ChatFull;
messages.editChatTitle#73783ffd chat_id:long title:string = Updates;
messages.editChatPhoto#35ddd674 chat_id:long photo:InputChatPhoto = Updates;
messages.addChatUser#f24753e3 chat_id:long user_id:InputUser fwd_limit:int = Updates;
messages.deleteChatUser#a2185cab flags:# revoke_history:flags.0?true chat_id:long user_id:InputUser = Updates;
messages.getStickers#d5a5d3a1 emoticon:string hash:long = messages.Stickers;
messages.getAllStickers#b8a0a1a8 hash:long = messages.AllStickers;

channels.getParticipants#77ced9d0 channel:InputChannel filter:ChannelParticipantsFilter offset:int limit:int hash:long = channels.ChannelParticipants;

messages.editChatAdmin#a85bd1c2 chat_id:long user_id:InputUser is_admin:Bool = Bool;
messages.migrateChat#a2875319 chat_id:long = Updates;
messages.getSavedGifs#5cf09635 hash:long = messages.SavedGifs;

contacts.getTopPeers#973478b6 flags:# correspondents:flags.0?true bots_pm:flags.1?true bots_inline:flags.2?true phone_calls:flags.3?true forward_users:flags.4?true forward_chats:flags.5?true groups:flags.10?true channels:flags.15?true offset:int limit:int hash:long = contacts.TopPeers;

messages.getFeaturedStickers#64780b14 hash:long = messages.FeaturedStickers;
messages.getRecentStickers#9da9403b flags:# attached:flags.0?true hash:long = messages.RecentStickers;
messages.getMaskStickers#640f82b8 hash:long = messages.AllStickers;
messages.getCommonChats#e40ca104 user_id:InputUser max_id:long limit:int = messages.Chats;
messages.getAllChats#875f74be except_ids:Vector<long> = messages.Chats;
messages.getFavedStickers#04f1aaa9 hash:long = messages.FavedStickers;
messages.getRecentLocations#702a40e0 peer:InputPeer limit:int hash:long = messages.Messages;
messages.searchStickerSets#35705b8a flags:# exclude_featured:flags.0?true q:string hash:long = messages.FoundStickerSets;

account.getAuthorizationForm#a929597a bot_id:long scope:string public_key:string = account.AuthorizationForm;
account.acceptAuthorization#f3ed4c73 bot_id:long scope:string public_key:string value_hashes:Vector<SecureValueHash> credentials:SecureCredentialsEncrypted = Bool;

messages.getScheduledHistory#f516760b peer:InputPeer hash:long = messages.Messages;

account.getThemes#7206e458 format:string hash:long = account.Themes;
auth.exportLoginToken#b7e085fe api_id:int api_hash:string except_ids:Vector<long> = auth.LoginToken;

messages.getOldFeaturedStickers#7ed094a1 offset:int limit:int hash:long = messages.FeaturedStickers;
messages.getReplies#22ddd30c peer:InputPeer msg_id:int offset_id:int offset_date:int add_offset:int limit:int max_id:int min_id:int hash:long = messages.Messages;
messages.deleteChat#5bd0ee50 chat_id:long = Bool;
messages.getMessageReadParticipants#2c6f97b7 peer:InputPeer msg_id:int = Vector<long>;

Layer 132

Scheme changes

New Methods

Added account.getChatThemes - Get all available chat themes
Added messages.setChatTheme - Change the chat theme of a certain chat
Added channels.viewSponsoredMessage - Mark a specific sponsored message as read
Added channels.getSponsoredMessages - Get a list of sponsored messages

Changed Methods

Added video, video_portrait parameters in phone.toggleGroupCallRecord

New Constructors

Added chatTheme - A chat theme
Added account.chatThemesNotModified - The available chat themes were not modified
Added account.chatThemes - Available chat themes
Added messageActionSetChatTheme - The chat theme was changed
Added sendMessageChooseStickerAction - User is choosing a sticker
Added sponsoredMessage - A sponsored message
Added messages.sponsoredMessages - A set of sponsored messages associated to a channel
Added channelAdminLogEventActionChangeTheme - The chat theme was changed

Changed Constructors

Added theme_emoticon parameter in chatFull
Added theme_emoticon parameter in userFull
Added theme_emoticon parameter in channelFull
Added for_chat parameter, changed type of installs_count from int to flags.4?int in theme
Added message_colors_animated, message_colors parameters, removed message_top_color, message_bottom_color parameters in inputThemeSettings
Added message_colors_animated, message_colors parameters, removed message_top_color, message_bottom_color parameters in themeSettings
Added unread_count parameter in messages.discussionMessage
Added flags, video_channel, video_quality parameters in inputGroupCallStream

Scheme

chatFull#49a0a5d9 flags:# can_set_username:flags.7?true has_scheduled:flags.8?true id:int about:string participants:ChatParticipants chat_photo:flags.2?Photo notify_settings:PeerNotifySettings exported_invite:flags.13?ExportedChatInvite bot_info:flags.3?Vector<BotInfo> pinned_msg_id:flags.6?int folder_id:flags.11?int call:flags.12?InputGroupCall ttl_period:flags.14?int groupcall_default_join_as:flags.15?Peer theme_emoticon:flags.16?string = ChatFull;

userFull#d697ff05 flags:# blocked:flags.0?true phone_calls_available:flags.4?true phone_calls_private:flags.5?true can_pin_message:flags.7?true has_scheduled:flags.12?true video_calls_available:flags.13?true user:User about:flags.1?string settings:PeerSettings profile_photo:flags.2?Photo notify_settings:PeerNotifySettings bot_info:flags.3?BotInfo pinned_msg_id:flags.6?int common_chats_count:int folder_id:flags.11?int ttl_period:flags.14?int theme_emoticon:flags.15?string = UserFull;

channelFull#2f532f3c flags:# can_view_participants:flags.3?true can_set_username:flags.6?true can_set_stickers:flags.7?true hidden_prehistory:flags.10?true can_set_location:flags.16?true has_scheduled:flags.19?true can_view_stats:flags.20?true blocked:flags.22?true id:int about:string participants_count:flags.0?int admins_count:flags.1?int kicked_count:flags.2?int banned_count:flags.2?int online_count:flags.13?int read_inbox_max_id:int read_outbox_max_id:int unread_count:int chat_photo:Photo notify_settings:PeerNotifySettings exported_invite:flags.23?ExportedChatInvite bot_info:Vector<BotInfo> migrated_from_chat_id:flags.4?int migrated_from_max_id:flags.4?int pinned_msg_id:flags.5?int stickerset:flags.8?StickerSet available_min_id:flags.9?int folder_id:flags.11?int linked_chat_id:flags.14?int location:flags.15?ChannelLocation slowmode_seconds:flags.17?int slowmode_next_send_date:flags.18?int stats_dc:flags.12?int pts:int call:flags.21?InputGroupCall ttl_period:flags.24?int pending_suggestions:flags.25?Vector<string> groupcall_default_join_as:flags.26?Peer theme_emoticon:flags.27?string = ChatFull;

theme#e802b8dc flags:# creator:flags.0?true default:flags.1?true for_chat:flags.5?true id:long access_hash:long slug:string title:string document:flags.2?Document settings:flags.3?ThemeSettings installs_count:flags.4?int = Theme;

inputThemeSettings#ff38f912 flags:# message_colors_animated:flags.2?true base_theme:BaseTheme accent_color:int message_colors:flags.0?Vector<int> wallpaper:flags.1?InputWallPaper wallpaper_settings:flags.1?WallPaperSettings = InputThemeSettings;

themeSettings#8db4e76c flags:# message_colors_animated:flags.2?true base_theme:BaseTheme accent_color:int message_colors:flags.0?Vector<int> wallpaper:flags.1?WallPaper = ThemeSettings;

messages.discussionMessage#a6341782 flags:# messages:Vector<Message> max_id:flags.0?int read_inbox_max_id:flags.1?int read_outbox_max_id:flags.2?int unread_count:int chats:Vector<Chat> users:Vector<User> = messages.DiscussionMessage;

inputGroupCallStream#0598a92a flags:# call:InputGroupCall time_ms:long scale:int video_channel:flags.0?int video_quality:flags.0?int = InputFileLocation;

chatTheme#ed0b5c33 emoticon:string theme:Theme dark_theme:Theme = ChatTheme;

account.chatThemesNotModified#e011e1c4 = account.ChatThemes;
account.chatThemes#fe4cbebd hash:int themes:Vector<ChatTheme> = account.ChatThemes;

messageActionSetChatTheme#aa786345 emoticon:string = MessageAction;

sendMessageChooseStickerAction#b05ac6b1 = SendMessageAction;
sponsoredMessage#2a3c381f flags:# random_id:bytes from_id:Peer start_param:flags.0?string message:string entities:flags.1?Vector<MessageEntity> = SponsoredMessage;

messages.sponsoredMessages#65a4c7d5 messages:Vector<SponsoredMessage> chats:Vector<Chat> users:Vector<User> = messages.SponsoredMessages;

channelAdminLogEventActionChangeTheme#fe69018d prev_value:string new_value:string = ChannelAdminLogEventAction;

---functions---

phone.toggleGroupCallRecord#f128c708 flags:# start:flags.0?true video:flags.2?true call:InputGroupCall title:flags.1?string video_portrait:flags.2?Bool = Updates;

account.getChatThemes#d6d71d7b hash:int = account.ChatThemes;

messages.setChatTheme#e63be13f peer:InputPeer emoticon:string = Updates;

channels.viewSponsoredMessage#beaedb94 channel:InputChannel random_id:bytes = Bool;
channels.getSponsoredMessages#ec210fbf channel:InputChannel = messages.SponsoredMessages;

Layer 131

Scheme changes

New Methods

Added account.resetPassword - Initiate a 2FA password reset
Added account.declinePasswordReset - Abort a pending 2FA password reset
Added auth.checkRecoveryPassword - Check if the recovery code sent using auth.requestPasswordRecovery is valid, before passing it to auth.recoverPassword.

Changed Methods

Added flags, new_settings parameters in auth.recoverPassword
Added limit parameter in phone.getGroupCall

New Constructors

Added account.resetPasswordFailedWait - You requested a password reset too many times, please wait until the specified date before retrying the reset.
Added account.resetPasswordRequestedWait - You already requested a password reset, please wait until the specified date before retrying the reset.
Added account.resetPasswordOk - The 2FA password was reset successfully.
Added updateBotCommands - The command set of a certain bot in a certain chat has changed.

Changed Constructors

Added pending_reset_date parameter in account.password
Added record_video_active, unmuted_video_count, unmuted_video_limit parameters in groupCall
Added audio_source parameter in groupCallParticipantVideo

Scheme

account.password#185b184f flags:# has_recovery:flags.0?true has_secure_values:flags.1?true has_password:flags.2?true current_algo:flags.2?PasswordKdfAlgo srp_B:flags.2?bytes srp_id:flags.2?long hint:flags.3?string email_unconfirmed_pattern:flags.4?string new_algo:PasswordKdfAlgo new_secure_algo:SecurePasswordKdfAlgo secure_random:bytes pending_reset_date:flags.5?int = account.Password;

groupCall#d597650c flags:# join_muted:flags.1?true can_change_join_muted:flags.2?true join_date_asc:flags.6?true schedule_start_subscribed:flags.8?true can_start_video:flags.9?true record_video_active:flags.11?true id:long access_hash:long participants_count:int title:flags.3?string stream_dc_id:flags.4?int record_start_date:flags.5?int schedule_date:flags.7?int unmuted_video_count:flags.10?int unmuted_video_limit:int version:int = GroupCall;
groupCallParticipantVideo#67753ac8 flags:# paused:flags.0?true endpoint:string source_groups:Vector<GroupCallParticipantVideoSourceGroup> audio_source:flags.1?int = GroupCallParticipantVideo;

account.resetPasswordFailedWait#e3779861 retry_date:int = account.ResetPasswordResult;
account.resetPasswordRequestedWait#e9effc7d until_date:int = account.ResetPasswordResult;
account.resetPasswordOk#e926d63e = account.ResetPasswordResult;

updateBotCommands#cf7e0873 peer:Peer bot_id:int commands:Vector<BotCommand> = Update;

---functions---

auth.recoverPassword#37096c70 flags:# code:string new_settings:flags.0?account.PasswordInputSettings = auth.Authorization;

phone.getGroupCall#041845db call:InputGroupCall limit:int = phone.GroupCall;

account.resetPassword#9308ce1b = account.ResetPasswordResult;
account.declinePasswordReset#4c9409f6 = Bool;
auth.checkRecoveryPassword#0d36bf79 code:string = Bool;

Layer 130

Scheme changes

Changed Constructors

Added placeholder parameter in replyKeyboardForceReply
Added placeholder parameter in replyKeyboardMarkup

Scheme

replyKeyboardForceReply#86b40b08 flags:# single_use:flags.1?true selective:flags.2?true placeholder:flags.3?string = ReplyMarkup;
replyKeyboardMarkup#85dd99d1 flags:# resize:flags.0?true single_use:flags.1?true selective:flags.2?true rows:Vector<KeyboardButtonRow> placeholder:flags.3?string = ReplyMarkup;

Layer 129

Scheme changes

New Methods

Added phone.joinGroupCallPresentation - Start screen sharing in a call
Added phone.leaveGroupCallPresentation - Stop screen sharing in a group call
Added stickers.checkShortName - Check whether the given short name is available
Added stickers.suggestShortName - Suggests a short name for a given stickerpack name
Added bots.resetBotCommands - Clear bot commands for the specified bot scope and language code
Added bots.getBotCommands - Obtain a list of bot commands for the specified bot scope and language code

Changed Methods

Added software parameter in stickers.createStickerSet
Added scope, lang_code parameters in bots.setBotCommands
Changed type of phone.checkGroupCall from Bool to Vector<int>
Added sources parameter, removed source parameter in phone.checkGroupCall
Added video_stopped, video_paused, presentation_paused parameters, removed video_muted parameter in phone.editGroupCallParticipant

New Constructors

Added groupCallParticipantVideoSourceGroup - Describes a group of video synchronization source identifiers
Added groupCallParticipantVideo - Info about a video stream
Added updateGroupCallConnection - New WebRTC parameters
Added stickers.suggestedShortName - A suggested short name for a stickerpack
Added botCommandScopeDefault - The commands will be valid in all dialogs
Added botCommandScopeUsers - The specified bot commands will only be valid in all private chats with users.
Added botCommandScopeChats - The specified bot commands will be valid in all groups and supergroups.
Added botCommandScopeChatAdmins - The specified bot commands will be valid only for chat administrators, in all groups and supergroups.
Added botCommandScopePeer - The specified bot commands will be valid only in a specific dialog.
Added botCommandScopePeerAdmins - The specified bot commands will be valid for all admins of the specified group or supergroup.
Added botCommandScopePeerUser - The specified bot commands will be valid only for a specific user in the specified group or supergroup.

Changed Constructors

Added sticker parameter in help.appUpdate
Added third_background_color, fourth_background_color parameters in wallPaperSettings
Added id parameter in inputWallPaperNoFile
Added id parameter in wallPaperNoFile
Added qts parameter in updateMessagePollVote
Added can_start_video parameter, removed params parameter in groupCall
Added video_joined, video, presentation parameters, removed params parameter in groupCallParticipant

Scheme

help.appUpdate#ccbbce30 flags:# can_not_skip:flags.0?true id:int version:string text:string entities:Vector<MessageEntity> document:flags.1?Document url:flags.2?string sticker:flags.3?Document = help.AppUpdate;

wallPaperSettings#1dc1bca4 flags:# blur:flags.1?true motion:flags.2?true background_color:flags.0?int second_background_color:flags.4?int third_background_color:flags.5?int fourth_background_color:flags.6?int intensity:flags.3?int rotation:flags.4?int = WallPaperSettings;

inputWallPaperNoFile#967a462e id:long = InputWallPaper;

wallPaperNoFile#e0804116 id:long flags:# default:flags.1?true dark:flags.4?true settings:flags.2?WallPaperSettings = WallPaper;

updateMessagePollVote#37f69f0b poll_id:long user_id:int options:Vector<bytes> qts:int = Update;

groupCall#653dbaad flags:# join_muted:flags.1?true can_change_join_muted:flags.2?true join_date_asc:flags.6?true schedule_start_subscribed:flags.8?true can_start_video:flags.9?true id:long access_hash:long participants_count:int title:flags.3?string stream_dc_id:flags.4?int record_start_date:flags.5?int schedule_date:flags.7?int version:int = GroupCall;
groupCallParticipant#eba636fe flags:# muted:flags.0?true left:flags.1?true can_self_unmute:flags.2?true just_joined:flags.4?true versioned:flags.5?true min:flags.8?true muted_by_you:flags.9?true volume_by_admin:flags.10?true self:flags.12?true video_joined:flags.15?true peer:Peer date:int active_date:flags.3?int source:int volume:flags.7?int about:flags.11?string raise_hand_rating:flags.13?long video:flags.6?GroupCallParticipantVideo presentation:flags.14?GroupCallParticipantVideo = GroupCallParticipant;
groupCallParticipantVideoSourceGroup#dcb118b7 semantics:string sources:Vector<int> = GroupCallParticipantVideoSourceGroup;
groupCallParticipantVideo#78e41663 flags:# paused:flags.0?true endpoint:string source_groups:Vector<GroupCallParticipantVideoSourceGroup> = GroupCallParticipantVideo;

updateGroupCallConnection#0b783982 flags:# presentation:flags.0?true params:DataJSON = Update;

stickers.suggestedShortName#85fea03f short_name:string = stickers.SuggestedShortName;

botCommandScopeDefault#2f6cb2ab = BotCommandScope;
botCommandScopeUsers#3c4f04d8 = BotCommandScope;
botCommandScopeChats#6fe1a881 = BotCommandScope;
botCommandScopeChatAdmins#b9aa606a = BotCommandScope;
botCommandScopePeer#db9d897d peer:InputPeer = BotCommandScope;
botCommandScopePeerAdmins#3fd863d1 peer:InputPeer = BotCommandScope;
botCommandScopePeerUser#0a1321f3 peer:InputPeer user_id:InputUser = BotCommandScope;

---functions---

stickers.createStickerSet#9021ab67 flags:# masks:flags.0?true animated:flags.1?true user_id:InputUser title:string short_name:string thumb:flags.2?InputDocument stickers:Vector<InputStickerSetItem> software:flags.3?string = messages.StickerSet;

bots.setBotCommands#0517165a scope:BotCommandScope lang_code:string commands:Vector<BotCommand> = Bool;

phone.checkGroupCall#b59cf977 call:InputGroupCall sources:Vector<int> = Vector<int>;
phone.editGroupCallParticipant#a5273abf flags:# call:InputGroupCall participant:InputPeer muted:flags.0?Bool volume:flags.1?int raise_hand:flags.2?Bool video_stopped:flags.3?Bool video_paused:flags.4?Bool presentation_paused:flags.5?Bool = Updates;
phone.joinGroupCallPresentation#cbea6bc4 call:InputGroupCall params:DataJSON = Updates;
phone.leaveGroupCallPresentation#1c50d144 call:InputGroupCall = Updates;

stickers.checkShortName#284b3639 short_name:string = Bool;
stickers.suggestShortName#4dafc503 title:string = stickers.SuggestedShortName;

bots.resetBotCommands#3d8de0f9 scope:BotCommandScope lang_code:string = Bool;
bots.getBotCommands#e34c0dd6 scope:BotCommandScope lang_code:string = Vector<BotCommand>;

Layer 128

Scheme changes

Changed Methods

Added video_muted parameter, changed type of muted from flags.0?true to flags.0?Bool in phone.editGroupCallParticipant

Changed Constructors

Removed photo_small, photo_big parameters in userProfilePhoto
Added photo_id parameter, removed photo_small, photo_big parameters in chatPhoto
Removed location parameter in photoSize
Removed location parameter in photoCachedSize
Added photo_id parameter, removed volume_id, local_id parameters in inputPeerPhotoFileLocation
Added thumb_version parameter, removed volume_id, local_id parameters in inputStickerSetThumb
Removed location parameter in videoSize
Removed location parameter in photoSizeProgressive

Deleted Constructors

Removed fileLocationToBeDeprecated

Scheme

userProfilePhoto#82d1f706 flags:# has_video:flags.0?true photo_id:long stripped_thumb:flags.1?bytes dc_id:int = UserProfilePhoto;

chatPhoto#1c6e1c11 flags:# has_video:flags.0?true photo_id:long stripped_thumb:flags.1?bytes dc_id:int = ChatPhoto;

photoSize#75c78e60 type:string w:int h:int size:int = PhotoSize;
photoCachedSize#021e1ad6 type:string w:int h:int bytes:bytes = PhotoSize;

inputPeerPhotoFileLocation#37257e99 flags:# big:flags.0?true peer:InputPeer photo_id:long = InputFileLocation;
inputStickerSetThumb#9d84f3db stickerset:InputStickerSet thumb_version:int = InputFileLocation;

videoSize#de33b094 flags:# type:string w:int h:int size:int video_start_ts:flags.0?double = VideoSize;

photoSizeProgressive#fa3efb95 type:string w:int h:int sizes:Vector<int> = PhotoSize;

---functions---

phone.editGroupCallParticipant#aec610e4 flags:# call:InputGroupCall participant:InputPeer muted:flags.0?Bool volume:flags.1?int raise_hand:flags.2?Bool video_muted:flags.3?Bool = Updates;

Layer 127

Scheme changes

New Methods

Added phone.toggleGroupCallStartSubscription - Subscribe or unsubscribe to a scheduled group call
Added phone.startScheduledGroupCall - Start a scheduled group call.
Added phone.saveDefaultGroupCallJoinAs - Set the default peer that will be used to join a group call in a specific dialog.

Changed Methods

Added flags, peer, theme_params parameters in payments.getPaymentForm
Added peer parameter in payments.getPaymentReceipt
Added peer parameter in payments.validateRequestedInfo
Added form_id, peer, tip_amount parameters in payments.sendPaymentForm
Added flags, title, schedule_date parameters in phone.createGroupCall

New Constructors

Added inputBotInlineMessageMediaInvoice - An invoice
Added botInlineMessageMediaInvoice - Send an invoice
Added messageActionGroupCallScheduled - A group call was scheduled

Changed Constructors

Added stripped_thumb parameter in userProfilePhoto
Added stripped_thumb parameter in chatPhoto
Added thumb_version parameter in stickerSet
Added max_tip_amount, suggested_tip_amounts parameters in invoice
Changed type of start_param from string to flags.1?string in inputMediaInvoice
Added form_id parameter in payments.paymentForm
Added title, description, photo, tip_amount parameters in payments.paymentReceipt
Added schedule_start_subscribed, schedule_date parameters in groupCall
Added params parameter in groupCallParticipant

Scheme

userProfilePhoto#cc656077 flags:# has_video:flags.0?true photo_id:long photo_small:FileLocation photo_big:FileLocation stripped_thumb:flags.1?bytes dc_id:int = UserProfilePhoto;

chatPhoto#4790ee05 flags:# has_video:flags.0?true photo_small:FileLocation photo_big:FileLocation stripped_thumb:flags.1?bytes dc_id:int = ChatPhoto;

stickerSet#d7df217a flags:# archived:flags.1?true official:flags.2?true masks:flags.3?true animated:flags.5?true installed_date:flags.0?int id:long access_hash:long title:string short_name:string thumbs:flags.4?Vector<PhotoSize> thumb_dc_id:flags.4?int thumb_version:flags.4?int count:int hash:int = StickerSet;

invoice#0cd886e0 flags:# test:flags.0?true name_requested:flags.1?true phone_requested:flags.2?true email_requested:flags.3?true shipping_address_requested:flags.4?true flexible:flags.5?true phone_to_provider:flags.6?true email_to_provider:flags.7?true currency:string prices:Vector<LabeledPrice> max_tip_amount:flags.8?long suggested_tip_amounts:flags.8?Vector<long> = Invoice;
inputMediaInvoice#d9799874 flags:# title:string description:string photo:flags.0?InputWebDocument invoice:Invoice payload:bytes provider:string provider_data:DataJSON start_param:flags.1?string = InputMedia;

payments.paymentForm#8d0b2415 flags:# can_save_credentials:flags.2?true password_missing:flags.3?true form_id:long bot_id:int invoice:Invoice provider_id:int url:string native_provider:flags.4?string native_params:flags.4?DataJSON saved_info:flags.0?PaymentRequestedInfo saved_credentials:flags.1?PaymentSavedCredentials users:Vector<User> = payments.PaymentForm;
payments.paymentReceipt#10b555d0 flags:# date:int bot_id:int provider_id:int title:string description:string photo:flags.2?WebDocument invoice:Invoice info:flags.0?PaymentRequestedInfo shipping:flags.1?ShippingOption tip_amount:flags.3?long currency:string total_amount:long credentials_title:string users:Vector<User> = payments.PaymentReceipt;

groupCall#c95c6654 flags:# join_muted:flags.1?true can_change_join_muted:flags.2?true join_date_asc:flags.6?true schedule_start_subscribed:flags.8?true id:long access_hash:long participants_count:int params:flags.0?DataJSON title:flags.3?string stream_dc_id:flags.4?int record_start_date:flags.5?int schedule_date:flags.7?int version:int = GroupCall;
groupCallParticipant#b96b25ee flags:# muted:flags.0?true left:flags.1?true can_self_unmute:flags.2?true just_joined:flags.4?true versioned:flags.5?true min:flags.8?true muted_by_you:flags.9?true volume_by_admin:flags.10?true self:flags.12?true peer:Peer date:int active_date:flags.3?int source:int volume:flags.7?int about:flags.11?string raise_hand_rating:flags.13?long params:flags.6?DataJSON = GroupCallParticipant;

inputBotInlineMessageMediaInvoice#d7e78225 flags:# title:string description:string photo:flags.0?InputWebDocument invoice:Invoice payload:bytes provider:string provider_data:DataJSON reply_markup:flags.2?ReplyMarkup = InputBotInlineMessage;

botInlineMessageMediaInvoice#354a9b09 flags:# shipping_address_requested:flags.1?true test:flags.3?true title:string description:string photo:flags.0?WebDocument currency:string total_amount:long reply_markup:flags.2?ReplyMarkup = BotInlineMessage;

messageActionGroupCallScheduled#b3a07661 call:InputGroupCall schedule_date:int = MessageAction;

---functions---

payments.getPaymentForm#8a333c8d flags:# peer:InputPeer msg_id:int theme_params:flags.0?DataJSON = payments.PaymentForm;
payments.getPaymentReceipt#2478d1cc peer:InputPeer msg_id:int = payments.PaymentReceipt;
payments.validateRequestedInfo#db103170 flags:# save:flags.0?true peer:InputPeer msg_id:int info:PaymentRequestedInfo = payments.ValidatedRequestedInfo;
payments.sendPaymentForm#30c3bc9d flags:# form_id:long peer:InputPeer msg_id:int requested_info_id:flags.0?string shipping_option_id:flags.1?string credentials:InputPaymentCredentials tip_amount:flags.2?long = payments.PaymentResult;
phone.createGroupCall#48cdc6d8 flags:# peer:InputPeer random_id:int title:flags.0?string schedule_date:flags.1?int = Updates;
phone.toggleGroupCallStartSubscription#219c34e6 call:InputGroupCall subscribed:Bool = Updates;
phone.startScheduledGroupCall#5680e342 call:InputGroupCall = Updates;
phone.saveDefaultGroupCallJoinAs#575e1f8c peer:InputPeer join_as:InputPeer = Bool;

Layer 126

Scheme changes

Changed Methods

Added participant parameter, removed user_id parameter in channels.getParticipant
Added participant parameter, removed user_id parameter in channels.editBanned

Changed Constructors

Added chats parameter in channels.channelParticipants
Added chats parameter in channels.channelParticipant
Added peer parameter, removed user_id parameter in channelParticipantBanned
Added peer parameter, removed user_id parameter in channelParticipantLeft

Scheme

channels.channelParticipants#9ab0feaf count:int participants:Vector<ChannelParticipant> chats:Vector<Chat> users:Vector<User> = channels.ChannelParticipants;
channels.channelParticipant#dfb80317 participant:ChannelParticipant chats:Vector<Chat> users:Vector<User> = channels.ChannelParticipant;
channelParticipantBanned#50a1dfd6 flags:# left:flags.0?true peer:Peer kicked_by:int date:int banned_rights:ChatBannedRights = ChannelParticipant;
channelParticipantLeft#1b03f006 peer:Peer = ChannelParticipant;

---functions---

channels.getParticipant#a0ab6cc6 channel:InputChannel participant:InputPeer = channels.ChannelParticipant;
channels.editBanned#96e6cd81 channel:InputChannel participant:InputPeer banned_rights:ChatBannedRights = Updates;

Layer 125

Scheme changes

New Methods

Added phone.toggleGroupCallRecord - Start or stop recording a group call
Added phone.editGroupCallParticipant - Edit information about a given group call participant
Added phone.editGroupCallTitle - Edit the title of a group call or livestream
Added phone.getGroupCallJoinAs - Get a list of peers that can be used to join a group call, presenting yourself as a specific user/channel.
Added phone.exportGroupCallInvite - Get an invite link for a group call or livestream

Changed Methods

Added flags, url parameters, changed type of peer from InputPeer to flags.1?InputPeer, msg_id from int to flags.1?int, button_id from int to flags.1?int in messages.requestUrlAuth
Added url parameter, changed type of peer from InputPeer to flags.1?InputPeer, msg_id from int to flags.1?int, button_id from int to flags.1?int in messages.acceptUrlAuth
Added video_stopped, join_as, invite_hash parameters in phone.joinGroupCall
Added reset_invite_hash parameter in phone.toggleGroupCallSettings
Changed type of ids from Vector<int> to Vector<InputPeer> in phone.getGroupParticipants

Deleted Methods

Removed phone.editGroupCallMember

New Constructors

Added inputGroupCallStream - Chunk of a livestream
Added phone.joinAsPeers - A list of peers that can be used to join a group call, presenting yourself as a specific user/channel.
Added phone.exportedGroupCallInvite - An invite to a group call or livestream

Changed Constructors

Added groupcall_default_join_as parameter in chatFull
Added from_id parameter, removed user_id parameter in updateChatUserTyping
Added groupcall_default_join_as parameter in channelFull
Added from_id parameter, removed user_id parameter in updateChannelUserTyping
Added join_date_asc, title, stream_dc_id, record_start_date parameters in groupCall
Added self, peer, about, raise_hand_rating parameters, removed user_id parameter in groupCallParticipant
Added chats parameter in phone.groupCall
Added chats parameter in phone.groupParticipants

Scheme

chatFull#8a1e2983 flags:# can_set_username:flags.7?true has_scheduled:flags.8?true id:int about:string participants:ChatParticipants chat_photo:flags.2?Photo notify_settings:PeerNotifySettings exported_invite:flags.13?ExportedChatInvite bot_info:flags.3?Vector<BotInfo> pinned_msg_id:flags.6?int folder_id:flags.11?int call:flags.12?InputGroupCall ttl_period:flags.14?int groupcall_default_join_as:flags.15?Peer = ChatFull;

updateChatUserTyping#86cadb6c chat_id:int from_id:Peer action:SendMessageAction = Update;

channelFull#548c3f93 flags:# can_view_participants:flags.3?true can_set_username:flags.6?true can_set_stickers:flags.7?true hidden_prehistory:flags.10?true can_set_location:flags.16?true has_scheduled:flags.19?true can_view_stats:flags.20?true blocked:flags.22?true id:int about:string participants_count:flags.0?int admins_count:flags.1?int kicked_count:flags.2?int banned_count:flags.2?int online_count:flags.13?int read_inbox_max_id:int read_outbox_max_id:int unread_count:int chat_photo:Photo notify_settings:PeerNotifySettings exported_invite:flags.23?ExportedChatInvite bot_info:Vector<BotInfo> migrated_from_chat_id:flags.4?int migrated_from_max_id:flags.4?int pinned_msg_id:flags.5?int stickerset:flags.8?StickerSet available_min_id:flags.9?int folder_id:flags.11?int linked_chat_id:flags.14?int location:flags.15?ChannelLocation slowmode_seconds:flags.17?int slowmode_next_send_date:flags.18?int stats_dc:flags.12?int pts:int call:flags.21?InputGroupCall ttl_period:flags.24?int pending_suggestions:flags.25?Vector<string> groupcall_default_join_as:flags.26?Peer = ChatFull;

updateChannelUserTyping#6b171718 flags:# channel_id:int top_msg_id:flags.0?int from_id:Peer action:SendMessageAction = Update;

groupCall#c0c2052e flags:# join_muted:flags.1?true can_change_join_muted:flags.2?true join_date_asc:flags.6?true id:long access_hash:long participants_count:int params:flags.0?DataJSON title:flags.3?string stream_dc_id:flags.4?int record_start_date:flags.5?int version:int = GroupCall;
groupCallParticipant#19adba89 flags:# muted:flags.0?true left:flags.1?true can_self_unmute:flags.2?true just_joined:flags.4?true versioned:flags.5?true min:flags.8?true muted_by_you:flags.9?true volume_by_admin:flags.10?true self:flags.12?true peer:Peer date:int active_date:flags.3?int source:int volume:flags.7?int about:flags.11?string raise_hand_rating:flags.13?long = GroupCallParticipant;

phone.groupCall#9e727aad call:GroupCall participants:Vector<GroupCallParticipant> participants_next_offset:string chats:Vector<Chat> users:Vector<User> = phone.GroupCall;
phone.groupParticipants#f47751b6 count:int participants:Vector<GroupCallParticipant> next_offset:string chats:Vector<Chat> users:Vector<User> version:int = phone.GroupParticipants;

inputGroupCallStream#bba51639 call:InputGroupCall time_ms:long scale:int = InputFileLocation;

phone.joinAsPeers#afe5623f peers:Vector<Peer> chats:Vector<Chat> users:Vector<User> = phone.JoinAsPeers;
phone.exportedGroupCallInvite#204bd158 link:string = phone.ExportedGroupCallInvite;

---functions---

messages.requestUrlAuth#198fb446 flags:# peer:flags.1?InputPeer msg_id:flags.1?int button_id:flags.1?int url:flags.2?string = UrlAuthResult;
messages.acceptUrlAuth#b12c7125 flags:# write_allowed:flags.0?true peer:flags.1?InputPeer msg_id:flags.1?int button_id:flags.1?int url:flags.2?string = UrlAuthResult;

phone.joinGroupCall#b132ff7b flags:# muted:flags.0?true video_stopped:flags.2?true call:InputGroupCall join_as:InputPeer invite_hash:flags.1?string params:DataJSON = Updates;
phone.toggleGroupCallSettings#74bbb43d flags:# reset_invite_hash:flags.1?true call:InputGroupCall join_muted:flags.0?Bool = Updates;
phone.getGroupParticipants#c558d8ab call:InputGroupCall ids:Vector<InputPeer> sources:Vector<int> offset:string limit:int = phone.GroupParticipants;
phone.toggleGroupCallRecord#c02a66d7 flags:# start:flags.0?true call:InputGroupCall title:flags.1?string = Updates;
phone.editGroupCallParticipant#d975eb80 flags:# muted:flags.0?true call:InputGroupCall participant:InputPeer volume:flags.1?int raise_hand:flags.2?Bool = Updates;
phone.editGroupCallTitle#1ca6ac0a call:InputGroupCall title:string = Updates;
phone.getGroupCallJoinAs#ef7c213a peer:InputPeer = phone.JoinAsPeers;
phone.exportGroupCallInvite#e6aa647f flags:# can_self_unmute:flags.0?true call:InputGroupCall = phone.ExportedGroupCallInvite;

Layer 124

Scheme changes

New Methods

Added messages.getExportedChatInvites - Get info about the chat invites of a specific chat
Added messages.getExportedChatInvite - Get info about a chat invite
Added messages.editExportedChatInvite - Edit an exported chat invite
Added messages.deleteRevokedExportedChatInvites - Delete all revoked chat invites
Added messages.deleteExportedChatInvite - Delete a chat invite
Added messages.getAdminsWithInvites - Get info about chat invites generated by admins.
Added messages.getChatInviteImporters - Get info about the users that joined the chat using a specific chat invite
Added messages.setHistoryTTL - Set maximum Time-To-Live of all messages in the specified chat
Added account.reportProfilePhoto - Report a profile photo of a dialog
Added channels.convertToGigagroup - Convert a supergroup to a gigagroup
Added messages.checkHistoryImportPeer - Check whether chat history exported from another chat app can be imported into a specific Telegram chat.

Changed Methods

Added message parameter in account.reportPeer
Added message parameter in messages.report
Added flags, legacy_revoke_permanent, expire_date, usage_limit parameters in messages.exportChatInvite
Added peer parameter in help.dismissSuggestion

New Constructors

Added messageActionSetMessagesTTL - The Time-To-Live of messages in this chat was changed.
Added updatePeerHistoryTTL - The Time-To-Live for messages sent by the current user in a specific chat has changed
Added updateChatParticipant - A user has joined or left a specific chat
Added updateChannelParticipant - A participant has left, joined, was banned or admined in a channel or supergroup.
Added updateBotStopped - A bot was stopped or re-started.
Added chatInviteImporter - When and which user joined the chat using a chat invite
Added messages.exportedChatInvites - Info about chat invites exported by a certain admin.
Added messages.exportedChatInvite - Info about a chat invite
Added messages.exportedChatInviteReplaced - The specified chat invite was replaced with another one
Added messages.chatInviteImporters - Info about the users that joined the chat using a specific chat invite
Added chatAdminWithInvites - Info about chat invites generated by admins.
Added messages.chatAdminsWithInvites - Info about chat invites generated by admins.
Added channelAdminLogEventActionParticipantJoinByInvite - A user joined the supergroup/channel using a specific invite link
Added channelAdminLogEventActionExportedInviteDelete - A chat invite was deleted
Added channelAdminLogEventActionExportedInviteRevoke - A specific invite link was revoked
Added channelAdminLogEventActionExportedInviteEdit - A chat invite was edited
Added channelAdminLogEventActionParticipantVolume - channelAdminLogEvent.user_id has set the volume of participant.peer to participant.volume
Added channelAdminLogEventActionChangeHistoryTTL - The Time-To-Live of messages in this chat was changed
Added messages.checkedHistoryImportPeer - Contains a confirmation text to be shown to the user, upon importing chat history.

Changed Constructors

Added ttl_period parameter in chatFull
Added ttl_period parameter in message
Added ttl_period parameter in messageService
Removed text parameter in inputReportReasonOther
Added ttl_period parameter in userFull
Added ttl_period parameter in updateShortMessage
Added ttl_period parameter in updateShortChatMessage
Added ttl_period parameter in updateShortSentMessage
Added ttl_period, pending_suggestions parameters in channelFull

Scheme

chatFull#f06c4018 flags:# can_set_username:flags.7?true has_scheduled:flags.8?true id:int about:string participants:ChatParticipants chat_photo:flags.2?Photo notify_settings:PeerNotifySettings exported_invite:flags.13?ExportedChatInvite bot_info:flags.3?Vector<BotInfo> pinned_msg_id:flags.6?int folder_id:flags.11?int call:flags.12?InputGroupCall ttl_period:flags.14?int = ChatFull;

message#bce383d2 flags:# out:flags.1?true mentioned:flags.4?true media_unread:flags.5?true silent:flags.13?true post:flags.14?true from_scheduled:flags.18?true legacy:flags.19?true edit_hide:flags.21?true pinned:flags.24?true id:int from_id:flags.8?Peer peer_id:Peer fwd_from:flags.2?MessageFwdHeader via_bot_id:flags.11?int reply_to:flags.3?MessageReplyHeader date:int message:string media:flags.9?MessageMedia reply_markup:flags.6?ReplyMarkup entities:flags.7?Vector<MessageEntity> views:flags.10?int forwards:flags.10?int replies:flags.23?MessageReplies edit_date:flags.15?int post_author:flags.16?string grouped_id:flags.17?long restriction_reason:flags.22?Vector<RestrictionReason> ttl_period:flags.25?int = Message;
messageService#2b085862 flags:# out:flags.1?true mentioned:flags.4?true media_unread:flags.5?true silent:flags.13?true post:flags.14?true legacy:flags.19?true id:int from_id:flags.8?Peer peer_id:Peer reply_to:flags.3?MessageReplyHeader date:int action:MessageAction ttl_period:flags.25?int = Message;

inputReportReasonOther#c1e4a2b1 = ReportReason;

userFull#139a9a77 flags:# blocked:flags.0?true phone_calls_available:flags.4?true phone_calls_private:flags.5?true can_pin_message:flags.7?true has_scheduled:flags.12?true video_calls_available:flags.13?true user:User about:flags.1?string settings:PeerSettings profile_photo:flags.2?Photo notify_settings:PeerNotifySettings bot_info:flags.3?BotInfo pinned_msg_id:flags.6?int common_chats_count:int folder_id:flags.11?int ttl_period:flags.14?int = UserFull;
updateShortMessage#faeff833 flags:# out:flags.1?true mentioned:flags.4?true media_unread:flags.5?true silent:flags.13?true id:int user_id:int message:string pts:int pts_count:int date:int fwd_from:flags.2?MessageFwdHeader via_bot_id:flags.11?int reply_to:flags.3?MessageReplyHeader entities:flags.7?Vector<MessageEntity> ttl_period:flags.25?int = Updates;
updateShortChatMessage#1157b858 flags:# out:flags.1?true mentioned:flags.4?true media_unread:flags.5?true silent:flags.13?true id:int from_id:int chat_id:int message:string pts:int pts_count:int date:int fwd_from:flags.2?MessageFwdHeader via_bot_id:flags.11?int reply_to:flags.3?MessageReplyHeader entities:flags.7?Vector<MessageEntity> ttl_period:flags.25?int = Updates;
updateShortSentMessage#9015e101 flags:# out:flags.1?true id:int pts:int pts_count:int date:int media:flags.9?MessageMedia entities:flags.7?Vector<MessageEntity> ttl_period:flags.25?int = Updates;

channelFull#2548c037 flags:# can_view_participants:flags.3?true can_set_username:flags.6?true can_set_stickers:flags.7?true hidden_prehistory:flags.10?true can_set_location:flags.16?true has_scheduled:flags.19?true can_view_stats:flags.20?true blocked:flags.22?true id:int about:string participants_count:flags.0?int admins_count:flags.1?int kicked_count:flags.2?int banned_count:flags.2?int online_count:flags.13?int read_inbox_max_id:int read_outbox_max_id:int unread_count:int chat_photo:Photo notify_settings:PeerNotifySettings exported_invite:flags.23?ExportedChatInvite bot_info:Vector<BotInfo> migrated_from_chat_id:flags.4?int migrated_from_max_id:flags.4?int pinned_msg_id:flags.5?int stickerset:flags.8?StickerSet available_min_id:flags.9?int folder_id:flags.11?int linked_chat_id:flags.14?int location:flags.15?ChannelLocation slowmode_seconds:flags.17?int slowmode_next_send_date:flags.18?int stats_dc:flags.12?int pts:int call:flags.21?InputGroupCall ttl_period:flags.24?int pending_suggestions:flags.25?Vector<string> = ChatFull;

messageActionSetMessagesTTL#aa1afbfd period:int = MessageAction;

updatePeerHistoryTTL#bb9bb9a5 flags:# peer:Peer ttl_period:flags.0?int = Update;
updateChatParticipant#f3b3781f flags:# chat_id:int date:int actor_id:int user_id:int prev_participant:flags.0?ChatParticipant new_participant:flags.1?ChatParticipant invite:flags.2?ExportedChatInvite qts:int = Update;
updateChannelParticipant#7fecb1ec flags:# channel_id:int date:int actor_id:int user_id:int prev_participant:flags.0?ChannelParticipant new_participant:flags.1?ChannelParticipant invite:flags.2?ExportedChatInvite qts:int = Update;
updateBotStopped#07f9488a user_id:int date:int stopped:Bool qts:int = Update;

chatInviteImporter#1e3e6680 user_id:int date:int = ChatInviteImporter;

messages.exportedChatInvites#bdc62dcc count:int invites:Vector<ExportedChatInvite> users:Vector<User> = messages.ExportedChatInvites;
messages.exportedChatInvite#1871be50 invite:ExportedChatInvite users:Vector<User> = messages.ExportedChatInvite;
messages.exportedChatInviteReplaced#222600ef invite:ExportedChatInvite new_invite:ExportedChatInvite users:Vector<User> = messages.ExportedChatInvite;
messages.chatInviteImporters#81b6b00a count:int importers:Vector<ChatInviteImporter> users:Vector<User> = messages.ChatInviteImporters;

chatAdminWithInvites#dfd2330f admin_id:int invites_count:int revoked_invites_count:int = ChatAdminWithInvites;

messages.chatAdminsWithInvites#b69b72d7 admins:Vector<ChatAdminWithInvites> users:Vector<User> = messages.ChatAdminsWithInvites;

channelAdminLogEventActionParticipantJoinByInvite#5cdada77 invite:ExportedChatInvite = ChannelAdminLogEventAction;
channelAdminLogEventActionExportedInviteDelete#5a50fca4 invite:ExportedChatInvite = ChannelAdminLogEventAction;
channelAdminLogEventActionExportedInviteRevoke#410a134e invite:ExportedChatInvite = ChannelAdminLogEventAction;
channelAdminLogEventActionExportedInviteEdit#e90ebb59 prev_invite:ExportedChatInvite new_invite:ExportedChatInvite = ChannelAdminLogEventAction;
channelAdminLogEventActionParticipantVolume#3e7f6847 participant:GroupCallParticipant = ChannelAdminLogEventAction;
channelAdminLogEventActionChangeHistoryTTL#6e941a38 prev_value:int new_value:int = ChannelAdminLogEventAction;

messages.checkedHistoryImportPeer#a24de717 confirm_text:string = messages.CheckedHistoryImportPeer;

---functions---

account.reportPeer#c5ba3d86 peer:InputPeer reason:ReportReason message:string = Bool;

messages.report#8953ab4e peer:InputPeer id:Vector<int> reason:ReportReason message:string = Bool;
messages.exportChatInvite#14b9bcd7 flags:# legacy_revoke_permanent:flags.2?true peer:InputPeer expire_date:flags.0?int usage_limit:flags.1?int = ExportedChatInvite;

help.dismissSuggestion#f50dbaa1 peer:InputPeer suggestion:string = Bool;

messages.getExportedChatInvites#a2b5a3f6 flags:# revoked:flags.3?true peer:InputPeer admin_id:InputUser offset_date:flags.2?int offset_link:flags.2?string limit:int = messages.ExportedChatInvites;
messages.getExportedChatInvite#73746f5c peer:InputPeer link:string = messages.ExportedChatInvite;
messages.editExportedChatInvite#02e4ffbe flags:# revoked:flags.2?true peer:InputPeer link:string expire_date:flags.0?int usage_limit:flags.1?int = messages.ExportedChatInvite;
messages.deleteRevokedExportedChatInvites#56987bd5 peer:InputPeer admin_id:InputUser = Bool;
messages.deleteExportedChatInvite#d464a42b peer:InputPeer link:string = Bool;
messages.getAdminsWithInvites#3920e6ef peer:InputPeer = messages.ChatAdminsWithInvites;
messages.getChatInviteImporters#26fb7289 peer:InputPeer link:string offset_date:int offset_user:InputUser limit:int = messages.ChatInviteImporters;
messages.setHistoryTTL#b80e5fe4 peer:InputPeer period:int = Updates;

account.reportProfilePhoto#fa8cc6f5 peer:InputPeer photo_id:InputPhoto reason:ReportReason message:string = Bool;

channels.convertToGigagroup#0b290c69 channel:InputChannel = Updates;

messages.checkHistoryImportPeer#5dc60f03 peer:InputPeer = messages.CheckedHistoryImportPeer;

Layer 123

Scheme changes

New Methods

Added messages.deleteChat - Delete a chat
Added messages.deletePhoneCallHistory - Delete the entire phone call history.
Added messages.checkHistoryImport - Obtains information about a chat export file, generated by a foreign chat app.
Added messages.initHistoryImport - Import chat history from a foreign chat app into a specific Telegram chat.
Added messages.uploadImportedMedia - Upload a media file associated with an imported chat.
Added messages.startHistoryImport - Complete the history import process, importing all messages into the chat.

Changed Methods

Added flags, revoke_history parameters in messages.deleteChatUser
Added flags, delete_history parameters in messages.discardEncryption
Added volume parameter in phone.editGroupCallMember

New Constructors

Added inputPaymentCredentialsGooglePay - Google Pay payment credentials
Added messages.historyImport - ID of a specific chat import session
Added sendMessageHistoryImportAction - Chat history is being imported
Added messages.historyImportParsed - Contains information about a chat export file, generated by a foreign chat app.
Added inputReportReasonFake - Report for impersonation
Added messages.affectedFoundMessages - Messages found and affected by changes

Changed Constructors

Changed type of exported_invite from ExportedChatInvite to flags.13?ExportedChatInvite in chatFull
Added flags, peer_id parameters in messageEmpty
Added flags, history_deleted parameters in encryptedChatDiscarded
Added flags, revoked, permanent, admin_id, date, start_date, expire_date, usage_limit, usage parameters in chatInviteExported
Added fake parameter in user
Added fake, gigagroup parameters in channel
Changed type of exported_invite from ExportedChatInvite to flags.23?ExportedChatInvite in channelFull
Added min, muted_by_you, volume_by_admin, volume parameters in groupCallParticipant

Deleted Constructors

Removed chatInviteEmpty
Removed inputPaymentCredentialsAndroidPay

Scheme

chatFull#f3474af6 flags:# can_set_username:flags.7?true has_scheduled:flags.8?true id:int about:string participants:ChatParticipants chat_photo:flags.2?Photo notify_settings:PeerNotifySettings exported_invite:flags.13?ExportedChatInvite bot_info:flags.3?Vector<BotInfo> pinned_msg_id:flags.6?int folder_id:flags.11?int call:flags.12?InputGroupCall = ChatFull;

messageEmpty#90a6ca84 flags:# id:int peer_id:flags.0?Peer = Message;

encryptedChatDiscarded#1e1c7c45 flags:# history_deleted:flags.0?true id:int = EncryptedChat;

chatInviteExported#6e24fc9d flags:# revoked:flags.0?true permanent:flags.5?true link:string admin_id:int date:int start_date:flags.4?int expire_date:flags.1?int usage_limit:flags.2?int usage:flags.3?int = ExportedChatInvite;

user#938458c1 flags:# self:flags.10?true contact:flags.11?true mutual_contact:flags.12?true deleted:flags.13?true bot:flags.14?true bot_chat_history:flags.15?true bot_nochats:flags.16?true verified:flags.17?true restricted:flags.18?true min:flags.20?true bot_inline_geo:flags.21?true support:flags.23?true scam:flags.24?true apply_min_photo:flags.25?true fake:flags.26?true id:int access_hash:flags.0?long first_name:flags.1?string last_name:flags.2?string username:flags.3?string phone:flags.4?string photo:flags.5?UserProfilePhoto status:flags.6?UserStatus bot_info_version:flags.14?int restriction_reason:flags.18?Vector<RestrictionReason> bot_inline_placeholder:flags.19?string lang_code:flags.22?string = User;

channel#d31a961e flags:# creator:flags.0?true left:flags.2?true broadcast:flags.5?true verified:flags.7?true megagroup:flags.8?true restricted:flags.9?true signatures:flags.11?true min:flags.12?true scam:flags.19?true has_link:flags.20?true has_geo:flags.21?true slowmode_enabled:flags.22?true call_active:flags.23?true call_not_empty:flags.24?true fake:flags.25?true gigagroup:flags.26?true id:int access_hash:flags.13?long title:string username:flags.6?string photo:ChatPhoto date:int version:int restriction_reason:flags.9?Vector<RestrictionReason> admin_rights:flags.14?ChatAdminRights banned_rights:flags.15?ChatBannedRights default_banned_rights:flags.18?ChatBannedRights participants_count:flags.17?int = Chat;
channelFull#7a7de4f7 flags:# can_view_participants:flags.3?true can_set_username:flags.6?true can_set_stickers:flags.7?true hidden_prehistory:flags.10?true can_set_location:flags.16?true has_scheduled:flags.19?true can_view_stats:flags.20?true blocked:flags.22?true id:int about:string participants_count:flags.0?int admins_count:flags.1?int kicked_count:flags.2?int banned_count:flags.2?int online_count:flags.13?int read_inbox_max_id:int read_outbox_max_id:int unread_count:int chat_photo:Photo notify_settings:PeerNotifySettings exported_invite:flags.23?ExportedChatInvite bot_info:Vector<BotInfo> migrated_from_chat_id:flags.4?int migrated_from_max_id:flags.4?int pinned_msg_id:flags.5?int stickerset:flags.8?StickerSet available_min_id:flags.9?int folder_id:flags.11?int linked_chat_id:flags.14?int location:flags.15?ChannelLocation slowmode_seconds:flags.17?int slowmode_next_send_date:flags.18?int stats_dc:flags.12?int pts:int call:flags.21?InputGroupCall = ChatFull;

groupCallParticipant#64c62a15 flags:# muted:flags.0?true left:flags.1?true can_self_unmute:flags.2?true just_joined:flags.4?true versioned:flags.5?true min:flags.8?true muted_by_you:flags.9?true volume_by_admin:flags.10?true user_id:int date:int active_date:flags.3?int source:int volume:flags.7?int = GroupCallParticipant;

inputPaymentCredentialsGooglePay#8ac32801 payment_token:DataJSON = InputPaymentCredentials;

messages.historyImport#1662af0b id:long = messages.HistoryImport;

sendMessageHistoryImportAction#dbda9246 progress:int = SendMessageAction;

messages.historyImportParsed#5e0fb7b9 flags:# pm:flags.0?true group:flags.1?true title:flags.2?string = messages.HistoryImportParsed;

inputReportReasonFake#f5ddd6e7 = ReportReason;

messages.affectedFoundMessages#ef8d3e6c pts:int pts_count:int offset:int messages:Vector<int> = messages.AffectedFoundMessages;

---functions---

messages.deleteChatUser#c534459a flags:# revoke_history:flags.0?true chat_id:int user_id:InputUser = Updates;
messages.discardEncryption#f393aea0 flags:# delete_history:flags.0?true chat_id:int = Bool;

phone.editGroupCallMember#a5e76cd8 flags:# muted:flags.0?true call:InputGroupCall user_id:InputUser volume:flags.1?int = Updates;

messages.deleteChat#83247d11 chat_id:int = Bool;
messages.deletePhoneCallHistory#f9cbe409 flags:# revoke:flags.0?true = messages.AffectedFoundMessages;
messages.checkHistoryImport#43fe19f3 import_head:string = messages.HistoryImportParsed;
messages.initHistoryImport#34090c3b peer:InputPeer file:InputFile media_count:int = messages.HistoryImport;
messages.uploadImportedMedia#2a862092 peer:InputPeer import_id:long file_name:string media:InputMedia = MessageMedia;
messages.startHistoryImport#b43df344 peer:InputPeer import_id:long = Bool;

Layer 122

Scheme changes

New Methods

Added phone.createGroupCall - Create a group call or livestream
Added phone.joinGroupCall - Join a group call
Added phone.leaveGroupCall - Leave a group call
Added phone.editGroupCallMember
Added phone.inviteToGroupCall - Invite a set of users to a group call.
Added phone.discardGroupCall - Terminate a group call
Added phone.toggleGroupCallSettings - Change group call settings
Added phone.getGroupCall - Get info about a group call
Added phone.getGroupParticipants - Get group call participants
Added phone.checkGroupCall - Check whether the group call Server Forwarding Unit is currently receiving the streams with the specified WebRTC source IDs

Changed Methods

Added drop_author, drop_media_captions parameters in messages.forwardMessages
Added for_import parameter in channels.createChannel

New Constructors

Added speakingInGroupCallAction - User is currently speaking in the group call
Added groupCallDiscarded - An ended group call
Added groupCall - Info about a group call or livestream
Added inputGroupCall - Points to a specific group call
Added messageActionGroupCall - The group call has ended
Added messageActionInviteToGroupCall - A set of users was invited to the group call
Added groupCallParticipant - Info about a group call participant
Added updateChat - A new chat is available
Added updateGroupCallParticipants - The participant list of a certain group call has changed
Added updateGroupCall - A new groupcall was started
Added phone.groupCall - Contains info about a group call, and partial info about its participants.
Added phone.groupParticipants - Info about the participants of a group call or livestream
Added inlineQueryPeerTypeSameBotPM - The inline query was sent in a private chat with the bot itself
Added inlineQueryPeerTypePM - The inline query was sent in a private chat
Added inlineQueryPeerTypeChat - The inline query was sent in a chat
Added inlineQueryPeerTypeMegagroup - The inline query was sent in a supergroup
Added inlineQueryPeerTypeBroadcast - The inline query was sent in a channel
Added channelAdminLogEventActionStartGroupCall - A group call was started
Added channelAdminLogEventActionDiscardGroupCall - A group call was terminated
Added channelAdminLogEventActionParticipantMute - A group call participant was muted
Added channelAdminLogEventActionParticipantUnmute - A group call participant was unmuted
Added channelAdminLogEventActionToggleGroupCallSetting - Group call settings were changed

Changed Constructors

Added call_active, call_not_empty parameters in chat
Added call parameter in chatFull
Added invite_members parameter in peerSettings
Added query parameter in inputMediaDocument
Added thumbs parameter, removed thumb parameter in stickerSet
Added call_active, call_not_empty parameters in channel
Added call parameter in channelFull
Added peer_type parameter in updateBotInlineQuery
Added imported parameter in messageFwdHeader
Added group_call, invites parameters in channelAdminLogEventsFilter
Added manage_call, other parameters in chatAdminRights

Deleted Constructors

Removed updateChannelParticipant

Scheme

chat#3bda1bde flags:# creator:flags.0?true kicked:flags.1?true left:flags.2?true deactivated:flags.5?true call_active:flags.23?true call_not_empty:flags.24?true id:int title:string photo:ChatPhoto participants_count:int date:int version:int migrated_to:flags.6?InputChannel admin_rights:flags.14?ChatAdminRights default_banned_rights:flags.18?ChatBannedRights = Chat;
chatFull#0dc8c181 flags:# can_set_username:flags.7?true has_scheduled:flags.8?true id:int about:string participants:ChatParticipants chat_photo:flags.2?Photo notify_settings:PeerNotifySettings exported_invite:ExportedChatInvite bot_info:flags.3?Vector<BotInfo> pinned_msg_id:flags.6?int folder_id:flags.11?int call:flags.12?InputGroupCall = ChatFull;

peerSettings#733f2961 flags:# report_spam:flags.0?true add_contact:flags.1?true block_contact:flags.2?true share_contact:flags.3?true need_contacts_exception:flags.4?true report_geo:flags.5?true autoarchived:flags.7?true invite_members:flags.8?true geo_distance:flags.6?int = PeerSettings;

inputMediaDocument#33473058 flags:# id:InputDocument ttl_seconds:flags.0?int query:flags.1?string = InputMedia;

stickerSet#40e237a8 flags:# archived:flags.1?true official:flags.2?true masks:flags.3?true animated:flags.5?true installed_date:flags.0?int id:long access_hash:long title:string short_name:string thumbs:flags.4?Vector<PhotoSize> thumb_dc_id:flags.4?int count:int hash:int = StickerSet;

channel#d31a961e flags:# creator:flags.0?true left:flags.2?true broadcast:flags.5?true verified:flags.7?true megagroup:flags.8?true restricted:flags.9?true signatures:flags.11?true min:flags.12?true scam:flags.19?true has_link:flags.20?true has_geo:flags.21?true slowmode_enabled:flags.22?true call_active:flags.23?true call_not_empty:flags.24?true id:int access_hash:flags.13?long title:string username:flags.6?string photo:ChatPhoto date:int version:int restriction_reason:flags.9?Vector<RestrictionReason> admin_rights:flags.14?ChatAdminRights banned_rights:flags.15?ChatBannedRights default_banned_rights:flags.18?ChatBannedRights participants_count:flags.17?int = Chat;
channelFull#ef3a6acd flags:# can_view_participants:flags.3?true can_set_username:flags.6?true can_set_stickers:flags.7?true hidden_prehistory:flags.10?true can_set_location:flags.16?true has_scheduled:flags.19?true can_view_stats:flags.20?true blocked:flags.22?true id:int about:string participants_count:flags.0?int admins_count:flags.1?int kicked_count:flags.2?int banned_count:flags.2?int online_count:flags.13?int read_inbox_max_id:int read_outbox_max_id:int unread_count:int chat_photo:Photo notify_settings:PeerNotifySettings exported_invite:ExportedChatInvite bot_info:Vector<BotInfo> migrated_from_chat_id:flags.4?int migrated_from_max_id:flags.4?int pinned_msg_id:flags.5?int stickerset:flags.8?StickerSet available_min_id:flags.9?int folder_id:flags.11?int linked_chat_id:flags.14?int location:flags.15?ChannelLocation slowmode_seconds:flags.17?int slowmode_next_send_date:flags.18?int stats_dc:flags.12?int pts:int call:flags.21?InputGroupCall = ChatFull;

updateBotInlineQuery#3f2038db flags:# query_id:long user_id:int query:string geo:flags.0?GeoPoint peer_type:flags.1?InlineQueryPeerType offset:string = Update;

messageFwdHeader#5f777dce flags:# imported:flags.7?true from_id:flags.0?Peer from_name:flags.5?string date:int channel_post:flags.2?int post_author:flags.3?string saved_from_peer:flags.4?Peer saved_from_msg_id:flags.4?int psa_type:flags.6?string = MessageFwdHeader;

channelAdminLogEventsFilter#ea107ae4 flags:# join:flags.0?true leave:flags.1?true invite:flags.2?true ban:flags.3?true unban:flags.4?true kick:flags.5?true unkick:flags.6?true promote:flags.7?true demote:flags.8?true info:flags.9?true settings:flags.10?true pinned:flags.11?true edit:flags.12?true delete:flags.13?true group_call:flags.14?true invites:flags.15?true = ChannelAdminLogEventsFilter;
chatAdminRights#5fb224d5 flags:# change_info:flags.0?true post_messages:flags.1?true edit_messages:flags.2?true delete_messages:flags.3?true ban_users:flags.4?true invite_users:flags.5?true pin_messages:flags.7?true add_admins:flags.9?true anonymous:flags.10?true manage_call:flags.11?true other:flags.12?true = ChatAdminRights;

speakingInGroupCallAction#d92c2285 = SendMessageAction;

groupCallDiscarded#7780bcb4 id:long access_hash:long duration:int = GroupCall;
groupCall#55903081 flags:# join_muted:flags.1?true can_change_join_muted:flags.2?true id:long access_hash:long participants_count:int params:flags.0?DataJSON version:int = GroupCall;

inputGroupCall#d8aa840f id:long access_hash:long = InputGroupCall;

messageActionGroupCall#7a0d7f42 flags:# call:InputGroupCall duration:flags.0?int = MessageAction;
messageActionInviteToGroupCall#76b9f11a call:InputGroupCall users:Vector<int> = MessageAction;

groupCallParticipant#56b087c9 flags:# muted:flags.0?true left:flags.1?true can_self_unmute:flags.2?true just_joined:flags.4?true versioned:flags.5?true user_id:int date:int active_date:flags.3?int source:int = GroupCallParticipant;

updateChat#1330a196 chat_id:int = Update;
updateGroupCallParticipants#f2ebdb4e call:InputGroupCall participants:Vector<GroupCallParticipant> version:int = Update;
updateGroupCall#a45eb99b chat_id:int call:GroupCall = Update;

phone.groupCall#66ab0bfc call:GroupCall participants:Vector<GroupCallParticipant> participants_next_offset:string users:Vector<User> = phone.GroupCall;
phone.groupParticipants#9cfeb92d count:int participants:Vector<GroupCallParticipant> next_offset:string users:Vector<User> version:int = phone.GroupParticipants;

inlineQueryPeerTypeSameBotPM#3081ed9d = InlineQueryPeerType;
inlineQueryPeerTypePM#833c0fac = InlineQueryPeerType;
inlineQueryPeerTypeChat#d766c50a = InlineQueryPeerType;
inlineQueryPeerTypeMegagroup#5ec4be43 = InlineQueryPeerType;
inlineQueryPeerTypeBroadcast#6334ee9a = InlineQueryPeerType;

channelAdminLogEventActionStartGroupCall#23209745 call:InputGroupCall = ChannelAdminLogEventAction;
channelAdminLogEventActionDiscardGroupCall#db9f9140 call:InputGroupCall = ChannelAdminLogEventAction;
channelAdminLogEventActionParticipantMute#f92424d2 participant:GroupCallParticipant = ChannelAdminLogEventAction;
channelAdminLogEventActionParticipantUnmute#e64429c0 participant:GroupCallParticipant = ChannelAdminLogEventAction;
channelAdminLogEventActionToggleGroupCallSetting#56d6a247 join_muted:Bool = ChannelAdminLogEventAction;

---functions---

messages.forwardMessages#d9fee60e flags:# silent:flags.5?true background:flags.6?true with_my_score:flags.8?true drop_author:flags.11?true drop_media_captions:flags.12?true from_peer:InputPeer id:Vector<int> random_id:Vector<long> to_peer:InputPeer schedule_date:flags.10?int = Updates;

channels.createChannel#3d5fb10f flags:# broadcast:flags.0?true megagroup:flags.1?true for_import:flags.3?true title:string about:string geo_point:flags.2?InputGeoPoint address:flags.2?string = Updates;

phone.createGroupCall#bd3dabe0 peer:InputPeer random_id:int = Updates;
phone.joinGroupCall#5f9c8e62 flags:# muted:flags.0?true call:InputGroupCall params:DataJSON = Updates;
phone.leaveGroupCall#500377f9 call:InputGroupCall source:int = Updates;
phone.editGroupCallMember#63146ae4 flags:# muted:flags.0?true call:InputGroupCall user_id:InputUser = Updates;
phone.inviteToGroupCall#7b393160 call:InputGroupCall users:Vector<InputUser> = Updates;
phone.discardGroupCall#7a777135 call:InputGroupCall = Updates;
phone.toggleGroupCallSettings#74bbb43d flags:# call:InputGroupCall join_muted:flags.0?Bool = Updates;
phone.getGroupCall#0c7cb017 call:InputGroupCall = phone.GroupCall;
phone.getGroupParticipants#c9f1d285 call:InputGroupCall ids:Vector<int> sources:Vector<int> offset:string limit:int = phone.GroupParticipants;
phone.checkGroupCall#b74a7bea call:InputGroupCall source:int = Bool;

Layer 121

Added SVG path previews for animated stickers.

Scheme changes

New Constructors

Added photoPathSize - Messages with animated stickers can have a compressed svg (< 300 bytes) to show the outline of the sticker before fetching the actual lottie animation.

Scheme

photoPathSize#d8214d41 type:string bytes:bytes = PhotoSize;

Layer 120

Added message statistics, and a method to unpin all pinned messages in a chat.

Scheme changes

New Methods

Added stats.getMessagePublicForwards - Obtains a list of messages, indicating to which other public channels was a channel message forwarded.
Added stats.getMessageStats - Get message statistics
Added messages.unpinAllMessages - Unpin all pinned messages

Changed Methods

Changed type of from_id from flags.0?InputUser to flags.0?InputPeer in messages.search

New Constructors

Added inputMessageCallbackQuery - Used by bots for fetching information about the message that originated a callback query
Added channelParticipantLeft - A participant that left the channel/supergroup
Added channelParticipantsMentions - This filter is used when looking for supergroup members to mention.
Added updatePinnedMessages - Some messages were pinned in a chat
Added updatePinnedChannelMessages - Messages were pinned/unpinned in a channel/supergroup
Added inputMessagesFilterPinned - Fetch only pinned messages
Added stats.messageStats - Message statistics
Added messageActionGeoProximityReached - A user of the chat is now in proximity of another user

Changed Constructors

Added flags, accuracy_radius parameters in inputGeoPoint
Added flags, accuracy_radius parameters in geoPoint
Added offset_id_offset parameter in messages.messagesSlice
Added offset_id_offset parameter in messages.channelMessages
Added heading, proximity_notification_radius parameters, changed type of period from int to flags.1?int in inputBotInlineMessageMediaGeo
Added heading, proximity_notification_radius parameters, changed type of period from int to flags.1?int in botInlineMessageMediaGeo
Added heading, proximity_notification_radius parameters in inputMediaGeoLive
Added flags, heading, proximity_notification_radius parameters in messageMediaGeoLive

Deleted Constructors

Removed updateChannelPinnedMessage
Removed updateUserPinnedMessage
Removed updateChatPinnedMessage

PUSH notification changes

New PUSH notifications

Added MESSAGE_PLAYLIST - {1} sent you {2} music files
Added MESSAGE_DOCS - {1} sent you {2} files
Added CHAT_MESSAGE_PLAYLIST - {1} sent {3} music files to the group {2}
Added CHAT_MESSAGE_DOCS - {1} sent {3} files to the group {2}
Added CHANNEL_MESSAGE_PLAYLIST - {1} posted {2} music files
Added CHANNEL_MESSAGE_DOCS - {1} posted {2} files

Scheme

inputGeoPoint#48222faf flags:# lat:double long:double accuracy_radius:flags.0?int = InputGeoPoint;

geoPoint#b2a2f663 flags:# long:double lat:double access_hash:long accuracy_radius:flags.0?int = GeoPoint;

messages.messagesSlice#3a54685e flags:# inexact:flags.1?true count:int next_rate:flags.0?int offset_id_offset:flags.2?int messages:Vector<Message> chats:Vector<Chat> users:Vector<User> = messages.Messages;
messages.channelMessages#64479808 flags:# inexact:flags.1?true pts:int count:int offset_id_offset:flags.2?int messages:Vector<Message> chats:Vector<Chat> users:Vector<User> = messages.Messages;

inputBotInlineMessageMediaGeo#96929a85 flags:# geo_point:InputGeoPoint heading:flags.0?int period:flags.1?int proximity_notification_radius:flags.3?int reply_markup:flags.2?ReplyMarkup = InputBotInlineMessage;

botInlineMessageMediaGeo#051846fd flags:# geo:GeoPoint heading:flags.0?int period:flags.1?int proximity_notification_radius:flags.3?int reply_markup:flags.2?ReplyMarkup = BotInlineMessage;

inputMediaGeoLive#971fa843 flags:# stopped:flags.0?true geo_point:InputGeoPoint heading:flags.2?int period:flags.1?int proximity_notification_radius:flags.3?int = InputMedia;

messageMediaGeoLive#b940c666 flags:# geo:GeoPoint heading:flags.0?int period:int proximity_notification_radius:flags.1?int = MessageMedia;

inputMessageCallbackQuery#acfa1a7e id:int query_id:long = InputMessage;

channelParticipantLeft#c3c6796b user_id:int = ChannelParticipant;
channelParticipantsMentions#e04b5ceb flags:# q:flags.0?string top_msg_id:flags.1?int = ChannelParticipantsFilter;

updatePinnedMessages#ed85eab5 flags:# pinned:flags.0?true peer:Peer messages:Vector<int> pts:int pts_count:int = Update;
updatePinnedChannelMessages#8588878b flags:# pinned:flags.0?true channel_id:int messages:Vector<int> pts:int pts_count:int = Update;

inputMessagesFilterPinned#1bb00451 = MessagesFilter;

stats.messageStats#8999f295 views_graph:StatsGraph = stats.MessageStats;

messageActionGeoProximityReached#98e0d697 from_id:Peer to_id:Peer distance:int = MessageAction;

---functions---

messages.search#0c352eec flags:# peer:InputPeer q:string from_id:flags.0?InputPeer top_msg_id:flags.1?int filter:MessagesFilter min_date:int max_date:int offset_id:int add_offset:int limit:int max_id:int min_id:int hash:int = messages.Messages;

stats.getMessagePublicForwards#5630281b channel:InputChannel msg_id:int offset_rate:int offset_peer:InputPeer offset_id:int limit:int = messages.Messages;
stats.getMessageStats#b6e0a3f5 flags:# dark:flags.0?true channel:InputChannel msg_id:int = stats.MessageStats;

messages.unpinAllMessages#f025bc8b peer:InputPeer = messages.AffectedHistory;

Layer 119

Added message threads and comment sections in channel posts.

Scheme changes

New Methods

Added messages.getReplies - Get messages in a reply thread
Added messages.getDiscussionMessage - Get discussion message from the associated discussion group of a channel to show it on top of the comment section, without actually joining the group
Added messages.readDiscussion - Mark a thread as read
Added contacts.blockFromReplies - Stop getting notifications about thread replies of a certain user in @replies

Changed Methods

Changed type of id from InputUser to InputPeer in contacts.block
Changed type of id from InputUser to InputPeer in contacts.unblock
Added top_msg_id parameter in messages.search
Added flags, top_msg_id parameters in messages.setTyping
Changed type of messages.getMessagesViews from Vector<int> to messages.MessageViews
Added filter, min_date, max_date parameters in messages.searchGlobal
Added flags, thread parameters, changed type of grouped from Bool to flags.0?true in channels.exportMessageLink

New Constructors

Added messageViews - View, forward counter + info about replies of a specific message
Added updateChannelMessageForwards - The forward counter of a message in a channel has changed
Added photoSizeProgressive - Progressively encoded photosize
Added messages.messageViews - View, forward counter + info about replies
Added updateReadChannelDiscussionInbox - Incoming comments in a discussion thread were marked as read
Added updateReadChannelDiscussionOutbox - Outgoing comments in a discussion thread were marked as read
Added messages.discussionMessage - Information about a message thread
Added messageReplyHeader - Message replies and thread information
Added messageReplies - Info about the comment section of a channel post, or a simple message thread
Added updatePeerBlocked - A peer was blocked
Added peerBlocked - Information about a blocked peer
Added updateChannelUserTyping - A user is typing in a supergroup, channel or message thread

Changed Constructors

Added pinned, peer_id, reply_to, forwards, replies parameters, removed to_id, reply_to_msg_id parameters, changed type of from_id from flags.8?int to flags.8?Peer in message
Added peer_id, reply_to parameters, removed to_id, reply_to_msg_id parameters, changed type of from_id from flags.8?int to flags.8?Peer in messageService
Added chats parameter, changed type of blocked from Vector<ContactBlocked> to Vector<PeerBlocked> in contacts.blocked
Added chats parameter, changed type of blocked from Vector<ContactBlocked> to Vector<PeerBlocked> in contacts.blockedSlice
Added reply_to parameter, removed reply_to_msg_id parameter in updateShortMessage
Added reply_to parameter, removed reply_to_msg_id parameter in updateShortChatMessage
Added admin_rights parameter in channelParticipantCreator
Removed channel_id parameter, changed type of from_id from flags.0?int to flags.0?Peer in messageFwdHeader

Deleted Constructors

Removed contactBlocked
Removed updateUserBlocked

Scheme

message#58ae39c9 flags:# out:flags.1?true mentioned:flags.4?true media_unread:flags.5?true silent:flags.13?true post:flags.14?true from_scheduled:flags.18?true legacy:flags.19?true edit_hide:flags.21?true pinned:flags.24?true id:int from_id:flags.8?Peer peer_id:Peer fwd_from:flags.2?MessageFwdHeader via_bot_id:flags.11?int reply_to:flags.3?MessageReplyHeader date:int message:string media:flags.9?MessageMedia reply_markup:flags.6?ReplyMarkup entities:flags.7?Vector<MessageEntity> views:flags.10?int forwards:flags.10?int replies:flags.23?MessageReplies edit_date:flags.15?int post_author:flags.16?string grouped_id:flags.17?long restriction_reason:flags.22?Vector<RestrictionReason> = Message;
messageService#286fa604 flags:# out:flags.1?true mentioned:flags.4?true media_unread:flags.5?true silent:flags.13?true post:flags.14?true legacy:flags.19?true id:int from_id:flags.8?Peer peer_id:Peer reply_to:flags.3?MessageReplyHeader date:int action:MessageAction = Message;

contacts.blocked#0ade1591 blocked:Vector<PeerBlocked> chats:Vector<Chat> users:Vector<User> = contacts.Blocked;
contacts.blockedSlice#e1664194 count:int blocked:Vector<PeerBlocked> chats:Vector<Chat> users:Vector<User> = contacts.Blocked;

updateShortMessage#2296d2c8 flags:# out:flags.1?true mentioned:flags.4?true media_unread:flags.5?true silent:flags.13?true id:int user_id:int message:string pts:int pts_count:int date:int fwd_from:flags.2?MessageFwdHeader via_bot_id:flags.11?int reply_to:flags.3?MessageReplyHeader entities:flags.7?Vector<MessageEntity> = Updates;
updateShortChatMessage#402d5dbb flags:# out:flags.1?true mentioned:flags.4?true media_unread:flags.5?true silent:flags.13?true id:int from_id:int chat_id:int message:string pts:int pts_count:int date:int fwd_from:flags.2?MessageFwdHeader via_bot_id:flags.11?int reply_to:flags.3?MessageReplyHeader entities:flags.7?Vector<MessageEntity> = Updates;

channelParticipantCreator#447dca4b flags:# user_id:int admin_rights:ChatAdminRights rank:flags.0?string = ChannelParticipant;

messageFwdHeader#5f777dce flags:# from_id:flags.0?Peer from_name:flags.5?string date:int channel_post:flags.2?int post_author:flags.3?string saved_from_peer:flags.4?Peer saved_from_msg_id:flags.4?int psa_type:flags.6?string = MessageFwdHeader;
messageViews#455b853d flags:# views:flags.0?int forwards:flags.1?int replies:flags.2?MessageReplies = MessageViews;

updateChannelMessageForwards#6e8a84df channel_id:int id:int forwards:int = Update;

photoSizeProgressive#5aa86a51 type:string location:FileLocation w:int h:int sizes:Vector<int> = PhotoSize;

messages.messageViews#b6c4f543 views:Vector<MessageViews> chats:Vector<Chat> users:Vector<User> = messages.MessageViews;

updateReadChannelDiscussionInbox#1cc7de54 flags:# channel_id:int top_msg_id:int read_max_id:int broadcast_id:flags.0?int broadcast_post:flags.0?int = Update;
updateReadChannelDiscussionOutbox#4638a26c channel_id:int top_msg_id:int read_max_id:int = Update;

messages.discussionMessage#f5dd8f9d flags:# messages:Vector<Message> max_id:flags.0?int read_inbox_max_id:flags.1?int read_outbox_max_id:flags.2?int chats:Vector<Chat> users:Vector<User> = messages.DiscussionMessage;
messageReplyHeader#a6d57763 flags:# reply_to_msg_id:int reply_to_peer_id:flags.0?Peer reply_to_top_id:flags.1?int = MessageReplyHeader;
messageReplies#4128faac flags:# comments:flags.0?true replies:int replies_pts:int recent_repliers:flags.1?Vector<Peer> channel_id:flags.0?int max_id:flags.2?int read_max_id:flags.3?int = MessageReplies;

updatePeerBlocked#246a4b22 peer_id:Peer blocked:Bool = Update;

peerBlocked#e8fd8014 peer_id:Peer date:int = PeerBlocked;

updateChannelUserTyping#ff2abe9f flags:# channel_id:int top_msg_id:flags.0?int user_id:int action:SendMessageAction = Update;

---functions---

contacts.block#68cc1411 id:InputPeer = Bool;
contacts.unblock#bea65d50 id:InputPeer = Bool;

messages.search#4e17810b flags:# peer:InputPeer q:string from_id:flags.0?InputUser top_msg_id:flags.1?int filter:MessagesFilter min_date:int max_date:int offset_id:int add_offset:int limit:int max_id:int min_id:int hash:int = messages.Messages;
messages.setTyping#58943ee2 flags:# peer:InputPeer top_msg_id:flags.0?int action:SendMessageAction = Bool;
messages.getMessagesViews#5784d3e1 peer:InputPeer id:Vector<int> increment:Bool = messages.MessageViews;
messages.searchGlobal#4bc6589a flags:# folder_id:flags.0?int q:string filter:MessagesFilter min_date:int max_date:int offset_rate:int offset_peer:InputPeer offset_id:int limit:int = messages.Messages;

channels.exportMessageLink#e63fadeb flags:# grouped:flags.0?true thread:flags.1?true channel:InputChannel id:int = ExportedMessageLink;

messages.getReplies#24b581ba peer:InputPeer msg_id:int offset_id:int offset_date:int add_offset:int limit:int max_id:int min_id:int hash:int = messages.Messages;
messages.getDiscussionMessage#446972fd peer:InputPeer msg_id:int = messages.DiscussionMessage;
messages.readDiscussion#f731a9f4 peer:InputPeer msg_id:int read_max_id:int = Bool;

contacts.blockFromReplies#29a8962c flags:# delete_message:flags.0?true delete_history:flags.1?true report_spam:flags.2?true msg_id:int = Updates;

Layer 118

Added method for fetching country names and phone patterns.

Scheme changes

New Methods

Added help.getCountriesList - Get name, ISO code, localized name and phone codes/patterns of all available countries

Changed Methods

Added flags, silent parameters in messages.sendEncrypted
Added flags, silent parameters in messages.sendEncryptedFile
Added password parameter in messages.getBotCallbackAnswer

New Constructors

Added help.countryCode - Country code and phone number pattern of a specific country
Added help.country - Name, ISO code, localized name and phone codes/patterns of a specific country
Added help.countriesListNotModified - The country list has not changed
Added help.countriesList - Name, ISO code, localized name and phone codes/patterns of all available countries

Changed Constructors

Added flags, requires_password parameters in keyboardButtonCallback

Scheme

keyboardButtonCallback#35bbdb6b flags:# requires_password:flags.0?true text:string data:bytes = KeyboardButton;

help.countryCode#4203c5ef flags:# country_code:string prefixes:flags.0?Vector<string> patterns:flags.1?Vector<string> = help.CountryCode;
help.country#c3878e23 flags:# hidden:flags.0?true iso2:string default_name:string name:flags.1?string country_codes:Vector<help.CountryCode> = help.Country;
help.countriesListNotModified#93cc1f32 = help.CountriesList;
help.countriesList#87d0759e countries:Vector<help.Country> hash:int = help.CountriesList;

---functions---

messages.sendEncrypted#44fa7a15 flags:# silent:flags.0?true peer:InputEncryptedChat random_id:long data:bytes = messages.SentEncryptedMessage;
messages.sendEncryptedFile#5559481d flags:# silent:flags.0?true peer:InputEncryptedChat random_id:long data:bytes file:InputEncryptedFile = messages.SentEncryptedMessage;
messages.getBotCallbackAnswer#9342ca07 flags:# game:flags.1?true peer:InputPeer msg_id:int data:flags.0?bytes password:flags.2?InputCheckPasswordSRP = messages.BotCallbackAnswer;

help.getCountriesList#735787a8 lang_code:string hash:int = help.CountriesList;

Layer 117

Added WebRTC endpoint constructors.

Scheme changes

New Constructors

Added phoneConnectionWebrtc - WebRTC connection parameters

Scheme

phoneConnectionWebrtc#635fe375 flags:# turn:flags.0?true stun:flags.1?true id:long ip:string ipv6:string port:int username:string password:string = PhoneConnection;

Layer 116

Added supergroup statistics and global privacy settings.

Scheme changes

New Methods

Added stats.getMegagroupStats - Get supergroup statistics
Added account.getGlobalPrivacySettings - Get global privacy settings
Added account.setGlobalPrivacySettings - Set global privacy settings
Added help.dismissSuggestion - Dismiss a suggestion

Changed Methods

Changed type of photos.updateProfilePhoto from UserProfilePhoto to photos.Photo
Added flags, video, video_start_ts parameters, changed type of file from InputFile to flags.0?InputFile in photos.uploadProfilePhoto

New Constructors

Added statsGroupTopPoster - Information about an active user in a supergroup
Added statsGroupTopAdmin - Information about an active admin in a supergroup
Added statsGroupTopInviter - Information about an active supergroup inviter
Added stats.megagroupStats - Supergroup statistics
Added globalPrivacySettings - Global privacy settings
Added updateChannelParticipant - A participant has left, joined, was banned or admined in a channel or supergroup.

Changed Constructors

Added flags, video, video_start_ts parameters, changed type of file from InputFile to flags.0?InputFile in inputChatUploadedPhoto
Added flags, has_video parameters in userProfilePhoto
Added flags, has_video parameters in chatPhoto
Added video_sizes parameter in photo
Added autoarchived, geo_distance parameters in peerSettings
Added flags, folder_id parameters in encryptedChatRequested
Added flags, video_start_ts parameters in videoSize

Scheme

inputChatUploadedPhoto#c642724e flags:# file:flags.0?InputFile video:flags.1?InputFile video_start_ts:flags.2?double = InputChatPhoto;

userProfilePhoto#69d3ab26 flags:# has_video:flags.0?true photo_id:long photo_small:FileLocation photo_big:FileLocation dc_id:int = UserProfilePhoto;

chatPhoto#d20b9f3c flags:# has_video:flags.0?true photo_small:FileLocation photo_big:FileLocation dc_id:int = ChatPhoto;

photo#fb197a65 flags:# has_stickers:flags.0?true id:long access_hash:long file_reference:bytes date:int sizes:Vector<PhotoSize> video_sizes:flags.1?Vector<VideoSize> dc_id:int = Photo;
peerSettings#733f2961 flags:# report_spam:flags.0?true add_contact:flags.1?true block_contact:flags.2?true share_contact:flags.3?true need_contacts_exception:flags.4?true report_geo:flags.5?true autoarchived:flags.7?true geo_distance:flags.6?int = PeerSettings;

encryptedChatRequested#62718a82 flags:# folder_id:flags.0?int id:int access_hash:long date:int admin_id:int participant_id:int g_a:bytes = EncryptedChat;

videoSize#e831c556 flags:# type:string location:FileLocation w:int h:int size:int video_start_ts:flags.0?double = VideoSize;

statsGroupTopPoster#18f3d0f7 user_id:int messages:int avg_chars:int = StatsGroupTopPoster;
statsGroupTopAdmin#6014f412 user_id:int deleted:int kicked:int banned:int = StatsGroupTopAdmin;
statsGroupTopInviter#31962a4c user_id:int invitations:int = StatsGroupTopInviter;
stats.megagroupStats#ef7ff916 period:StatsDateRangeDays members:StatsAbsValueAndPrev messages:StatsAbsValueAndPrev viewers:StatsAbsValueAndPrev posters:StatsAbsValueAndPrev growth_graph:StatsGraph members_graph:StatsGraph new_members_by_source_graph:StatsGraph languages_graph:StatsGraph messages_graph:StatsGraph actions_graph:StatsGraph top_hours_graph:StatsGraph weekdays_graph:StatsGraph top_posters:Vector<StatsGroupTopPoster> top_admins:Vector<StatsGroupTopAdmin> top_inviters:Vector<StatsGroupTopInviter> users:Vector<User> = stats.MegagroupStats;

globalPrivacySettings#bea2f424 flags:# archive_and_mute_new_noncontact_peers:flags.0?Bool = GlobalPrivacySettings;

updateChannelParticipant#65d2b464 flags:# channel_id:int date:int user_id:int prev_participant:flags.0?ChannelParticipant new_participant:flags.1?ChannelParticipant qts:int = Update;

---functions---

photos.updateProfilePhoto#72d4742c id:InputPhoto = photos.Photo;
photos.uploadProfilePhoto#89f30f69 flags:# file:flags.0?InputFile video:flags.1?InputFile video_start_ts:flags.2?double = photos.Photo;

stats.getMegagroupStats#dcdf8607 flags:# dark:flags.0?true channel:InputChannel = stats.MegagroupStats;

account.getGlobalPrivacySettings#eb2b4cf6 = GlobalPrivacySettings;
account.setGlobalPrivacySettings#1edaaac2 settings:GlobalPrivacySettings = GlobalPrivacySettings;

help.dismissSuggestion#077fa99f suggestion:string = Bool;

Layer 115

Added a chat invitation that also allows peeking into the group to read messages without joining it.

Scheme changes

New Constructors

Added chatInvitePeek - A chat invitation that also allows peeking into the group to read messages without joining it.

Scheme

chatInvitePeek#61695cb0 chat:Chat expires:int = ChatInvite;

Layer 114

Added WebRTC signaling methods.

Scheme changes

New Methods

Added phone.sendSignalingData - Send VoIP signaling data

Changed Methods

Removed grouped parameter in messages.forwardMessages
Added unpin, pm_oneside parameters in messages.updatePinnedMessage

Deleted Methods

Removed messages.searchGifs

New Constructors

Added videoSize - Animated profile picture in MPEG4 format
Added updatePhoneCallSignalingData - Incoming phone call signaling payload

Changed Constructors

Added video_calls_available parameter in userFull
Added force_file parameter in inputMediaUploadedDocument
Added video_thumbs parameter in document
Added apply_min_photo parameter in user
Added blocked parameter, changed type of can_view_stats from flags.12?true to flags.20?true in channelFull
Changed type of video from flags.5?true to flags.6?true in phoneCallWaiting
Changed type of video from flags.5?true to flags.6?true in phoneCallRequested
Changed type of video from flags.5?true to flags.6?true in phoneCallAccepted
Added video parameter in phoneCall
Changed type of video from flags.5?true to flags.6?true in phoneCallDiscarded
Added anonymous parameter in chatAdminRights

Deleted Constructors

Removed foundGif
Removed foundGifCached
Removed inputMediaGifExternal
Removed messages.foundGifs

Scheme

userFull#edf17c12 flags:# blocked:flags.0?true phone_calls_available:flags.4?true phone_calls_private:flags.5?true can_pin_message:flags.7?true has_scheduled:flags.12?true video_calls_available:flags.13?true user:User about:flags.1?string settings:PeerSettings profile_photo:flags.2?Photo notify_settings:PeerNotifySettings bot_info:flags.3?BotInfo pinned_msg_id:flags.6?int common_chats_count:int folder_id:flags.11?int = UserFull;

inputMediaUploadedDocument#5b38c6c1 flags:# nosound_video:flags.3?true force_file:flags.4?true file:InputFile thumb:flags.2?InputFile mime_type:string attributes:Vector<DocumentAttribute> stickers:flags.0?Vector<InputDocument> ttl_seconds:flags.1?int = InputMedia;

document#1e87342b flags:# id:long access_hash:long file_reference:bytes date:int mime_type:string size:int thumbs:flags.0?Vector<PhotoSize> video_thumbs:flags.1?Vector<VideoSize> dc_id:int attributes:Vector<DocumentAttribute> = Document;

user#938458c1 flags:# self:flags.10?true contact:flags.11?true mutual_contact:flags.12?true deleted:flags.13?true bot:flags.14?true bot_chat_history:flags.15?true bot_nochats:flags.16?true verified:flags.17?true restricted:flags.18?true min:flags.20?true bot_inline_geo:flags.21?true support:flags.23?true scam:flags.24?true apply_min_photo:flags.25?true id:int access_hash:flags.0?long first_name:flags.1?string last_name:flags.2?string username:flags.3?string phone:flags.4?string photo:flags.5?UserProfilePhoto status:flags.6?UserStatus bot_info_version:flags.14?int restriction_reason:flags.18?Vector<RestrictionReason> bot_inline_placeholder:flags.19?string lang_code:flags.22?string = User;

channelFull#f0e6672a flags:# can_view_participants:flags.3?true can_set_username:flags.6?true can_set_stickers:flags.7?true hidden_prehistory:flags.10?true can_set_location:flags.16?true has_scheduled:flags.19?true can_view_stats:flags.20?true blocked:flags.22?true id:int about:string participants_count:flags.0?int admins_count:flags.1?int kicked_count:flags.2?int banned_count:flags.2?int online_count:flags.13?int read_inbox_max_id:int read_outbox_max_id:int unread_count:int chat_photo:Photo notify_settings:PeerNotifySettings exported_invite:ExportedChatInvite bot_info:Vector<BotInfo> migrated_from_chat_id:flags.4?int migrated_from_max_id:flags.4?int pinned_msg_id:flags.5?int stickerset:flags.8?StickerSet available_min_id:flags.9?int folder_id:flags.11?int linked_chat_id:flags.14?int location:flags.15?ChannelLocation slowmode_seconds:flags.17?int slowmode_next_send_date:flags.18?int stats_dc:flags.12?int pts:int = ChatFull;

phoneCallWaiting#1b8f4ad1 flags:# video:flags.6?true id:long access_hash:long date:int admin_id:int participant_id:int protocol:PhoneCallProtocol receive_date:flags.0?int = PhoneCall;
phoneCallRequested#87eabb53 flags:# video:flags.6?true id:long access_hash:long date:int admin_id:int participant_id:int g_a_hash:bytes protocol:PhoneCallProtocol = PhoneCall;
phoneCallAccepted#997c454a flags:# video:flags.6?true id:long access_hash:long date:int admin_id:int participant_id:int g_b:bytes protocol:PhoneCallProtocol = PhoneCall;
phoneCall#8742ae7f flags:# p2p_allowed:flags.5?true video:flags.6?true id:long access_hash:long date:int admin_id:int participant_id:int g_a_or_b:bytes key_fingerprint:long protocol:PhoneCallProtocol connections:Vector<PhoneConnection> start_date:int = PhoneCall;
phoneCallDiscarded#50ca4de1 flags:# need_rating:flags.2?true need_debug:flags.3?true video:flags.6?true id:long reason:flags.0?PhoneCallDiscardReason duration:flags.1?int = PhoneCall;

chatAdminRights#5fb224d5 flags:# change_info:flags.0?true post_messages:flags.1?true edit_messages:flags.2?true delete_messages:flags.3?true ban_users:flags.4?true invite_users:flags.5?true pin_messages:flags.7?true add_admins:flags.9?true anonymous:flags.10?true = ChatAdminRights;

videoSize#435bb987 type:string location:FileLocation w:int h:int size:int = VideoSize;

updatePhoneCallSignalingData#2661bf09 phone_call_id:long data:bytes = Update;

---functions---

messages.forwardMessages#d9fee60e flags:# silent:flags.5?true background:flags.6?true with_my_score:flags.8?true from_peer:InputPeer id:Vector<int> random_id:Vector<long> to_peer:InputPeer schedule_date:flags.10?int = Updates;
messages.updatePinnedMessage#d2aaf7ec flags:# silent:flags.0?true unpin:flags.1?true pm_oneside:flags.2?true peer:InputPeer id:int = Updates;

phone.sendSignalingData#ff7a9383 peer:InputPhoneCall data:bytes = Bool;

Layer 113

Public Service Announcement constructors and better PUSH notifications.
Notice that all PINNED_* PUSH notifications have two variants: one for groups, and one for channels.

Scheme changes

New Methods

Added help.getPromoData - Get MTProxy/Public Service Announcement information
Added help.hidePromoData - Hide MTProxy/Public Service Announcement information

Deleted Methods

Removed help.getProxyData

New Constructors

Added help.promoDataEmpty - No PSA/MTProxy info is available
Added help.promoData - MTProxy/Public Service Announcement information

Changed Constructors

Added psa_type parameter in messageFwdHeader

Deleted Constructors

Removed help.proxyDataEmpty
Removed help.proxyDataPromo

PUSH notification changes

New PUSH notifications

Added MESSAGE_QUIZ - {1} sent you a quiz {2}
Added CHANNEL_MESSAGE_QUIZ - {1} posted a quiz {2}
Added CHAT_MESSAGE_QUIZ - {1} sent a quiz {3} to the group {2}
Added PINNED_QUIZ - {1} pinned a quiz {2}

Changed PUSH notifications

Added scheduled additional parameter in MESSAGE_TEXT
Added scheduled additional parameter in MESSAGE_NOTEXT
Added scheduled additional parameter in MESSAGE_PHOTO
Added scheduled additional parameter in MESSAGE_PHOTO_SECRET
Added scheduled additional parameter in MESSAGE_VIDEO
Added scheduled additional parameter in MESSAGE_VIDEO_SECRET
Added scheduled additional parameter in MESSAGE_SCREENSHOT
Added scheduled additional parameter in MESSAGE_ROUND
Added scheduled additional parameter in MESSAGE_DOC
Added scheduled additional parameter in MESSAGE_STICKER
Added scheduled additional parameter in MESSAGE_AUDIO
Added scheduled additional parameter in MESSAGE_CONTACT
Added scheduled additional parameter in MESSAGE_GEO
Added scheduled additional parameter in MESSAGE_GEOLIVE
Added scheduled additional parameter in MESSAGE_POLL
Added scheduled additional parameter in MESSAGE_GIF
Added scheduled additional parameter in MESSAGE_GAME
Added scheduled additional parameter in MESSAGE_GAME_SCORE
Added scheduled additional parameter in MESSAGE_INVOICE
Added scheduled additional parameter in CHANNEL_MESSAGE_TEXT
Added scheduled additional parameter in CHANNEL_MESSAGE_NOTEXT
Added scheduled additional parameter in CHANNEL_MESSAGE_PHOTO
Added scheduled additional parameter in CHANNEL_MESSAGE_VIDEO
Added scheduled additional parameter in CHANNEL_MESSAGE_ROUND
Added scheduled additional parameter in CHANNEL_MESSAGE_DOC
Added scheduled additional parameter in CHANNEL_MESSAGE_STICKER
Added scheduled additional parameter in CHANNEL_MESSAGE_AUDIO
Added scheduled additional parameter in CHANNEL_MESSAGE_CONTACT
Added scheduled additional parameter in CHANNEL_MESSAGE_GEO
Added scheduled additional parameter in CHANNEL_MESSAGE_GEOLIVE
Added scheduled additional parameter in CHANNEL_MESSAGE_POLL
Added scheduled additional parameter in CHANNEL_MESSAGE_GIF
Added scheduled additional parameter in CHANNEL_MESSAGE_GAME
Added scheduled additional parameter in CHANNEL_MESSAGE_GAME_SCORE
Added scheduled additional parameter in CHAT_MESSAGE_TEXT
Added scheduled additional parameter in CHAT_MESSAGE_NOTEXT
Added scheduled additional parameter in CHAT_MESSAGE_PHOTO
Added scheduled additional parameter in CHAT_MESSAGE_VIDEO
Added scheduled additional parameter in CHAT_MESSAGE_ROUND
Added scheduled additional parameter in CHAT_MESSAGE_DOC
Added scheduled additional parameter in CHAT_MESSAGE_STICKER
Added scheduled additional parameter in CHAT_MESSAGE_AUDIO
Added scheduled additional parameter in CHAT_MESSAGE_CONTACT
Added scheduled additional parameter in CHAT_MESSAGE_GEO
Added scheduled additional parameter in CHAT_MESSAGE_GEOLIVE
Added scheduled additional parameter in CHAT_MESSAGE_POLL
Added scheduled additional parameter in CHAT_MESSAGE_GIF
Added scheduled additional parameter in CHAT_MESSAGE_GAME
Added scheduled additional parameter in CHAT_MESSAGE_GAME_SCORE
Added scheduled additional parameter in CHAT_MESSAGE_INVOICE

Scheme

messageFwdHeader#353a686b flags:# from_id:flags.0?int from_name:flags.5?string date:int channel_id:flags.1?int channel_post:flags.2?int post_author:flags.3?string saved_from_peer:flags.4?Peer saved_from_msg_id:flags.4?int psa_type:flags.6?string = MessageFwdHeader;

help.promoDataEmpty#98f6ac75 expires:int = help.PromoData;
help.promoData#8c39793f flags:# proxy:flags.0?true expires:int peer:Peer chats:Vector<Chat> users:Vector<User> psa_type:flags.1?string psa_message:flags.2?string = help.PromoData;

---functions---

help.getPromoData#c0977421 = help.PromoData;
help.hidePromoData#1e251c95 peer:InputPeer = Bool;

Layer 112

Scheme changes

New Methods

Added messages.getOldFeaturedStickers - Method for fetching previously featured stickers

Changed Constructors

Added count parameter in messages.featuredStickersNotModified
Added count parameter in messages.featuredStickers
Added close_period, close_date parameters in poll
Added solution, solution_entities parameters in pollResults
Added solution, solution_entities parameters in inputMediaPoll
Added emoticon parameter in inputMediaDice
Added emoticon parameter in messageMediaDice
Added emoticon parameter in inputStickerSetDice

Scheme

messages.featuredStickersNotModified#c6dc0c66 count:int = messages.FeaturedStickers;
messages.featuredStickers#b6abc341 hash:int count:int sets:Vector<StickerSetCovered> unread:Vector<long> = messages.FeaturedStickers;

poll#86e18161 id:long flags:# closed:flags.0?true public_voters:flags.1?true multiple_choice:flags.2?true quiz:flags.3?true question:string answers:Vector<PollAnswer> close_period:flags.4?int close_date:flags.5?int = Poll;
pollResults#badcc1a3 flags:# min:flags.0?true results:flags.1?Vector<PollAnswerVoters> total_voters:flags.2?int recent_voters:flags.3?Vector<int> solution:flags.4?string solution_entities:flags.4?Vector<MessageEntity> = PollResults;

inputMediaPoll#0f94e5f1 flags:# poll:Poll correct_answers:flags.0?Vector<bytes> solution:flags.1?string solution_entities:flags.1?Vector<MessageEntity> = InputMedia;
inputMediaDice#e66fbf7b emoticon:string = InputMedia;

messageMediaDice#3f7ee58b value:int emoticon:string = MessageMedia;

inputStickerSetDice#e67f520e emoticon:string = InputStickerSet;

---functions---

initConnection#c1cd5ea9 {X:Type} flags:# api_id:int device_model:string system_version:string app_version:string system_lang_code:string lang_pack:string lang_code:string proxy:flags.0?InputClientProxy params:flags.1?JSONValue query:!X = X;

messages.getOldFeaturedStickers#5fe7025b offset:int limit:int hash:int = messages.FeaturedStickers;

Layer 111

Folders, channel stats, bot and sticker improvements

Scheme changes

New Methods

Added messages.getDialogFilters - Get folders
Added messages.getSuggestedDialogFilters - Get suggested folders
Added messages.updateDialogFilter - Update folder
Added messages.updateDialogFiltersOrder - Reorder folders
Added stats.getBroadcastStats - Get channel statistics
Added stats.loadAsyncGraph - Load channel statistics graph asynchronously
Added stickers.setStickerSetThumb - Set stickerset thumbnail
Added bots.setBotCommands - Set bot command list

Changed Methods

Added params parameter in initConnection
Added animated, thumb parameters in stickers.createStickerSet

New Constructors

Added dialogFilter - Dialog filter AKA folder
Added dialogFilterSuggested - Suggested folders
Added updateDialogFilter - A new folder was added
Added updateDialogFilterOrder - New folder order
Added updateDialogFilters - Clients should update folder info
Added statsDateRangeDays - Channel statistics date range
Added statsAbsValueAndPrev - Statistics value couple; initial and final value for period of time currently in consideration
Added statsPercentValue - Channel statistics percentage.
Added statsGraphAsync - This channel statistics graph must be generated asynchronously using stats.loadAsyncGraph to reduce server load
Added statsGraphError - An error occurred while generating the statistics graph
Added statsGraph - Channel statistics graph
Added messageInteractionCounters - Message interaction counters
Added stats.broadcastStats - Channel statistics.
Added inputMediaDice - Send a dice-based animated sticker
Added messageMediaDice - Dice-based animated sticker
Added inputStickerSetDice - Used for fetching animated dice stickers

Changed Constructors

Added stats_dc parameter in channelFull
Added flags, cached_page_views parameters in webPageNotModified
Added library_versions parameter in phoneCallProtocol
Added views parameter in page

Scheme

channelFull#f0e6672a flags:# can_view_participants:flags.3?true can_set_username:flags.6?true can_set_stickers:flags.7?true hidden_prehistory:flags.10?true can_view_stats:flags.12?true can_set_location:flags.16?true has_scheduled:flags.19?true id:int about:string participants_count:flags.0?int admins_count:flags.1?int kicked_count:flags.2?int banned_count:flags.2?int online_count:flags.13?int read_inbox_max_id:int read_outbox_max_id:int unread_count:int chat_photo:Photo notify_settings:PeerNotifySettings exported_invite:ExportedChatInvite bot_info:Vector<BotInfo> migrated_from_chat_id:flags.4?int migrated_from_max_id:flags.4?int pinned_msg_id:flags.5?int stickerset:flags.8?StickerSet available_min_id:flags.9?int folder_id:flags.11?int linked_chat_id:flags.14?int location:flags.15?ChannelLocation slowmode_seconds:flags.17?int slowmode_next_send_date:flags.18?int stats_dc:flags.12?int pts:int = ChatFull;

webPageNotModified#7311ca11 flags:# cached_page_views:flags.0?int = WebPage;

phoneCallProtocol#fc878fc8 flags:# udp_p2p:flags.0?true udp_reflector:flags.1?true min_layer:int max_layer:int library_versions:Vector<string> = PhoneCallProtocol;
page#98657f0d flags:# part:flags.0?true rtl:flags.1?true v2:flags.2?true url:string blocks:Vector<PageBlock> photos:Vector<Photo> documents:Vector<Document> views:flags.3?int = Page;

dialogFilter#7438f7e8 flags:# contacts:flags.0?true non_contacts:flags.1?true groups:flags.2?true broadcasts:flags.3?true bots:flags.4?true exclude_muted:flags.11?true exclude_read:flags.12?true exclude_archived:flags.13?true id:int title:string emoticon:flags.25?string pinned_peers:Vector<InputPeer> include_peers:Vector<InputPeer> exclude_peers:Vector<InputPeer> = DialogFilter;
dialogFilterSuggested#77744d4a filter:DialogFilter description:string = DialogFilterSuggested;

updateDialogFilter#26ffde7d flags:# id:int filter:flags.0?DialogFilter = Update;
updateDialogFilterOrder#a5d72105 order:Vector<int> = Update;
updateDialogFilters#3504914f = Update;

statsDateRangeDays#b637edaf min_date:int max_date:int = StatsDateRangeDays;
statsAbsValueAndPrev#cb43acde current:double previous:double = StatsAbsValueAndPrev;
statsPercentValue#cbce2fe0 part:double total:double = StatsPercentValue;
statsGraphAsync#4a27eb2d token:string = StatsGraph;
statsGraphError#bedc9822 error:string = StatsGraph;
statsGraph#8ea464b6 flags:# json:DataJSON zoom_token:flags.0?string = StatsGraph;

messageInteractionCounters#ad4fc9bd msg_id:int views:int forwards:int = MessageInteractionCounters;

stats.broadcastStats#bdf78394 period:StatsDateRangeDays followers:StatsAbsValueAndPrev views_per_post:StatsAbsValueAndPrev shares_per_post:StatsAbsValueAndPrev enabled_notifications:StatsPercentValue growth_graph:StatsGraph followers_graph:StatsGraph mute_graph:StatsGraph top_hours_graph:StatsGraph interactions_graph:StatsGraph iv_interactions_graph:StatsGraph views_by_source_graph:StatsGraph new_followers_by_source_graph:StatsGraph languages_graph:StatsGraph recent_message_interactions:Vector<MessageInteractionCounters> = stats.BroadcastStats;

inputMediaDice#aeffa807 = InputMedia;

messageMediaDice#638fe46b value:int = MessageMedia;

inputStickerSetDice#79e21a53 = InputStickerSet;

---functions---

initConnection#785188b8 {X:Type} flags:# api_id:int device_model:string system_version:string app_version:string system_lang_code:string lang_pack:string lang_code:string proxy:flags.0?InputClientProxy params:flags.1?JSONValue query:!X = X;

stickers.createStickerSet#f1036780 flags:# masks:flags.0?true animated:flags.1?true user_id:InputUser title:string short_name:string thumb:flags.2?InputDocument stickers:Vector<InputStickerSetItem> = messages.StickerSet;

messages.getDialogFilters#f19ed96d = Vector<DialogFilter>;
messages.getSuggestedDialogFilters#a29cd42c = Vector<DialogFilterSuggested>;
messages.updateDialogFilter#1ad4a04a flags:# id:int filter:flags.0?DialogFilter = Bool;
messages.updateDialogFiltersOrder#c563c1e4 order:Vector<int> = Bool;

stats.getBroadcastStats#ab42441a flags:# dark:flags.0?true channel:InputChannel = stats.BroadcastStats;
stats.loadAsyncGraph#621d5fa0 flags:# token:string x:flags.0?long = StatsGraph;
stickers.setStickerSetThumb#9a364e30 stickerset:InputStickerSet thumb:InputDocument = messages.StickerSet;

bots.setBotCommands#805d46f6 commands:Vector<BotCommand> = Bool;

Layer 110

Credit card information

Scheme changes

New Methods

Added payments.getBankCardData - Get info about a credit card

Changed Methods

Removed params parameter in initConnection
Added flags, background, self_expires parameters in contacts.getLocated

New Constructors

Added messageEntityBankCard - Indicates a credit card number
Added bankCardOpenUrl - Credit card info URL provided by the bank
Added payments.bankCardData - Credit card info, provided by the card's bank(s)
Added peerSelfLocated - Current peer

Scheme

messageEntityBankCard#761e6af4 offset:int length:int = MessageEntity;

bankCardOpenUrl#f568028a url:string name:string = BankCardOpenUrl;

payments.bankCardData#3e24e573 title:string open_urls:Vector<BankCardOpenUrl> = payments.BankCardData;
peerSelfLocated#f8ec284b expires:int = PeerLocated;

---functions---

initConnection#785188b8 {X:Type} flags:# api_id:int device_model:string system_version:string app_version:string system_lang_code:string lang_pack:string lang_code:string proxy:flags.0?InputClientProxy query:!X = X;

contacts.getLocated#d348bc44 flags:# background:flags.1?true geo_point:InputGeoPoint self_expires:flags.0?int = Updates;

payments.getBankCardData#2e79d779 number:string = payments.BankCardData;

Layer 109

Non-anonymous polls, improved sticker management

Scheme changes

New Methods

Added messages.getPollVotes - Get poll results for non-anonymous polls
Added messages.toggleStickerSets - Apply changes to multiple stickersets

Changed Methods

Added params parameter in initConnection

New Constructors

Added updateMessagePollVote - A specific user has voted in a poll
Added messageUserVote - How a user voted in a poll
Added messageUserVoteInputOption - How a user voted in a poll (reduced constructor, returned if an option was provided to messages.getPollVotes)
Added messageUserVoteMultiple - How a user voted in a multiple-choice poll
Added messages.votesList - How users voted in a poll
Added keyboardButtonRequestPoll - A button that allows the user to create and send a poll when pressed; available only in private

Changed Constructors

Added recent_voters parameter in pollResults
Added flags, correct_answers parameters in inputMediaPoll

Scheme

pollResults#c87024a2 flags:# min:flags.0?true results:flags.1?Vector<PollAnswerVoters> total_voters:flags.2?int recent_voters:flags.3?Vector<int> = PollResults;

inputMediaPoll#abe9ca25 flags:# poll:Poll correct_answers:flags.0?Vector<bytes> = InputMedia;

updateMessagePollVote#42f88f2c poll_id:long user_id:int options:Vector<bytes> = Update;

messageUserVote#a28e5559 user_id:int option:bytes date:int = MessageUserVote;
messageUserVoteInputOption#36377430 user_id:int date:int = MessageUserVote;
messageUserVoteMultiple#0e8fe0de user_id:int options:Vector<bytes> date:int = MessageUserVote;
messages.votesList#0823f649 flags:# count:int votes:Vector<MessageUserVote> users:Vector<User> next_offset:flags.0?string = messages.VotesList;

keyboardButtonRequestPoll#bbc7515d flags:# quiz:flags.0?Bool text:string = KeyboardButton;

---functions---

initConnection#785188b8 {X:Type} flags:# api_id:int device_model:string system_version:string app_version:string system_lang_code:string lang_pack:string lang_code:string proxy:flags.0?InputClientProxy params:flags.1?JSONValue query:!X = X;

messages.getPollVotes#b86e380e flags:# peer:InputPeer id:int option:flags.0?bytes offset:flags.1?string limit:int = messages.VotesList;
messages.toggleStickerSets#b5052fea flags:# uninstall:flags.0?true archive:flags.1?true unarchive:flags.2?true stickersets:Vector<InputStickerSet> = Bool;

Layer 108

Login with QR-code, sensitive content settings, quizes, multiple-choice and public polls, get inactive chats, improved wallpapers and themes.

Scheme changes

New Methods

Added auth.exportLoginToken - Generate a login token, for login via QR code.
Added auth.importLoginToken - Login using a redirected login token, generated in case of DC mismatch during QR code login.
Added auth.acceptLoginToken - Accept QR code login token, logging in the app that generated it.
Added account.setContentSettings - Set sensitive content settings (for viewing or hiding NSFW content)
Added account.getContentSettings - Get sensitive content settings
Added channels.getInactiveChannels - Get inactive channels and supergroups
Added account.getMultiWallPapers - Get info about multiple wallpapers

Changed Methods

Added cdn_supported parameter in upload.getFile
Added flags, settings parameters, changed type of document from InputDocument to flags.2?InputDocument in account.createTheme
Added settings parameter in account.updateTheme

New Constructors

Added inputPhotoLegacyFileLocation - Legacy photo file location
Added updateGeoLiveViewed - Live geoposition message was viewed
Added updateLoginToken - A login token (for login via QR code) was accepted.
Added auth.loginToken - Login token (for QR code login)
Added auth.loginTokenMigrateTo - Repeat the query to the specified DC
Added auth.loginTokenSuccess - Login via token (QR code) succeded!
Added account.contentSettings - Sensitive content settings
Added messages.inactiveChats - Inactive chat list
Added baseThemeClassic - Classic theme
Added baseThemeDay - Day theme
Added baseThemeNight - Night theme
Added baseThemeTinted - Tinted theme
Added baseThemeArctic - Arctic theme
Added inputWallPaperNoFile - Wallpaper with no file access hash, used for example when deleting (unsave=true) wallpapers using account.saveWallPaper, specifying just the wallpaper ID.
Added wallPaperNoFile - No file wallpaper
Added inputThemeSettings - Theme settings
Added themeSettings - Theme settings
Added webPageAttributeTheme - Page theme

Changed Constructors

Added attributes parameter, removed documents parameter in webPage
Added public_voters, multiple_choice, quiz parameters in poll
Added correct parameter in pollAnswerVoters
Added second_background_color, rotation parameters in wallPaperSettings
Added video_upload_maxbitrate parameter in autoDownloadSettings
Added settings parameter in theme

Deleted Constructors

Removed themeDocumentNotModified

Scheme

webPage#e89c45b2 flags:# id:long url:string display_url:string hash:int type:flags.0?string site_name:flags.1?string title:flags.2?string description:flags.3?string photo:flags.4?Photo embed_url:flags.5?string embed_type:flags.5?string embed_width:flags.6?int embed_height:flags.6?int duration:flags.7?int author:flags.8?string document:flags.9?Document cached_page:flags.10?Page attributes:flags.12?Vector<WebPageAttribute> = WebPage;

poll#d5529d06 id:long flags:# closed:flags.0?true public_voters:flags.1?true multiple_choice:flags.2?true quiz:flags.3?true question:string answers:Vector<PollAnswer> = Poll;
pollAnswerVoters#3b6ddad2 flags:# chosen:flags.0?true correct:flags.1?true option:bytes voters:int = PollAnswerVoters;

wallPaperSettings#05086cf8 flags:# blur:flags.1?true motion:flags.2?true background_color:flags.0?int second_background_color:flags.4?int intensity:flags.3?int rotation:flags.4?int = WallPaperSettings;

autoDownloadSettings#e04232f3 flags:# disabled:flags.0?true video_preload_large:flags.1?true audio_preload_next:flags.2?true phonecalls_less_data:flags.3?true photo_size_max:int video_size_max:int file_size_max:int video_upload_maxbitrate:int = AutoDownloadSettings;

inputPhotoLegacyFileLocation#d83466f3 id:long access_hash:long file_reference:bytes volume_id:long local_id:int secret:long = InputFileLocation;

theme#028f1114 flags:# creator:flags.0?true default:flags.1?true id:long access_hash:long slug:string title:string document:flags.2?Document settings:flags.3?ThemeSettings installs_count:int = Theme;

updateGeoLiveViewed#871fb939 peer:Peer msg_id:int = Update;
updateLoginToken#564fe691 = Update;

auth.loginToken#629f1980 expires:int token:bytes = auth.LoginToken;
auth.loginTokenMigrateTo#068e9916 dc_id:int token:bytes = auth.LoginToken;
auth.loginTokenSuccess#390d5c5e authorization:auth.Authorization = auth.LoginToken;
account.contentSettings#57e28221 flags:# sensitive_enabled:flags.0?true sensitive_can_change:flags.1?true = account.ContentSettings;

messages.inactiveChats#a927fec5 dates:Vector<int> chats:Vector<Chat> users:Vector<User> = messages.InactiveChats;

baseThemeClassic#c3a12462 = BaseTheme;
baseThemeDay#fbd81688 = BaseTheme;
baseThemeNight#b7b31ea8 = BaseTheme;
baseThemeTinted#6d5f77ee = BaseTheme;
baseThemeArctic#5b11125a = BaseTheme;

inputWallPaperNoFile#8427bbac = InputWallPaper;

wallPaperNoFile#8af40b25 flags:# default:flags.1?true dark:flags.4?true settings:flags.2?WallPaperSettings = WallPaper;

inputThemeSettings#bd507cd1 flags:# base_theme:BaseTheme accent_color:int message_top_color:flags.0?int message_bottom_color:flags.0?int wallpaper:flags.1?InputWallPaper wallpaper_settings:flags.1?WallPaperSettings = InputThemeSettings;

themeSettings#9c14984a flags:# base_theme:BaseTheme accent_color:int message_top_color:flags.0?int message_bottom_color:flags.0?int wallpaper:flags.1?WallPaper = ThemeSettings;

webPageAttributeTheme#54b56617 flags:# documents:flags.0?Vector<Document> settings:flags.1?ThemeSettings = WebPageAttribute;

---functions---

upload.getFile#b15a9afc flags:# precise:flags.0?true cdn_supported:flags.1?true location:InputFileLocation offset:int limit:int = upload.File;

account.createTheme#8432c21f flags:# slug:string title:string document:flags.2?InputDocument settings:flags.3?InputThemeSettings = Theme;
account.updateTheme#5cb367d5 flags:# format:string theme:InputTheme slug:flags.0?string title:flags.1?string document:flags.2?InputDocument settings:flags.3?InputThemeSettings = Theme;
auth.exportLoginToken#b1b41517 api_id:int api_hash:string except_ids:Vector<int> = auth.LoginToken;
auth.importLoginToken#95ac5ce4 token:bytes = auth.LoginToken;
auth.acceptLoginToken#e894ad4d token:bytes = Authorization;
account.setContentSettings#b574b16b flags:# sensitive_enabled:flags.0?true = Bool;
account.getContentSettings#8b9b4dae = account.ContentSettings;

channels.getInactiveChannels#11e831ee = messages.InactiveChats;

account.getMultiWallPapers#65ad71dc wallpapers:Vector<InputWallPaper> = Vector<WallPaper>;

Layer 105

The API underwent huge changes, a full reread of the documentation is required.

Layer 23

Scheme changes

New Methods

Added account.getPrivacy - Get privacy settings of current account
Added account.setPrivacy - Change privacy settings of current account
Added account.deleteAccount - Delete the user's account from the telegram servers. Can be used, for example, to delete the account of a user that provided the login code, but forgot the 2FA password and no recovery method is configured.
Added account.getAccountTTL - Get days to live of account
Added account.setAccountTTL - Set account self-destruction period
Added invokeWithLayer - Invoke the specified query using the specified API layer
Added contacts.resolveUsername - Resolve a @username to get peer info
Added account.sendChangePhoneCode - Verify a new phone number to associate to the current account
Added account.changePhone - Change the phone number of the current account
Added messages.getStickers - Get stickers by emoji
Added messages.getAllStickers - Get all installed stickers
Added account.updateDeviceLocked - When client-side passcode lock feature is enabled, will not show message texts in incoming PUSH notifications.

Deleted Methods

Removed invokeWithLayer18

New Constructors

Added userStatusRecently - Online status: last seen recently
Added userStatusLastWeek - Online status: last seen last week
Added userStatusLastMonth - Online status: last seen last month
Added updatePrivacy - Privacy rules were changed
Added inputPrivacyKeyStatusTimestamp - Whether we can see the exact last online timestamp of the user
Added privacyKeyStatusTimestamp - Whether we can see the last online timestamp
Added inputPrivacyValueAllowContacts - Allow only contacts
Added inputPrivacyValueAllowAll - Allow all users
Added inputPrivacyValueAllowUsers - Allow only certain users
Added inputPrivacyValueDisallowContacts - Disallow only contacts
Added inputPrivacyValueDisallowAll - Disallow all
Added inputPrivacyValueDisallowUsers - Disallow only certain users
Added privacyValueAllowContacts - Allow all contacts
Added privacyValueAllowAll - Allow all users
Added privacyValueAllowUsers - Allow only certain users
Added privacyValueDisallowContacts - Disallow only contacts
Added privacyValueDisallowAll - Disallow all users
Added privacyValueDisallowUsers - Disallow only certain users
Added account.privacyRules - Privacy rules
Added accountDaysTTL - Time to live in days of the current account
Added account.sentChangePhoneCode
Added updateUserPhone - A user's phone number was changed
Added documentAttributeImageSize - Defines the width and height of an image uploaded as document
Added documentAttributeAnimated - Defines an animated GIF
Added documentAttributeSticker - Defines a sticker
Added documentAttributeVideo - Defines a video
Added documentAttributeAudio - Represents an audio file
Added documentAttributeFilename - A simple document with a file name
Added messages.stickersNotModified - No new stickers were found for the given query
Added messages.stickers - Found stickers
Added stickerPack - A stickerpack is a group of stickers associated to the same emoji.
Added messages.allStickersNotModified - Info about all installed stickers hasn't changed
Added messages.allStickers - Info about all installed stickers
Added disabledFeature

Changed Constructors

Added status parameter, removed expires parameter in contactStatus
Added expires, chat_big_size, disabled_features parameters in config
Added attributes parameter, removed file_name parameter in inputMediaUploadedDocument
Added attributes parameter, removed file_name parameter in inputMediaUploadedThumbDocument
Added attributes parameter, removed user_id, file_name parameters in document

Scheme

contactStatus#d3680c61 user_id:int status:UserStatus = ContactStatus;
config#7dae33e0 date:int expires:int test_mode:Bool this_dc:int dc_options:Vector<DcOption> chat_big_size:int chat_size_max:int broadcast_size_max:int disabled_features:Vector<DisabledFeature> = Config;

inputMediaUploadedDocument#ffe76b78 file:InputFile mime_type:string attributes:Vector<DocumentAttribute> = InputMedia;
inputMediaUploadedThumbDocument#41481486 file:InputFile thumb:InputFile mime_type:string attributes:Vector<DocumentAttribute> = InputMedia;

document#f9a39f4f id:long access_hash:long date:int mime_type:string size:int thumb:PhotoSize dc_id:int attributes:Vector<DocumentAttribute> = Document;

userStatusRecently#e26f42f1 = UserStatus;
userStatusLastWeek#07bf09fc = UserStatus;
userStatusLastMonth#77ebc742 = UserStatus;
updatePrivacy#ee3b272a key:PrivacyKey rules:Vector<PrivacyRule> = Update;

inputPrivacyKeyStatusTimestamp#4f96cb18 = InputPrivacyKey;

privacyKeyStatusTimestamp#bc2eab30 = PrivacyKey;

inputPrivacyValueAllowContacts#0d09e07b = InputPrivacyRule;
inputPrivacyValueAllowAll#184b35ce = InputPrivacyRule;
inputPrivacyValueAllowUsers#131cc67f users:Vector<InputUser> = InputPrivacyRule;
inputPrivacyValueDisallowContacts#0ba52007 = InputPrivacyRule;
inputPrivacyValueDisallowAll#d66b66c9 = InputPrivacyRule;
inputPrivacyValueDisallowUsers#90110467 users:Vector<InputUser> = InputPrivacyRule;

privacyValueAllowContacts#fffe1bac = PrivacyRule;
privacyValueAllowAll#65427b82 = PrivacyRule;
privacyValueAllowUsers#4d5bbe0c users:Vector<int> = PrivacyRule;
privacyValueDisallowContacts#f888fa1a = PrivacyRule;
privacyValueDisallowAll#8b73e763 = PrivacyRule;
privacyValueDisallowUsers#0c7f49b7 users:Vector<int> = PrivacyRule;

account.privacyRules#554abb6f rules:Vector<PrivacyRule> users:Vector<User> = account.PrivacyRules;
accountDaysTTL#b8d0afdf days:int = AccountDaysTTL;
account.sentChangePhoneCode#a4f58c4c phone_code_hash:string send_call_timeout:int = account.SentChangePhoneCode;

updateUserPhone#12b9417b user_id:int phone:string = Update;

documentAttributeImageSize#6c37c15c w:int h:int = DocumentAttribute;
documentAttributeAnimated#11b58939 = DocumentAttribute;
documentAttributeSticker#fb0a5727 = DocumentAttribute;
documentAttributeVideo#5910cccb duration:int w:int h:int = DocumentAttribute;
documentAttributeAudio#051448e5 duration:int = DocumentAttribute;
documentAttributeFilename#15590068 file_name:string = DocumentAttribute;

messages.stickersNotModified#f1749a22 = messages.Stickers;
messages.stickers#8a8ecd32 hash:string stickers:Vector<Document> = messages.Stickers;

stickerPack#12b299d4 emoticon:string documents:Vector<long> = StickerPack;

messages.allStickersNotModified#e86602c3 = messages.AllStickers;
messages.allStickers#dcef3102 hash:string packs:Vector<StickerPack> documents:Vector<Document> = messages.AllStickers;

disabledFeature#ae636f24 feature:string description:string = DisabledFeature;

---functions---

account.getPrivacy#dadbc950 key:InputPrivacyKey = account.PrivacyRules;
account.setPrivacy#c9f81ce8 key:InputPrivacyKey rules:Vector<InputPrivacyRule> = account.PrivacyRules;
account.deleteAccount#418d4e0b reason:string = Bool;
account.getAccountTTL#08fc711d = AccountDaysTTL;
account.setAccountTTL#2442485e ttl:AccountDaysTTL = Bool;

invokeWithLayer#da9b0d0d {X:Type} layer:int query:!X = X;

contacts.resolveUsername#0bf0131c username:string = User;

account.sendChangePhoneCode#a407a8f4 phone_number:string = account.SentChangePhoneCode;
account.changePhone#70c32edb phone_number:string phone_code_hash:string phone_code:string = User;

messages.getStickers#ae22e045 emoticon:string hash:string = messages.Stickers;
messages.getAllStickers#aa3bc868 hash:string = messages.AllStickers;

account.updateDeviceLocked#38df3532 period:int = Bool;

End-to-end scheme changes

New Constructors

Added decryptedMessageActionRequestKey - Request rekeying, see rekeying process
Added decryptedMessageActionAcceptKey - Accept new key
Added decryptedMessageActionAbortKey - Abort rekeying
Added decryptedMessageActionCommitKey - Commit new key, see rekeying process
Added decryptedMessageActionNoop - NOOP action
Added documentAttributeImageSize - Defines the width and height of an image uploaded as document
Added documentAttributeAnimated - Defines an animated GIF
Added documentAttributeSticker - Defines a sticker
Added documentAttributeVideo - Defines a video
Added documentAttributeAudio - Represents an audio file
Added documentAttributeFilename - A simple document with a file name
Added photoSizeEmpty - Empty constructor. Image with this thumbnail is unavailable.
Added photoSize - Image description.
Added photoCachedSize - Description of an image and its content.
Added fileLocationUnavailable
Added fileLocation
Added decryptedMessageMediaExternalDocument - Non-e2e documented forwarded from non-secret chat

End-to-end scheme

===20===

decryptedMessageActionRequestKey#f3c9611b exchange_id:long g_a:bytes = DecryptedMessageAction;
decryptedMessageActionAcceptKey#6fe1735b exchange_id:long g_b:bytes key_fingerprint:long = DecryptedMessageAction;
decryptedMessageActionAbortKey#dd05ec6b exchange_id:long = DecryptedMessageAction;
decryptedMessageActionCommitKey#ec2e0b9b exchange_id:long key_fingerprint:long = DecryptedMessageAction;
decryptedMessageActionNoop#a82fdd63 = DecryptedMessageAction;

===23===
documentAttributeImageSize#6c37c15c w:int h:int = DocumentAttribute;
documentAttributeAnimated#11b58939 = DocumentAttribute;
documentAttributeSticker#fb0a5727 = DocumentAttribute;
documentAttributeVideo#5910cccb duration:int w:int h:int = DocumentAttribute;
documentAttributeAudio#051448e5 duration:int = DocumentAttribute;
documentAttributeFilename#15590068 file_name:string = DocumentAttribute;

photoSizeEmpty#0e17e23c type:string = PhotoSize;
photoSize#77bfb61b type:string location:FileLocation w:int h:int size:int = PhotoSize;
photoCachedSize#e9a734fa type:string location:FileLocation w:int h:int bytes:bytes = PhotoSize;

fileLocationUnavailable#7c596b46 volume_id:long local_id:int secret:long = FileLocation;
fileLocation#53d69076 dc_id:int volume_id:long local_id:int secret:long = FileLocation;

decryptedMessageMediaExternalDocument#fa95b0dd id:long access_hash:long date:int mime_type:string size:int thumb:PhotoSize dc_id:int attributes:Vector<DocumentAttribute> = DecryptedMessageMedia;

Layer 18

Added username support and a new type of updates for service messages.

Schema changes

Added methods account.checkUsername and account.updateUsername for setting up a username, as well as the method contacts.search that allows searching for publicly available users by username.
username field added to constructors of the type User and to the updateUserName constructor.
Added new update constructor updateServiceNotification for receiving service messages.

Schema

contactFound user_id:int = ContactFound;

contacts.found results:Vector<ContactFound> users:Vector<User> = contacts.Found;

updateUserName user_id:int first_name:string last_name:string username:string = Update;

userSelf id:int first_name:string last_name:string username:string phone:string photo:UserProfilePhoto status:UserStatus inactive:Bool = User;
userContact id:int first_name:string last_name:string username:string access_hash:long phone:string photo:UserProfilePhoto status:UserStatus = User;
userRequest id:int first_name:string last_name:string username:string access_hash:long phone:string photo:UserProfilePhoto status:UserStatus = User;
userForeign id:int first_name:string last_name:string username:string access_hash:long photo:UserProfilePhoto status:UserStatus = User;
userDeleted id:int first_name:string last_name:string username:string = User;

updateServiceNotification type:string message:string media:MessageMedia popup:Bool = Update;

---functions---

account.checkUsername username:string = Bool;
account.updateUsername username:string = User;

contacts.search q:string limit:int = contacts.Found;

invokeWithLayer18#1c900537 {X:Type} query:!X = X;

Layer 17

Added new events for recording and uploading media, selecting contacts and locations to share.

Read status for multimedia (messages containing messageMediaVideo or messageMediaAudio) was moved to the new method messages.readMessageContents. In case read_contents is not passed or messages.readHistory is used with an older layer, messages will be marked as read in the traditional way.

Schema changes

Added new type SendMessageAction for user actions aside from typing (recording, uploading media, etc.). It is used in updates updateUserTyping, updateChatUserTyping, in the method messages.setTyping, and in the new encrypted service message decryptedMessageActionTyping.
unread and out parameters in the constructors of the Message type were joined to form the new flags parameter, containing a flag mask.
Added new method messages.readMessageContents, to be called once the user listened to a voice message or watched a video.
Added parameters for end-to-end encrypted messages in_seq_no, out_seq_no and ttl.
Added mime_type field to secret chat audio and video constructors.

Schema

sendMessageTypingAction = SendMessageAction;
sendMessageCancelAction = SendMessageAction;
sendMessageRecordVideoAction = SendMessageAction;
sendMessageUploadVideoAction = SendMessageAction;
sendMessageRecordAudioAction = SendMessageAction;
sendMessageUploadAudioAction = SendMessageAction;
sendMessageUploadPhotoAction = SendMessageAction;
sendMessageUploadDocumentAction = SendMessageAction;
sendMessageGeoLocationAction = SendMessageAction;
sendMessageChooseContactAction = SendMessageAction;

updateUserTyping user_id:int action:SendMessageAction = Update;
updateChatUserTyping chat_id:int user_id:int action:SendMessageAction = Update;

// Message object
message flags:int id:int from_id:int to_id:Peer date:int message:string media:MessageMedia = Message;
messageForwarded flags:int id:int fwd_from_id:int fwd_date:int from_id:int to_id:Peer date:int message:string media:MessageMedia = Message;
messageService flags:int id:int from_id:int to_id:Peer date:int action:MessageAction = Message;

---functions---

messages.setTyping peer:InputPeer action:SendMessageAction = Bool;

messages.readHistory peer:InputPeer max_id:int offset:int read_contents:Bool = messages.AffectedHistory;
messages.readMessageContents id:Vector<int> = Vector<int>;

invokeWithLayer17#50858a19 {X:Type} query:!X = X;

End-to-end schema

===17===


// Layer
decryptedMessageLayer random_bytes:bytes layer:int in_seq_no:int out_seq_no:int message:DecryptedMessage = DecryptedMessageLayer;

decryptedMessageMediaAudio duration:int mime_type:string size:int key:bytes iv:bytes = DecryptedMessageMedia;
decryptedMessageMediaVideo thumb:bytes thumb_w:int thumb_h:int duration:int mime_type:string w:int h:int size:int key:bytes iv:bytes = DecryptedMessageMedia;

sendMessageTypingAction = SendMessageAction;
sendMessageCancelAction = SendMessageAction;
sendMessageRecordVideoAction = SendMessageAction;
sendMessageUploadVideoAction = SendMessageAction;
sendMessageRecordAudioAction = SendMessageAction;
sendMessageUploadAudioAction = SendMessageAction;
sendMessageUploadPhotoAction = SendMessageAction;
sendMessageUploadDocumentAction = SendMessageAction;
sendMessageGeoLocationAction = SendMessageAction;
sendMessageChooseContactAction = SendMessageAction;

decryptedMessageActionNotifyLayer layer:int = DecryptedMessageAction;
decryptedMessageActionTyping action:SendMessageAction = DecryptedMessageAction;

decryptedMessage random_id:long ttl:int message:string media:DecryptedMessageMedia = DecryptedMessage;
decryptedMessageService random_id:long action:DecryptedMessageAction = DecryptedMessage;

Layer 16

Added new sms_type = 5 in the method auth.sendCode.

Schema changes

Added new constructor: auth.sentAppCode to determine whether a code was sent via Telegram.
Added new method auth.sendSms to force re-sending a code via SMS.

Schema

auth.sentAppCode phone_registered:Bool phone_code_hash:string send_call_timeout:int is_password:Bool = auth.SentCode;

---functions---

auth.sendSms phone_number:string phone_code_hash:string = Bool;

invokeWithLayer16#cf5f0987 {X:Type} query:!X = X;

Layer 15

Modified behavior of the offset parameter in the method messages.getHistory. From now on it's possible to combine message_id offset and a numeric offset.

Schema

invokeWithLayer15#b4418b64 {X:Type} query:!X = X;

Layer 14

Schema changes

Added new update constructors: updateUserBlocked and updateNotifySettings to sync notification settings and blacklists between devices.
Added notify_settings field to the dialog constructor.

Schema

notifyPeer peer:Peer = NotifyPeer;
notifyUsers = NotifyPeer;
notifyChats = NotifyPeer;
notifyAll = NotifyPeer;

dialog peer:Peer top_message:int unread_count:int notify_settings:PeerNotifySettings = Dialog;

updateUserBlocked user_id:int blocked:Bool = Update;
updateNotifySettings peer:NotifyPeer notify_settings:PeerNotifySettings = Update;

---functions---

invokeWithLayer14#2b9b08fa {X:Type} query:!X = X;

Layer 13

Schema changes

Added mime_type field to all audio and video constructors.
Added new service message types in secret chats: messages read, messages deleted, screenshot taken, chat history cleared and API layer used by client notifications.
Added retry_contacts field to the contacts.importedContacts constructor: ids of contacts, that will have to be imported at a later date.

Schema

contacts.importedContacts imported:Vector<ImportedContact> retry_contacts:Vector<long> users:Vector<User> = contacts.Im portedContacts;

inputMediaUploadedAudio file:InputFile duration:int mime_type:string = InputMedia;
inputMediaUploadedVideo file:InputFile duration:int w:int h:int mime_type:string = InputMedia;
inputMediaUploadedThumbVideo file:InputFile thumb:InputFile duration:int w:int h:int mime_type:string = InputMedia;

audio id:long access_hash:long user_id:int date:int duration:int mime_type:string size:int dc_id:int = Audio;
video id:long access_hash:long user_id:int date:int caption:string duration:int mime_type:string size:int thumb:PhotoSize dc_id:int w:int h:int = Video;

---functions---

invokeWithLayer13#427c8ea2 {X:Type} query:!X = X;

Layer 12

Schema changes

Added method help.getSupport for obtaining support user id.
Added broadcast_size_max field to the constructor config, contaning maximum number of broadcast recipients.
Added send_call_timeout field to the constructor auth.sentCode, containing required delay before calling auth.sendCall. New field is_password in the same constructor.

Schema

auth.sentCode phone_registered:Bool phone_code_hash:string send_call_timeout:int is_password:Bool = auth.SentCode;

config date:int test_mode:Bool this_dc:int dc_options:Vector<DcOption> chat_size_max:int broadcast_size_max:int = Config;

help.support phone_number:string user:User = help.Support;

---functions---

help.getSupport = help.Support;

invokeWithLayer12#dda60d3c {X:Type} query:!X = X;

Layer 11

Schema changes

The nonce parameter was removed from secret chat constructors. For purposes of backward compatibility, in all previous layers this field will contain empty bytes.

Schema

encryptedChatRequested id:int access_hash:long date:int admin_id:int participant_id:int g_a:bytes = EncryptedChat;
encryptedChat id:int access_hash:long date:int admin_id:int participant_id:int g_a_or_b:bytes key_fingerprint:long = EncryptedChat;

---functions---

invokeWithLayer11#a6b88fdf {X:Type} query:!X = X;

Layer 10

Added brief constructors for editing group members. Added new attachment types for ordinary and secret chats.

Schema changes

Added new update contructors: updateChatParticipantAdd and updateChatParticipantDelete.
Added new media types: Document, Audio, along with rescpective attachment constructors.
If the client doesn't support Layer 10, it will receive messageMediaUnsupported constructors instead of the messageMediaDocument and messageMediaAudio constructors.

Schema

updateChatParticipantAdd chat_id:int user_id:int inviter_id:int version:int = Update;
updateChatParticipantDelete chat_id:int user_id:int version:int = Update;


inputMediaUploadedAudio file:InputFile duration:int = InputMedia;
inputMediaAudio id:InputAudio = InputMedia;

inputMediaUploadedDocument file:InputFile file_name:string mime_type:string = InputMedia;
inputMediaUploadedThumbDocument file:InputFile thumb:InputFile file_name:string mime_type:string = InputMedia;
inputMediaDocument id:InputDocument = InputMedia;

messageMediaDocument document:Document = MessageMedia;
messageMediaAudio audio:Audio = MessageMedia;

// Input Audio
inputAudioEmpty = InputAudio;
inputAudio id:long access_hash:long = InputAudio;

// Input Document
inputDocumentEmpty = InputDocument;
inputDocument id:long access_hash:long = InputDocument;

// Input location
inputAudioFileLocation id:long access_hash:long = InputFileLocation;
inputDocumentFileLocation id:long access_hash:long = InputFileLocation;


decryptedMessageMediaDocument thumb:bytes thumb_w:int thumb_h:int file_name:string mime_type:string size:int key:bytes iv:bytes = DecryptedMessageMedia;
decryptedMessageMediaAudio duration:int size:int key:bytes iv:bytes = DecryptedMessageMedia;


// Audio object
audioEmpty id:long = Audio;
audio id:long access_hash:long user_id:int date:int duration:int size:int dc_id:int = Audio;

// Video object
documentEmpty id:long = Document;
document id:long access_hash:long user_id:int date:int file_name:string mime_type:string size:int thumb:PhotoSize dc_id:int = Document;

---functions---

invokeWithLayer10#39620c41 {X:Type} query:!X = X;
PUSH-notifications

Added MESSAGE_DOC, MESSAGE_AUDIO notifications — a message with document or audio received
Added CHAT_MESSAGE_DOC, CHAT_MESSAGE_AUDIO notifications —  a message with document or audio received in a group

Layer 9

Increased efficiency when loading big files. Added important checks for certain methods.

Schema changes

Added new upload.saveBigFilePart method, constructors inputFileBig, inputEncryptedFileBigUploaded to optimize saving parts of big files. See the updated article on Uploading files for details.
Added a check whether the initConnection method was called with all required parameters before making other API calls. See the updated article on Calling methods for details.
Added availability check for lang_code parameters when calling methods auth.sendCode, account.registerDevice
Added availability check for random_id parameters in all message sending methods: messages.sendMessage, messages.sendMedia, messages.forwardMessage

Schema

inputFileBig id:long parts:int name:string = InputFile;

inputEncryptedFileBigUploaded id:long parts:int key_fingerprint:int = InputEncryptedFile;

---functions---

upload.saveBigFilePart file_id:long file_part:int file_total_parts:int bytes:bytes = Bool;

initConnection#69796de9 {X:Type} api_id:int device_model:string system_version:string app_version:string lang_code:string query:!X = X;

invokeWithLayer9#76715a63 {X:Type} query:!X = X;

Layer 8

Added support for end-to-end encryption in secret chats. More...

Schema changes

Added many constructors and methods for secret chats.
Added qts field in constructor updates.state.
Added 4 new constructors of Update type

Schema

updateNewEncryptedMessage message:EncryptedMessage qts:int = Update;
updateEncryptedChatTyping chat_id:int = Update;
updateEncryption chat:EncryptedChat date:int = Update;
updateEncryptedMessagesRead chat_id:int max_date:int = Update;

// EncryptedChat object
encryptedChatEmpty id:int = EncryptedChat;
encryptedChatWaiting id:int access_hash:long date:int admin_id:int participant_id:int = EncryptedChat;
encryptedChatRequested id:int access_hash:long date:int admin_id:int participant_id:int g_a:bytes = EncryptedChat;
encryptedChat id:int access_hash:long date:int admin_id:int participant_id:int g_a_or_b:bytes key_fingerprint:long = EncryptedChat;
encryptedChatDiscarded id:int = EncryptedChat;

inputEncryptedChat chat_id:int access_hash:long = InputEncryptedChat;

// EncryptedFile object
encryptedFileEmpty = EncryptedFile;
encryptedFile id:long access_hash:long size:int dc_id:int key_fingerprint:int = EncryptedFile;

inputEncryptedFileEmpty = InputEncryptedFile;
inputEncryptedFileUploaded id:long parts:int md5_checksum:string key_fingerprint:int = InputEncryptedFile;
inputEncryptedFile id:long access_hash:long = InputEncryptedFile;

inputEncryptedFileLocation id:long access_hash:long = InputFileLocation;

// Encrypted message
encryptedMessage random_id:long chat_id:int date:int bytes:bytes file:EncryptedFile = EncryptedMessage;
encryptedMessageService random_id:long chat_id:int date:int bytes:bytes = EncryptedMessage;

// Diffie-Hellman config
messages.dhConfigNotModified random:bytes = messages.DhConfig;
messages.dhConfig g:int p:bytes version:int random:bytes = messages.DhConfig;

messages.sentEncryptedMessage date:int = messages.SentEncryptedMessage;
messages.sentEncryptedFile date:int file:EncryptedFile = messages.SentEncryptedMessage;

// Updated state with qts
updates.state pts:int qts:int date:int seq:int unread_count:int = updates.State;
updates.difference new_messages:Vector<Message> new_encrypted_messages:Vector<EncryptedMessage> other_updates:Vector<Update> chats:Vector<Chat> users:Vector<User> state:updates.State = updates.Difference;
updates.differenceSlice new_messages:Vector<Message> new_encrypted_messages:Vector<EncryptedMessage> other_updates:Vector<Update> chats:Vector<Chat> users:Vector<User> intermediate_state:updates.State = updates.Difference;

---functions---

messages.getDhConfig version:int random_length:int = messages.DhConfig;
messages.requestEncryption user_id:InputUser random_id:int g_a:bytes = EncryptedChat;
messages.acceptEncryption peer:InputEncryptedChat g_b:bytes key_fingerprint:long = EncryptedChat;
messages.discardEncryption chat_id:int = Bool;

messages.setEncryptedTyping peer:InputEncryptedChat typing:Bool = Bool;
messages.readEncryptedHistory peer:InputEncryptedChat max_date:int = Bool;
messages.sendEncrypted peer:InputEncryptedChat random_id:long data:bytes = messages.SentEncryptedMessage;
messages.sendEncryptedFile peer:InputEncryptedChat random_id:long data:bytes file:InputEncryptedFile = messages.SentEncryptedMessage;
messages.sendEncryptedService peer:InputEncryptedChat random_id:long data:bytes = messages.SentEncryptedMessage;
messages.receivedQueue max_qts:int = Vector<long>;

updates.getDifference pts:int date:int qts:int = updates.Difference;

invokeWithLayer8#e9abd9fd {X:Type} query:!X = X;

Push-notifications

Added notification of ENCRYPTION_REQUEST type -- a contact requested secret chat creation
Added notification of ENCRYPTION_ACCEPT type -- a contact confirmed secret chat creation
Added notification of ENCRYPTED_MESSAGE type -- a contact sent message in a secret chat

End-to-end schema

===8===
decryptedMessage random_id:long random_bytes:bytes message:string media:DecryptedMessageMedia = DecryptedMessage;
decryptedMessageService random_id:long random_bytes:bytes action:DecryptedMessageAction = DecryptedMessage;

decryptedMessageMediaEmpty = DecryptedMessageMedia;
decryptedMessageMediaPhoto thumb:bytes thumb_w:int thumb_h:int w:int h:int size:int key:bytes iv:bytes = DecryptedMessageMedia;
decryptedMessageMediaVideo thumb:bytes thumb_w:int thumb_h:int duration:int w:int h:int size:int key:bytes iv:bytes = DecryptedMessageMedia;
decryptedMessageMediaGeoPoint lat:double long:double = DecryptedMessageMedia;
decryptedMessageMediaContact phone_number:string first_name:string last_name:string user_id:int = DecryptedMessageMedia;

decryptedMessageActionSetMessageTTL ttl_seconds:int = DecryptedMessageAction;

decryptedMessageMediaDocument thumb:bytes thumb_w:int thumb_h:int file_name:string mime_type:string size:int key:bytes iv:bytes = DecryptedMessageMedia;
decryptedMessageMediaAudio duration:int size:int key:bytes iv:bytes = DecryptedMessageMedia;

decryptedMessageActionReadMessages random_ids:Vector<long> = DecryptedMessageAction;
decryptedMessageActionDeleteMessages random_ids:Vector<long> = DecryptedMessageAction;
decryptedMessageActionScreenshotMessages random_ids:Vector<long> = DecryptedMessageAction;
decryptedMessageActionFlushHistory = DecryptedMessageAction;

Layer 7

Added wallpaper constructor wallPaperSolid.

Schema

wallPaperSolid id:int title:string bg_color:int color:int = WallPaper;
---functions---
invokeWithLayer7#a5be56d3 {X:Type} query:!X = X;

Layer 6

Added location identifiers from foursquare.

Schema

geoChat id:int access_hash:long title:string address:string venue:string geo:GeoPoint photo:ChatPhoto participants_count:int date:int checked_in:Bool version:int = Chat;
---functions---
geochats.createGeoChat title:string geo_point:InputGeoPoint address:string venue:string = geochats.StatedMessage;

invokeWithLayer6#3a64d54d {X:Type} query:!X = X;

Layer 5

Added parameters for internationalization.

Schema changes

Added parameter lang_code to methods auth.sendCode, account.registerDevice

Schema

---functions---
auth.sendCode phone_number:string sms_type:int api_id:int api_hash:string lang_code:string = auth.SentCode;
account.registerDevice token_type:int token:string device_model:string system_version:string app_version:string app_sandbox:Bool lang_code:string = Bool;

invokeWithLayer5#417a57ae {X:Type} query:!X = X;

Layer 4

Added geochats. More...

Schema changes

Added many constructors and methods for geochats.
Added friends_unread_count field to constructor updates.state.

Schema

inputGeoChat chat_id:int access_hash:long = InputGeoChat;

geoChat id:int access_hash:long title:string address:string geo:GeoPoint photo:ChatPhoto participants_count:int date:int left:Bool version:int = Chat;

geoChatMessageEmpty chat_id:int id:int = GeoChatMessage;
geoChatMessage chat_id:int id:int from_id:int date:int message:string media:MessageMedia = GeoChatMessage;
geoChatMessageService chat_id:int id:int from_id:int date:int action:MessageAction = GeoChatMessage;

geochats.statedMessage message:GeoChatMessage chats:Vector<Chat> users:Vector<User> seq:int = geochats.StatedMessage;

geochats.located results:Vector<ChatLocated> messages:Vector<GeoChatMessage> chats:Vector<Chat> users:Vector<User> = geochats.Located;

geochats.messages messages:Vector<GeoChatMessage> chats:Vector<Chat> users:Vector<User> = geochats.Messages;
geochats.messagesSlice count:int messages:Vector<GeoChatMessage> chats:Vector<Chat> users:Vector<User> = geochats.Messages;

messageActionGeoChatCreate title:string address:string = MessageAction;
messageActionGeoChatCheckin = MessageAction;
updateNewGeoChatMessage message:GeoChatMessage = Update;
updates.state pts:int date:int seq:int unread_count:int friends_unread_count:int = updates.State;

---functions---

geochats.getLocated geo_point:InputGeoPoint radius:int limit:int = geochats.Located;
geochats.checkin peer:InputGeoChat = geochats.StatedMessage;
geochats.getFullChat peer:InputGeoChat = messages.ChatFull;
geochats.editChatTitle peer:InputGeoChat title:string address:string = geochats.StatedMessage;
geochats.editChatPhoto peer:InputGeoChat photo:InputChatPhoto = geochats.StatedMessage;
geochats.search peer:InputGeoChat q:string filter:MessagesFilter min_date:int max_date:int offset:int max_id:int limit:int = geochats.Messages;
geochats.getHistory peer:InputGeoChat offset:int max_id:int limit:int = geochats.Messages;
geochats.setTyping peer:InputGeoChat typing:Bool = Bool;
geochats.sendMessage peer:InputGeoChat message:string random_id:long = geochats.StatedMessage;
geochats.sendMedia peer:InputGeoChat media:InputMedia random_id:long = geochats.StatedMessage;
geochats.createGeoChat title:string geo_point:InputGeoPoint address:string = geochats.StatedMessage;

invokeWithLayer4#dea0d430 {X:Type} query:!X = X;

Push-notifications

Added notification of GEOCHAT_CHECKIN type -- a user has checked-in in a geochat.

Layer 3

Support for link changes for a contact when a message is sent. Now, if user X has user Y in the contact list and if user Y writes a message to user X, number X will become available for him. More...

Schema changes

Added constructors messages.statedMessagesLinks, messages.statedMessageLink, messages.sentMessageLink. They are completely similar to previous ones except for the links field containing changed links.
Added events_mask field to constructors inputPeerNotifySettings, peerNotifySettings making possible turning-off PUSH-notifications on image changes.
Added method messages.forwardMessage for sending single messages.
Added method messages.sendBroadcast for bulky messaging.

Schema

messages.statedMessagesLinks messages:Vector<Message> chats:Vector<Chat> users:Vector<User> links:Vector<contacts.Link> pts:int seq:int = messages.StatedMessages;
messages.statedMessageLink message:Message chats:Vector<Chat> users:Vector<User> links:Vector<contacts.Link> pts:int seq:int = messages.StatedMessage;
messages.sentMessageLink id:int date:int pts:int seq:int links:Vector<contacts.Link> = messages.SentMessage;

---functions---

messages.forwardMessage peer:InputPeer id:int random_id:long = messages.StatedMessage;
messages.sendBroadcast contacts:Vector<InputUser> message:string media:InputMedia = messages.StatedMessages;

invokeWithLayer3#b7475268 {X:Type} query:!X = X;

Layer 2

Support for notifications on changes of contact profile images. It is assumed that receiving such image changed notification a client will add a record on this event in the message history with this contact.

Schema changes

Added date and previous fields to constructor updateUserPhoto.
Added events_mask field to constructors inputPeerNotifySettings, peerNotifySettings making possible turning-off PUSH-notifications on image change.
Added identifier for relevant image to constructor userProfilePhoto.
Added method photos.getUserPhotos to get a history of previous profile images.

Schema

inputPeerNotifySettings mute_until:int sound:string show_previews:Bool events_mask:int = InputPeerNotifySettings;
peerNotifySettings mute_until:int sound:string show_previews:Bool events_mask:int = PeerNotifySettings;
updateUserPhoto user_id:int date:int photo:UserProfilePhoto previous:Bool = Update;
userProfilePhoto photo_id:long photo_small:FileLocation photo_big:FileLocation = UserProfilePhoto;

---functions---

photos.getUserPhotos user_id:InputUser offset:int max_id:int limit:int = photos.Photos;

invokeWithLayer2#289dd1f6 {X:Type} query:!X = X;

Push-notifications

Added notification of CONTACT_PHOTO type -- a contact has changed profile image.

Telegram is a cloud-based mobile and desktop messaging app with a focus on security and speed.