From 2b834601e2da085bfd072908c500896e5fdf18d0 Mon Sep 17 00:00:00 2001 From: GitHub Date: Thu, 11 Sep 2025 07:40:31 +0000 Subject: [PATCH] feat(schema): update documentation to the latest layer --- _schema/208.json | 207 ++++++++++++++++++++++++++++++------------- _schema/latest.json | 209 +++++++++++++++++++++++++++++++------------- 2 files changed, 297 insertions(+), 119 deletions(-) diff --git a/_schema/208.json b/_schema/208.json index a9498af..4cc2262 100644 --- a/_schema/208.json +++ b/_schema/208.json @@ -7479,7 +7479,10 @@ }, "bot_verification": { "name": "bot_verification", - "description": " " + "description": "Bot verification icon¹", + "links": [ + "https://core.telegram.org/api/bots/verification" + ] }, "call": { "name": "call", @@ -7732,11 +7735,17 @@ }, "stargifts_available": { "name": "stargifts_available", - "description": " " + "description": "If set, users may send Gifts »¹ to this channel.", + "links": [ + "https://core.telegram.org/api/gifts" + ] }, "stargifts_count": { "name": "stargifts_count", - "description": " " + "description": "Admins with chatAdminRights¹.post_messages rights will see the total number of received gifts, everyone else will see the number of gifts added to the channel's profile.", + "links": [ + "https://core.telegram.org/constructor/chatAdminRights" + ] }, "stats_dc": { "name": "stats_dc", @@ -14825,7 +14834,10 @@ }, "include_upgrade": { "name": "include_upgrade", - "description": " " + "description": "Also pay for an eventual upgrade of the gift to a collectible gift »¹.", + "links": [ + "https://core.telegram.org/api/gifts#collectible-gifts" + ] }, "message": { "name": "message", @@ -14836,7 +14848,7 @@ }, "peer": { "name": "peer", - "description": " " + "description": "Receiver of the gift." } } }, @@ -15164,11 +15176,11 @@ }, "video_cover": { "name": "video_cover", - "description": " " + "description": "Custom video cover." }, "video_timestamp": { "name": "video_timestamp", - "description": " " + "description": "Start playing the video at the specified timestamp (seconds)." } } }, @@ -15199,11 +15211,11 @@ }, "video_cover": { "name": "video_cover", - "description": " " + "description": "Custom video cover." }, "video_timestamp": { "name": "video_timestamp", - "description": " " + "description": "Start playing the video at the specified timestamp (seconds)." } } }, @@ -15548,7 +15560,7 @@ }, "video_cover": { "name": "video_cover", - "description": " " + "description": "Start playing the video at the specified timestamp (seconds)." }, "video_timestamp": { "name": "video_timestamp", @@ -20121,7 +20133,10 @@ }, "upgrade_stars": { "name": "upgrade_stars", - "description": " " + "description": "The number of Telegram Stars the user can pay to convert the gift into a collectible gift »¹.", + "links": [ + "https://core.telegram.org/api/gifts#collectible-gifts" + ] }, "upgraded": { "name": "upgraded", @@ -20144,7 +20159,10 @@ "fields": { "can_export_at": { "name": "can_export_at", - "description": " " + "description": "If set, indicates that the current gift can't be exported to the TON blockchain »¹ yet: the owner will be able to export it at the specified unixtime.", + "links": [ + "https://core.telegram.org/api/gifts#withdraw-a-collectible-gift-to-the-ton-blockchain" + ] }, "can_resell_at": { "name": "can_resell_at", @@ -21185,11 +21203,11 @@ }, "video_cover": { "name": "video_cover", - "description": " " + "description": "Custom video cover." }, "video_timestamp": { "name": "video_timestamp", - "description": " " + "description": "Start playing the video at the specified timestamp (seconds)." }, "voice": { "name": "voice", @@ -25174,17 +25192,32 @@ } }, "paidReactionPrivacyAnonymous": { - "name": "paidReactionPrivacyAnonymous" + "name": "paidReactionPrivacyAnonymous", + "description": [ + "Send paid reactions anonymously." + ] }, "paidReactionPrivacyDefault": { - "name": "paidReactionPrivacyDefault" + "name": "paidReactionPrivacyDefault", + "description": [ + "Uses the default reaction privacy, set using messages.togglePaidReactionPrivacy¹." + ], + "links": [ + "https://core.telegram.org/method/messages.togglePaidReactionPrivacy" + ] }, "paidReactionPrivacyPeer": { "name": "paidReactionPrivacyPeer", + "description": [ + "Send paid reactions as the specified peer, fetched using channels.getSendAs¹." + ], + "links": [ + "https://core.telegram.org/method/channels.getSendAs" + ], "fields": { "peer": { "name": "peer", - "description": " " + "description": "The peer to send reactions as." } } }, @@ -29023,27 +29056,39 @@ "fields": { "can_export_at": { "name": "can_export_at", - "description": " " + "description": "If set, indicates that the current gift can't be exported to the TON blockchain »¹ yet: the owner will be able to export it at the specified unixtime.", + "links": [ + "https://core.telegram.org/api/gifts#withdraw-a-collectible-gift-to-the-ton-blockchain" + ] }, "can_resell_at": { "name": "can_resell_at", - "description": " " + "description": "If set, indicates that the current gift can't be resold »¹ yet: the owner will be able to put it up for sale at the specified unixtime.", + "links": [ + "https://core.telegram.org/api/gifts#sell-a-collectible-gift" + ] }, "can_transfer_at": { "name": "can_transfer_at", - "description": " " + "description": "If set, indicates that the current gift can't be transferred »¹ yet: the owner will be able to transfer it at the specified unixtime.", + "links": [ + "https://core.telegram.org/api/gifts#transferring-collectible-gifts" + ] }, "can_upgrade": { "name": "can_upgrade", - "description": " " + "description": "Only set for non-collectible gifts, if they can be upgraded to a collectible gift »¹.", + "links": [ + "https://core.telegram.org/api/gifts#collectible-gifts" + ] }, "convert_stars": { "name": "convert_stars", - "description": " " + "description": "For non-collectible gifts, the receiver of this gift may convert it to this many Telegram Stars, instead of displaying it on their profile page." }, "date": { "name": "date", - "description": " " + "description": "Reception date of the gift." }, "flags": { "name": "flags", @@ -29054,47 +29099,62 @@ }, "from_id": { "name": "from_id", - "description": " " + "description": "Sender of the gift (unset for anonymous gifts)." }, "gift": { "name": "gift", - "description": " " + "description": "The collectible gift." }, "message": { "name": "message", - "description": " " + "description": "Message attached to the gift." }, "msg_id": { "name": "msg_id", - "description": " " + "description": "For gifts received by users, ID to use in inputSavedStarGiftUser¹ constructors.", + "links": [ + "https://core.telegram.org/constructor/inputSavedStarGiftUser" + ] }, "name_hidden": { "name": "name_hidden", - "description": " " + "description": "If set, the gift sender in from_id and the message are set only for the receiver of the gift." }, "pinned_to_top": { "name": "pinned_to_top", - "description": " " + "description": "Whether this gift is pinned on top of the user's profile page." }, "refunded": { "name": "refunded", - "description": " " + "description": "This gift was upgraded to a collectible gift »¹ and then re-downgraded to a regular gift because a request to refund the payment related to the upgrade was made, and the money was returned.", + "links": [ + "https://core.telegram.org/api/gifts#collectible-gifts" + ] }, "saved_id": { "name": "saved_id", - "description": " " + "description": "For gifts received by channels, ID to use in inputSavedStarGiftChat¹ constructors.", + "links": [ + "https://core.telegram.org/constructor/inputSavedStarGiftChat" + ] }, "transfer_stars": { "name": "transfer_stars", - "description": " " + "description": "If set, indicates that the gift can be transferred »¹ to another user by paying the specified amount of stars.", + "links": [ + "https://core.telegram.org/api/gifts#transferring-collectible-gifts" + ] }, "unsaved": { "name": "unsaved", - "description": " " + "description": "If set, the gift is not pinned on the user's profile." }, "upgrade_stars": { "name": "upgrade_stars", - "description": " " + "description": "For non-collectible gifts, the number of Telegram Stars the user can pay to convert the gift into a collectible gift »¹.", + "links": [ + "https://core.telegram.org/api/gifts#collectible-gifts" + ] } } }, @@ -30246,7 +30306,11 @@ }, "availability_resale": { "name": "availability_resale", - "description": " " + "description": "The total number of (upgraded to collectibles¹) gifts of this type currently on resale²", + "links": [ + "https://core.telegram.org/api/gifts#collectible-gifts", + "https://core.telegram.org/api/gifts#selling-collectible-gifts" + ] }, "availability_total": { "name": "availability_total", @@ -30285,11 +30349,15 @@ }, "released_by": { "name": "released_by", - "description": " " + "description": "This gift was released by the specified peer." }, "resell_min_stars": { "name": "resell_min_stars", - "description": " " + "description": "The minimum price in Stars¹ for gifts of this type currently on resale².", + "links": [ + "https://core.telegram.org/api/stars", + "https://core.telegram.org/api/gifts#selling-collectible-gifts" + ] }, "sold_out": { "name": "sold_out", @@ -30311,11 +30379,14 @@ }, "title": { "name": "title", - "description": " " + "description": "Title of the gift" }, "upgrade_stars": { "name": "upgrade_stars", - "description": " " + "description": "The number of Telegram Stars the user can pay to convert the gift into a collectible gift »¹.", + "links": [ + "https://core.telegram.org/api/gifts#collectible-gifts" + ] } } }, @@ -30501,11 +30572,11 @@ }, "availability_issued": { "name": "availability_issued", - "description": " " + "description": "Total number of gifts of the same type that were upgraded to a collectible gift." }, "availability_total": { "name": "availability_total", - "description": " " + "description": "Total number of gifts of the same type that can be upgraded or were already upgraded to a collectible gift." }, "flags": { "name": "flags", @@ -30516,7 +30587,11 @@ }, "gift_address": { "name": "gift_address", - "description": " " + "description": "For NFTs on the TON blockchain¹, contains the address of the NFT (append it to the ton_blockchain_explorer_url client configuration value »² to obtain a link with information about the address).", + "links": [ + "https://core.telegram.org/api/gifts#withdraw-a-collectible-gift-to-the-ton-blockchain", + "https://core.telegram.org/api/config#ton-blockchain-explorer-url" + ] }, "id": { "name": "id", @@ -30524,23 +30599,27 @@ }, "num": { "name": "num", - "description": "Unique identifier of this collectible gift among all collectible gifts of the same type." + "description": "Unique identifier of this collectible gift among all (already upgraded) collectible gifts of the same type." }, "owner_address": { "name": "owner_address", - "description": " " + "description": "For NFTs on the TON blockchain¹, contains the address of the owner (append it to the ton_blockchain_explorer_url client configuration value »² to obtain a link with information about the address).", + "links": [ + "https://core.telegram.org/api/gifts#withdraw-a-collectible-gift-to-the-ton-blockchain", + "https://core.telegram.org/api/config#ton-blockchain-explorer-url" + ] }, "owner_id": { "name": "owner_id", - "description": " " + "description": "The owner of the gift." }, "owner_name": { "name": "owner_name", - "description": " " + "description": "The name of the owner if neither owner_id nor owner_address are set." }, "released_by": { "name": "released_by", - "description": " " + "description": "This gift was released by the specified peer." }, "resell_stars": { "name": "resell_stars", @@ -30552,7 +30631,11 @@ }, "slug": { "name": "slug", - "description": " " + "description": "Slug that can be used to create a collectible gift deep link »¹, or elsewhere in the API where a collectible slug is accepted².", + "links": [ + "https://core.telegram.org/api/links#collectible-gift-link", + "https://core.telegram.org/api/gifts" + ] }, "title": { "name": "title", @@ -35496,7 +35579,7 @@ "fields": { "private": { "name": "private", - "description": "Whether paid reaction privacy is enabled or disabled." + "description": "Paid reaction privacy settings." } } }, @@ -49987,7 +50070,10 @@ }, "for_paid_reactions": { "name": "for_paid_reactions", - "description": " " + "description": "If set, fetches the list of peers that can be used to send paid reactions¹ to messages of a specific peer.", + "links": [ + "https://core.telegram.org/api/reactions#paid-reactions" + ] }, "peer": { "name": "peer", @@ -55654,7 +55740,7 @@ }, "video_timestamp": { "name": "video_timestamp", - "description": " " + "description": "Start playing the video at the specified timestamp (seconds)." }, "with_my_score": { "name": "with_my_score", @@ -63175,13 +63261,10 @@ }, "private": { "name": "private", - "description": "Each post with star reactions has a leaderboard with the top senders, but users can opt out of appearing there if they prefer more privacy. If the user explicitly chose to make their paid reaction(s) private, pass boolTrue¹ to messages.sendPaidReaction².private. If the user explicitly chose to make their paid reaction(s) not private, pass boolFalse³ to messages.sendPaidReaction⁴.private. If the user did not make any explicit choice about the privacy of their paid reaction(s) (i.e. when reacting by clicking on an existing star reaction on a message), do not populate the messages.sendPaidReaction⁵.private flag.", + "description": "Each post with star reactions has a leaderboard with the top senders, but users can opt out of appearing there if they prefer more privacy. Not populating this field will use the default reaction privacy, stored on the server and synced to clients using updatePaidReactionPrivacy¹ (see here² for more info).", "links": [ - "https://core.telegram.org/constructor/boolTrue", - "https://core.telegram.org/method/messages.sendPaidReaction", - "https://core.telegram.org/constructor/boolTrue", - "https://core.telegram.org/method/messages.sendPaidReaction", - "https://core.telegram.org/method/messages.sendPaidReaction" + "https://core.telegram.org/constructor/updatePaidReactionPrivacy", + "https://core.telegram.org/api/reactions#paid-reaction-privacy" ] }, "random_id": { @@ -67357,14 +67440,20 @@ }, "payments.toggleStarGiftsPinnedToTop": { "name": "payments.toggleStarGiftsPinnedToTop", + "description": [ + "Pins a received gift on top of the profile of the user or owned channels by using payments.toggleStarGiftsPinnedToTop¹." + ], + "links": [ + "https://core.telegram.org/method/payments.toggleStarGiftsPinnedToTop" + ], "parameters": { "peer": { "name": "peer", - "description": " " + "description": "The peer where to pin the gift." }, "stargift": { "name": "stargift", - "description": " " + "description": "The gift to pin." } }, "errors": [ diff --git a/_schema/latest.json b/_schema/latest.json index 6b9f8bb..393e4c9 100644 --- a/_schema/latest.json +++ b/_schema/latest.json @@ -7479,7 +7479,10 @@ }, "bot_verification": { "name": "bot_verification", - "description": " " + "description": "Bot verification icon¹", + "links": [ + "https://core.telegram.org/api/bots/verification" + ] }, "call": { "name": "call", @@ -7732,11 +7735,17 @@ }, "stargifts_available": { "name": "stargifts_available", - "description": " " + "description": "If set, users may send Gifts »¹ to this channel.", + "links": [ + "https://core.telegram.org/api/gifts" + ] }, "stargifts_count": { "name": "stargifts_count", - "description": " " + "description": "Admins with chatAdminRights¹.post_messages rights will see the total number of received gifts, everyone else will see the number of gifts added to the channel's profile.", + "links": [ + "https://core.telegram.org/constructor/chatAdminRights" + ] }, "stats_dc": { "name": "stats_dc", @@ -14825,7 +14834,10 @@ }, "include_upgrade": { "name": "include_upgrade", - "description": " " + "description": "Also pay for an eventual upgrade of the gift to a collectible gift »¹.", + "links": [ + "https://core.telegram.org/api/gifts#collectible-gifts" + ] }, "message": { "name": "message", @@ -14836,7 +14848,7 @@ }, "peer": { "name": "peer", - "description": " " + "description": "Receiver of the gift." } } }, @@ -15164,11 +15176,11 @@ }, "video_cover": { "name": "video_cover", - "description": " " + "description": "Custom video cover." }, "video_timestamp": { "name": "video_timestamp", - "description": " " + "description": "Start playing the video at the specified timestamp (seconds)." } } }, @@ -15199,11 +15211,11 @@ }, "video_cover": { "name": "video_cover", - "description": " " + "description": "Custom video cover." }, "video_timestamp": { "name": "video_timestamp", - "description": " " + "description": "Start playing the video at the specified timestamp (seconds)." } } }, @@ -15548,7 +15560,7 @@ }, "video_cover": { "name": "video_cover", - "description": " " + "description": "Start playing the video at the specified timestamp (seconds)." }, "video_timestamp": { "name": "video_timestamp", @@ -20121,7 +20133,10 @@ }, "upgrade_stars": { "name": "upgrade_stars", - "description": " " + "description": "The number of Telegram Stars the user can pay to convert the gift into a collectible gift »¹.", + "links": [ + "https://core.telegram.org/api/gifts#collectible-gifts" + ] }, "upgraded": { "name": "upgraded", @@ -20144,7 +20159,10 @@ "fields": { "can_export_at": { "name": "can_export_at", - "description": " " + "description": "If set, indicates that the current gift can't be exported to the TON blockchain »¹ yet: the owner will be able to export it at the specified unixtime.", + "links": [ + "https://core.telegram.org/api/gifts#withdraw-a-collectible-gift-to-the-ton-blockchain" + ] }, "can_resell_at": { "name": "can_resell_at", @@ -21185,11 +21203,11 @@ }, "video_cover": { "name": "video_cover", - "description": " " + "description": "Custom video cover." }, "video_timestamp": { "name": "video_timestamp", - "description": " " + "description": "Start playing the video at the specified timestamp (seconds)." }, "voice": { "name": "voice", @@ -25174,17 +25192,32 @@ } }, "paidReactionPrivacyAnonymous": { - "name": "paidReactionPrivacyAnonymous" + "name": "paidReactionPrivacyAnonymous", + "description": [ + "Send paid reactions anonymously." + ] }, "paidReactionPrivacyDefault": { - "name": "paidReactionPrivacyDefault" + "name": "paidReactionPrivacyDefault", + "description": [ + "Uses the default reaction privacy, set using messages.togglePaidReactionPrivacy¹." + ], + "links": [ + "https://core.telegram.org/method/messages.togglePaidReactionPrivacy" + ] }, "paidReactionPrivacyPeer": { "name": "paidReactionPrivacyPeer", + "description": [ + "Send paid reactions as the specified peer, fetched using channels.getSendAs¹." + ], + "links": [ + "https://core.telegram.org/method/channels.getSendAs" + ], "fields": { "peer": { "name": "peer", - "description": " " + "description": "The peer to send reactions as." } } }, @@ -29023,27 +29056,39 @@ "fields": { "can_export_at": { "name": "can_export_at", - "description": " " + "description": "If set, indicates that the current gift can't be exported to the TON blockchain »¹ yet: the owner will be able to export it at the specified unixtime.", + "links": [ + "https://core.telegram.org/api/gifts#withdraw-a-collectible-gift-to-the-ton-blockchain" + ] }, "can_resell_at": { "name": "can_resell_at", - "description": " " + "description": "If set, indicates that the current gift can't be resold »¹ yet: the owner will be able to put it up for sale at the specified unixtime.", + "links": [ + "https://core.telegram.org/api/gifts#sell-a-collectible-gift" + ] }, "can_transfer_at": { "name": "can_transfer_at", - "description": " " + "description": "If set, indicates that the current gift can't be transferred »¹ yet: the owner will be able to transfer it at the specified unixtime.", + "links": [ + "https://core.telegram.org/api/gifts#transferring-collectible-gifts" + ] }, "can_upgrade": { "name": "can_upgrade", - "description": " " + "description": "Only set for non-collectible gifts, if they can be upgraded to a collectible gift »¹.", + "links": [ + "https://core.telegram.org/api/gifts#collectible-gifts" + ] }, "convert_stars": { "name": "convert_stars", - "description": " " + "description": "For non-collectible gifts, the receiver of this gift may convert it to this many Telegram Stars, instead of displaying it on their profile page." }, "date": { "name": "date", - "description": " " + "description": "Reception date of the gift." }, "flags": { "name": "flags", @@ -29054,47 +29099,62 @@ }, "from_id": { "name": "from_id", - "description": " " + "description": "Sender of the gift (unset for anonymous gifts)." }, "gift": { "name": "gift", - "description": " " + "description": "The collectible gift." }, "message": { "name": "message", - "description": " " + "description": "Message attached to the gift." }, "msg_id": { "name": "msg_id", - "description": " " + "description": "For gifts received by users, ID to use in inputSavedStarGiftUser¹ constructors.", + "links": [ + "https://core.telegram.org/constructor/inputSavedStarGiftUser" + ] }, "name_hidden": { "name": "name_hidden", - "description": " " + "description": "If set, the gift sender in from_id and the message are set only for the receiver of the gift." }, "pinned_to_top": { "name": "pinned_to_top", - "description": " " + "description": "Whether this gift is pinned on top of the user's profile page." }, "refunded": { "name": "refunded", - "description": " " + "description": "This gift was upgraded to a collectible gift »¹ and then re-downgraded to a regular gift because a request to refund the payment related to the upgrade was made, and the money was returned.", + "links": [ + "https://core.telegram.org/api/gifts#collectible-gifts" + ] }, "saved_id": { "name": "saved_id", - "description": " " + "description": "For gifts received by channels, ID to use in inputSavedStarGiftChat¹ constructors.", + "links": [ + "https://core.telegram.org/constructor/inputSavedStarGiftChat" + ] }, "transfer_stars": { "name": "transfer_stars", - "description": " " + "description": "If set, indicates that the gift can be transferred »¹ to another user by paying the specified amount of stars.", + "links": [ + "https://core.telegram.org/api/gifts#transferring-collectible-gifts" + ] }, "unsaved": { "name": "unsaved", - "description": " " + "description": "If set, the gift is not pinned on the user's profile." }, "upgrade_stars": { "name": "upgrade_stars", - "description": " " + "description": "For non-collectible gifts, the number of Telegram Stars the user can pay to convert the gift into a collectible gift »¹.", + "links": [ + "https://core.telegram.org/api/gifts#collectible-gifts" + ] } } }, @@ -30246,7 +30306,11 @@ }, "availability_resale": { "name": "availability_resale", - "description": " " + "description": "The total number of (upgraded to collectibles¹) gifts of this type currently on resale²", + "links": [ + "https://core.telegram.org/api/gifts#collectible-gifts", + "https://core.telegram.org/api/gifts#selling-collectible-gifts" + ] }, "availability_total": { "name": "availability_total", @@ -30285,11 +30349,15 @@ }, "released_by": { "name": "released_by", - "description": " " + "description": "This gift was released by the specified peer." }, "resell_min_stars": { "name": "resell_min_stars", - "description": " " + "description": "The minimum price in Stars¹ for gifts of this type currently on resale².", + "links": [ + "https://core.telegram.org/api/stars", + "https://core.telegram.org/api/gifts#selling-collectible-gifts" + ] }, "sold_out": { "name": "sold_out", @@ -30311,11 +30379,14 @@ }, "title": { "name": "title", - "description": " " + "description": "Title of the gift" }, "upgrade_stars": { "name": "upgrade_stars", - "description": " " + "description": "The number of Telegram Stars the user can pay to convert the gift into a collectible gift »¹.", + "links": [ + "https://core.telegram.org/api/gifts#collectible-gifts" + ] } } }, @@ -30501,11 +30572,11 @@ }, "availability_issued": { "name": "availability_issued", - "description": " " + "description": "Total number of gifts of the same type that were upgraded to a collectible gift." }, "availability_total": { "name": "availability_total", - "description": " " + "description": "Total number of gifts of the same type that can be upgraded or were already upgraded to a collectible gift." }, "flags": { "name": "flags", @@ -30516,7 +30587,11 @@ }, "gift_address": { "name": "gift_address", - "description": " " + "description": "For NFTs on the TON blockchain¹, contains the address of the NFT (append it to the ton_blockchain_explorer_url client configuration value »² to obtain a link with information about the address).", + "links": [ + "https://core.telegram.org/api/gifts#withdraw-a-collectible-gift-to-the-ton-blockchain", + "https://core.telegram.org/api/config#ton-blockchain-explorer-url" + ] }, "id": { "name": "id", @@ -30524,23 +30599,27 @@ }, "num": { "name": "num", - "description": "Unique identifier of this collectible gift among all collectible gifts of the same type." + "description": "Unique identifier of this collectible gift among all (already upgraded) collectible gifts of the same type." }, "owner_address": { "name": "owner_address", - "description": " " + "description": "For NFTs on the TON blockchain¹, contains the address of the owner (append it to the ton_blockchain_explorer_url client configuration value »² to obtain a link with information about the address).", + "links": [ + "https://core.telegram.org/api/gifts#withdraw-a-collectible-gift-to-the-ton-blockchain", + "https://core.telegram.org/api/config#ton-blockchain-explorer-url" + ] }, "owner_id": { "name": "owner_id", - "description": " " + "description": "The owner of the gift." }, "owner_name": { "name": "owner_name", - "description": " " + "description": "The name of the owner if neither owner_id nor owner_address are set." }, "released_by": { "name": "released_by", - "description": " " + "description": "This gift was released by the specified peer." }, "resell_stars": { "name": "resell_stars", @@ -30552,7 +30631,11 @@ }, "slug": { "name": "slug", - "description": " " + "description": "Slug that can be used to create a collectible gift deep link »¹, or elsewhere in the API where a collectible slug is accepted².", + "links": [ + "https://core.telegram.org/api/links#collectible-gift-link", + "https://core.telegram.org/api/gifts" + ] }, "title": { "name": "title", @@ -35496,7 +35579,7 @@ "fields": { "private": { "name": "private", - "description": "Whether paid reaction privacy is enabled or disabled." + "description": "Paid reaction privacy settings." } } }, @@ -49987,7 +50070,10 @@ }, "for_paid_reactions": { "name": "for_paid_reactions", - "description": " " + "description": "If set, fetches the list of peers that can be used to send paid reactions¹ to messages of a specific peer.", + "links": [ + "https://core.telegram.org/api/reactions#paid-reactions" + ] }, "peer": { "name": "peer", @@ -55654,7 +55740,7 @@ }, "video_timestamp": { "name": "video_timestamp", - "description": " " + "description": "Start playing the video at the specified timestamp (seconds)." }, "with_my_score": { "name": "with_my_score", @@ -63175,13 +63261,10 @@ }, "private": { "name": "private", - "description": "Each post with star reactions has a leaderboard with the top senders, but users can opt out of appearing there if they prefer more privacy. If the user explicitly chose to make their paid reaction(s) private, pass boolTrue¹ to messages.sendPaidReaction².private. If the user explicitly chose to make their paid reaction(s) not private, pass boolFalse³ to messages.sendPaidReaction⁴.private. If the user did not make any explicit choice about the privacy of their paid reaction(s) (i.e. when reacting by clicking on an existing star reaction on a message), do not populate the messages.sendPaidReaction⁵.private flag.", + "description": "Each post with star reactions has a leaderboard with the top senders, but users can opt out of appearing there if they prefer more privacy. Not populating this field will use the default reaction privacy, stored on the server and synced to clients using updatePaidReactionPrivacy¹ (see here² for more info).", "links": [ - "https://core.telegram.org/constructor/boolTrue", - "https://core.telegram.org/method/messages.sendPaidReaction", - "https://core.telegram.org/constructor/boolTrue", - "https://core.telegram.org/method/messages.sendPaidReaction", - "https://core.telegram.org/method/messages.sendPaidReaction" + "https://core.telegram.org/constructor/updatePaidReactionPrivacy", + "https://core.telegram.org/api/reactions#paid-reaction-privacy" ] }, "random_id": { @@ -67357,14 +67440,20 @@ }, "payments.toggleStarGiftsPinnedToTop": { "name": "payments.toggleStarGiftsPinnedToTop", + "description": [ + "Pins a received gift on top of the profile of the user or owned channels by using payments.toggleStarGiftsPinnedToTop¹." + ], + "links": [ + "https://core.telegram.org/method/payments.toggleStarGiftsPinnedToTop" + ], "parameters": { "peer": { "name": "peer", - "description": " " + "description": "The peer where to pin the gift." }, "stargift": { "name": "stargift", - "description": " " + "description": "The gift to pin." } }, "errors": [ @@ -73613,7 +73702,7 @@ "description": "The invite hash is empty." }, "INVITE_HASH_EXPIRED": { - "code": 400, + "code": 406, "type": "INVITE_HASH_EXPIRED", "description": "The invite link has expired." },