telegrinder 0.1.dev168__py3-none-any.whl → 0.1.dev170__py3-none-any.whl

telegrinder/bot/cute_types/message.py

@@ -39,7 +39,8 @@ from .utils import (
 if typing.TYPE_CHECKING:
     from datetime import datetime
 
-    from .callback_query import CallbackQueryCute
+    from telegrinder.bot.cute_types.callback_query import CallbackQueryCute
+
 
 MediaType: typing.TypeAlias = typing.Literal[
     "animation",
@@ -48,12 +49,7 @@ MediaType: typing.TypeAlias = typing.Literal[
     "photo",
     "video",
 ]
-ReplyMarkup: typing.TypeAlias = typing.Union[
-    InlineKeyboardMarkup,
-    ReplyKeyboardMarkup,
-    ReplyKeyboardRemove,
-    ForceReply,
-]
+ReplyMarkup: typing.TypeAlias = InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply
 
 
 async def execute_method_answer(
@@ -84,9 +80,9 @@ async def execute_method_answer(
             x
             if isinstance(x, bool)
             else (
-                MessageCute.from_update(x, bound_api=message.api)
+                message.from_update(x, bound_api=message.api)
                 if not isinstance(x, list)
-                else [MessageCute.from_update(m, bound_api=message.api) for m in x]
+                else [message.from_update(m, bound_api=message.api) for m in x]
             )
         )
     )
@@ -124,12 +120,14 @@ async def execute_method_edit(
             ),
         },
     )
+
     if "inline_message_id" in params:
         params.pop("message_id", None)
         params.pop("chat_id", None)
+
     result = await getattr(update.ctx_api, method_name)(**params)
     return result.map(
-        lambda v: Variative[MessageCute, bool](
+        lambda v: Variative["MessageCute", bool](
             v.only()
             .map(
                 lambda x: MessageCute.from_update(x, bound_api=update.api),
@@ -183,7 +181,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     @shortcut(
         "send_message",
         executor=execute_method_answer,
-        custom_params={"link_preview_options", "reply_parameters", "message_thread_id"},
+        custom_params={"link_preview_options", "reply_parameters", "message_thread_id", "chat_id", "text"},
     )
     async def answer(
         self,
@@ -191,6 +189,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         chat_id: int | str | None = None,
         message_thread_id: int | None = None,
         business_connection_id: str | None = None,
+        message_effect_id: str | None = None,
         parse_mode: str | None = None,
         entities: list[MessageEntity] | None = None,
         disable_notification: bool | None = None,
@@ -221,6 +220,9 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         :param entities: A JSON-serialized list of special entities that appear in message text, \
         which can be specified instead of parse_mode.
 
+        :param message_effect_id: Unique identifier of the message effect to be added to the message; for private \
+        chats only.
+
         :param link_preview_options: Link preview generation options for the message.
 
         :param disable_notification: Sends the message silently. Users will receive a notification with no sound. \
@@ -238,7 +240,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     @shortcut(
         "send_message",
         executor=execute_method_reply,
-        custom_params={"reply_parameters", "message_thread_id"},
+        custom_params={"reply_parameters", "message_thread_id", "chat_id", "message_id"},
     )
     async def reply(
         self,
@@ -247,6 +249,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         message_id: int | None = None,
         message_thread_id: int | None = None,
         business_connection_id: str | None = None,
+        message_effect_id: str | None = None,
         parse_mode: str | None = None,
         entities: list[MessageEntity] | None = None,
         disable_notification: bool | None = None,
@@ -261,8 +264,8 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         Use this method to send a reply to a message with text messages. On success, the sent Message is returned.
 
         :param business_connection_id: Unique identifier of the business connection on behalf of which the message \
-        will be sent.    
-    
+        will be sent.
+
         :param chat_id: Unique identifier for the target chat or username of the target channel \
         (in the format @channelusername).
 
@@ -277,6 +280,9 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         :param entities: A JSON-serialized list of special entities that appear in message text, \
         which can be specified instead of parse_mode.
 
+        :param message_effect_id: Unique identifier of the message effect to be added to the message; for private \
+        chats only.
+
         :param link_preview_options: Link preview generation options for the message.
 
         :param disable_notification: Sends the message silently. Users will receive a notification with no sound. \
@@ -291,7 +297,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
 
         ...
 
-    @shortcut("delete_message", custom_params={"message_thread_id"})
+    @shortcut("delete_message", custom_params={"message_thread_id", "chat_id", "message_id"})
     async def delete(
         self,
         chat_id: int | None = None,
@@ -301,16 +307,16 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     ) -> Result[bool, APIError]:
         """Shortcut `API.delete_message()`, see the [documentation](https://core.telegram.org/bots/api#deletemessage)
 
-        Use this method to delete a message, including service messages, with the 
-        following limitations: - A message can only be deleted if it was sent less 
-        than 48 hours ago. - Service messages about a supergroup, channel, or forum 
-        topic creation can't be deleted. - A dice message in a private chat can only 
-        be deleted if it was sent more than 24 hours ago. - Bots can delete outgoing 
-        messages in private chats, groups, and supergroups. - Bots can delete incoming 
-        messages in private chats. - Bots granted can_post_messages permissions 
-        can delete outgoing messages in channels. - If the bot is an administrator 
-        of a group, it can delete any message there. - If the bot has can_delete_messages 
-        permission in a supergroup or a channel, it can delete any message there. 
+        Use this method to delete a message, including service messages, with the
+        following limitations: - A message can only be deleted if it was sent less
+        than 48 hours ago. - Service messages about a supergroup, channel, or forum
+        topic creation can't be deleted. - A dice message in a private chat can only
+        be deleted if it was sent more than 24 hours ago. - Bots can delete outgoing
+        messages in private chats, groups, and supergroups. - Bots can delete incoming
+        messages in private chats. - Bots granted can_post_messages permissions
+        can delete outgoing messages in channels. - If the bot is an administrator
+        of a group, it can delete any message there. - If the bot has can_delete_messages
+        permission in a supergroup or a channel, it can delete any message there.
         Returns True on success.
 
         :param chat_id: Unique identifier for the target chat or username of the target channel \
@@ -332,7 +338,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     @shortcut(
         "edit_message_text",
         executor=execute_method_edit,
-        custom_params={"link_preview_options", "message_thread_id"},
+        custom_params={"link_preview_options", "message_thread_id", "message_id"},
     )
     async def edit(
         self,
@@ -348,8 +354,8 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     ) -> Result[Variative[MessageCute, bool], APIError]:
         """Shortcut `API.edit_message_text()`, see the [documentation](https://core.telegram.org/bots/api#editmessagetext)
 
-        Use this method to edit text and game messages. On success, if the edited 
-        message is not an inline message, the edited Message is returned, otherwise 
+        Use this method to edit text and game messages. On success, if the edited
+        message is not an inline message, the edited Message is returned, otherwise
         True is returned.
 
         :param chat_id: Required if inline_message_id is not specified. Unique identifier for \
@@ -377,7 +383,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
 
     @shortcut(
         "copy_message",
-        custom_params={"reply_parameters", "message_thread_id"},
+        custom_params={"reply_parameters", "message_thread_id", "chat_id", "message_id", "from_chat_id"},
     )
     async def copy(
         self,
@@ -396,11 +402,11 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     ) -> Result[MessageId, APIError]:
         """Shortcut `API.copy_message()`, see the [documentation](https://core.telegram.org/bots/api#copymessage)
 
-        Use this method to copy messages of any kind. Service messages, giveaway 
-        messages, giveaway winners messages, and invoice messages can't be copied. 
-        A quiz poll can be copied only if the value of the field correct_option_id 
-        is known to the bot. The method is analogous to the method forwardMessage, 
-        but the copied message doesn't have a link to the original message. Returns 
+        Use this method to copy messages of any kind. Service messages, giveaway
+        messages, giveaway winners messages, and invoice messages can't be copied.
+        A quiz poll can be copied only if the value of the field correct_option_id
+        is known to the bot. The method is analogous to the method forwardMessage,
+        but the copied message doesn't have a link to the original message. Returns
         the MessageId of the sent message on success.
 
         :param chat_id: Unique identifier for the target chat or username of the target channel \
@@ -453,7 +459,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
 
     @shortcut(
         "set_message_reaction",
-        custom_params={"message_thread_id"},
+        custom_params={"message_thread_id", "reaction", "chat_id", "message_id"},
     )
     async def react(
         self,
@@ -468,9 +474,9 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     ) -> Result[bool, APIError]:
         """Shortcut `API.set_message_reaction()`, see the [documentation](https://core.telegram.org/bots/api#setmessagereaction)
 
-        Use this method to change the chosen reactions on a message. Service messages 
-        can't be reacted to. Automatically forwarded messages from a channel to 
-        its discussion group have the same available reactions as messages in the 
+        Use this method to change the chosen reactions on a message. Service messages
+        can't be reacted to. Automatically forwarded messages from a channel to
+        its discussion group have the same available reactions as messages in the
         channel. Returns True on success.
 
         :param chat_id: Unique identifier for the target chat or username of the target channel \
@@ -502,7 +508,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
             )
         return await self.ctx_api.set_message_reaction(**params)
 
-    @shortcut("forward_message", custom_params={"message_thread_id"})
+    @shortcut("forward_message", custom_params={"message_thread_id", "from_chat_id", "message_id"})
     async def forward(
         self,
         chat_id: int | str,
@@ -515,8 +521,8 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     ) -> Result[MessageCute, APIError]:
         """Shortcut `API.forward_message()`, see the [documentation](https://core.telegram.org/bots/api#forwardmessage)
 
-        Use this method to forward messages of any kind. Service messages and messages 
-        with protected content can't be forwarded. On success, the sent Message 
+        Use this method to forward messages of any kind. Service messages and messages
+        with protected content can't be forwarded. On success, the sent Message
         is returned.
 
         :param chat_id: Unique identifier for the target chat or username of the target channel \
@@ -548,7 +554,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
             lambda message: MessageCute.from_update(message, bound_api=self.api),
         )
 
-    @shortcut("pin_chat_message", custom_params={"message_thread_id"})
+    @shortcut("pin_chat_message", custom_params={"message_thread_id", "chat_id", "message_id"})
     async def pin(
         self,
         chat_id: int | str | None = None,
@@ -559,10 +565,10 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     ) -> Result[bool, "APIError"]:
         """Shortcut `API.pin_chat_message()`, see the [documentation](https://core.telegram.org/bots/api#pinchatmessage)
 
-        Use this method to add a message to the list of pinned messages in a chat. If 
-        the chat is not a private chat, the bot must be an administrator in the chat 
-        for this to work and must have the 'can_pin_messages' administrator right 
-        in a supergroup or 'can_edit_messages' administrator right in a channel. 
+        Use this method to add a message to the list of pinned messages in a chat. If
+        the chat is not a private chat, the bot must be an administrator in the chat
+        for this to work and must have the 'can_pin_messages' administrator right
+        in a supergroup or 'can_edit_messages' administrator right in a channel.
         Returns True on success.
 
         :param chat_id: Unique identifier for the target chat or username of the target channel \
@@ -586,7 +592,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         )
         return await self.ctx_api.pin_chat_message(**params)
 
-    @shortcut("unpin_chat_message", custom_params={"message_thread_id"})
+    @shortcut("unpin_chat_message", custom_params={"message_thread_id", "chat_id", "message_id"})
     async def unpin(
         self,
         chat_id: int | str | None = None,
@@ -596,10 +602,10 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     ) -> Result[bool, "APIError"]:
         """Shortcut `API.unpin_chat_message()`, see the [documentation](https://core.telegram.org/bots/api#unpinchatmessage)
 
-        Use this method to remove a message from the list of pinned messages in a chat. 
-        If the chat is not a private chat, the bot must be an administrator in the chat 
-        for this to work and must have the 'can_pin_messages' administrator right 
-        in a supergroup or 'can_edit_messages' administrator right in a channel. 
+        Use this method to remove a message from the list of pinned messages in a chat.
+        If the chat is not a private chat, the bot must be an administrator in the chat
+        for this to work and must have the 'can_pin_messages' administrator right
+        in a supergroup or 'can_edit_messages' administrator right in a channel.
         Returns True on success.
 
         :param chat_id: Unique identifier for the target chat or username of the target channel \
@@ -620,7 +626,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     @shortcut(
         "send_audio",
         executor=execute_method_answer,
-        custom_params={"reply_parameters", "message_thread_id"},
+        custom_params={"reply_parameters", "message_thread_id", "chat_id"},
     )
     async def answer_audio(
         self,
@@ -628,6 +634,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         chat_id: int | str | None = None,
         message_thread_id: int | None = None,
         business_connection_id: str | None = None,
+        message_effect_id: str | None = None,
         caption: str | None = None,
         parse_mode: str | None = None,
         caption_entities: list[MessageEntity] | None = None,
@@ -643,10 +650,10 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     ) -> Result[MessageCute, APIError]:
         """Shortcut `API.send_audio()`, see the [documentation](https://core.telegram.org/bots/api#sendaudio)
 
-        Use this method to send audio files, if you want Telegram clients to display 
-        them in the music player. Your audio must be in the .MP3 or .M4A format. On 
-        success, the sent Message is returned. Bots can currently send audio files 
-        of up to 50 MB in size, this limit may be changed in the future. For sending 
+        Use this method to send audio files, if you want Telegram clients to display
+        them in the music player. Your audio must be in the .MP3 or .M4A format. On
+        success, the sent Message is returned. Bots can currently send audio files
+        of up to 50 MB in size, this limit may be changed in the future. For sending
         voice messages, use the sendVoice method instead.
 
         :param business_connection_id: Unique identifier of the business connection on behalf of which the message \
@@ -658,6 +665,9 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for \
         forum supergroups only.
 
+        :param message_effect_id: Unique identifier of the message effect to be added to the message; for private \
+        chats only.
+
         :param audio: Audio file to send. Pass a file_id as String to send an audio file that exists \
         on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram \
         to get an audio file from the Internet, or upload a new one using multipart/form-data. \
@@ -700,7 +710,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     @shortcut(
         "send_animation",
         executor=execute_method_answer,
-        custom_params={"reply_parameters", "message_thread_id"},
+        custom_params={"reply_parameters", "message_thread_id", "chat_id"},
     )
     async def answer_animation(
         self,
@@ -708,9 +718,11 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         chat_id: int | str | None = None,
         message_thread_id: int | None = None,
         business_connection_id: str | None = None,
+        message_effect_id: str | None = None,
         caption: str | None = None,
         parse_mode: str | None = None,
         caption_entities: list[MessageEntity] | None = None,
+        show_caption_above_media: bool | None = None,
         duration: int | None = None,
         width: int | None = None,
         height: int | None = None,
@@ -724,8 +736,8 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     ) -> Result[MessageCute, APIError]:
         """Shortcut `API.send_animation()`, see the [documentation](https://core.telegram.org/bots/api#sendanimation)
 
-        Use this method to send animation files (GIF or H.264/MPEG-4 AVC video without 
-        sound). On success, the sent Message is returned. Bots can currently send 
+        Use this method to send animation files (GIF or H.264/MPEG-4 AVC video without
+        sound). On success, the sent Message is returned. Bots can currently send
         animation files of up to 50 MB in size, this limit may be changed in the future.
 
         :param business_connection_id: Unique identifier of the business connection on behalf of which the message \
@@ -737,6 +749,9 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for \
         forum supergroups only.
 
+        :param message_effect_id: Unique identifier of the message effect to be added to the message; for private \
+        chats only.
+
         :param animation: Animation to send. Pass a file_id as String to send an animation that exists \
         on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram \
         to get an animation from the Internet, or upload a new animation using multipart/form-data. \
@@ -765,6 +780,8 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         :param caption_entities: A JSON-serialized list of special entities that appear in the caption, \
         which can be specified instead of parse_mode.
 
+        :param show_caption_above_media: Pass True, if the caption must be shown above the message media.
+
         :param has_spoiler: Pass True if the animation needs to be covered with a spoiler animation. \
 
         :param disable_notification: Sends the message silently. Users will receive a notification with no sound. \
@@ -782,7 +799,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     @shortcut(
         "send_document",
         executor=execute_method_answer,
-        custom_params={"reply_parameters", "message_thread_id"},
+        custom_params={"reply_parameters", "message_thread_id", "chat_id"},
     )
     async def answer_document(
         self,
@@ -790,10 +807,12 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         chat_id: int | str | None = None,
         message_thread_id: int | None = None,
         business_connection_id: str | None = None,
+        message_effect_id: str | None = None,
         caption: str | None = None,
         parse_mode: str | None = None,
         caption_entities: list[MessageEntity] | None = None,
         disable_content_type_detection: bool | None = None,
+        show_caption_above_media: bool | None = None,
         thumbnail: InputFile | str | None = None,
         disable_notification: bool | None = None,
         protect_content: bool | None = None,
@@ -803,13 +822,16 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     ) -> Result[MessageCute, APIError]:
         """Shortcut `API.send_document()`, see the [documentation](https://core.telegram.org/bots/api#senddocument)
 
-        Use this method to send general files. On success, the sent Message is returned. 
-        Bots can currently send files of any type of up to 50 MB in size, this limit 
+        Use this method to send general files. On success, the sent Message is returned.
+        Bots can currently send files of any type of up to 50 MB in size, this limit
         may be changed in the future.
 
         :param business_connection_id: Unique identifier of the business connection on behalf of which the message \
         will be sent.
 
+        :param message_effect_id: Unique identifier of the message effect to be added to the message; for private \
+        chats only.
+
         :param chat_id: Unique identifier for the target chat or username of the target channel \
         (in the format @channelusername).
 
@@ -841,6 +863,8 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         :param disable_content_type_detection: Disables automatic server-side content type detection for files uploaded \
         using multipart/form-data.
 
+        :param show_caption_above_media: Pass True, if the caption must be shown above the message media.
+
         :param disable_notification: Sends the message silently. Users will receive a notification with no sound. \
 
         :param protect_content: Protects the contents of the sent message from forwarding and saving.
@@ -856,7 +880,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     @shortcut(
         "send_photo",
         executor=execute_method_answer,
-        custom_params={"reply_parameters", "message_thread_id"},
+        custom_params={"reply_parameters", "message_thread_id", "chat_id"},
     )
     async def answer_photo(
         self,
@@ -864,9 +888,11 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         chat_id: int | str | None = None,
         message_thread_id: int | None = None,
         business_connection_id: str | None = None,
+        message_effect_id: str | None = None,
         caption: str | None = None,
         parse_mode: str | None = None,
         caption_entities: list[MessageEntity] | None = None,
+        show_caption_above_media: bool | None = None,
         has_spoiler: bool | None = None,
         disable_notification: bool | None = None,
         protect_content: bool | None = None,
@@ -887,6 +913,9 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for \
         forum supergroups only.
 
+        :param message_effect_id: Unique identifier of the message effect to be added to the message; for private \
+        chats only.
+
         :param photo: Photo to send. Pass a file_id as String to send a photo that exists on the Telegram \
         servers (recommended), pass an HTTP URL as a String for Telegram to get a \
         photo from the Internet, or upload a new photo using multipart/form-data. \
@@ -909,6 +938,8 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
 
         :param protect_content: Protects the contents of the sent message from forwarding and saving.
 
+        :param show_caption_above_media: Pass True, if the caption must be shown above the message media.
+
         :param reply_parameters: Description of the message to reply to.
 
         :param reply_markup: Additional interface options. A JSON-serialized object for an inline \
@@ -920,7 +951,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     @shortcut(
         "send_sticker",
         executor=execute_method_answer,
-        custom_params={"reply_parameters", "message_thread_id"},
+        custom_params={"reply_parameters", "message_thread_id", "chat_id"},
     )
     async def answer_sticker(
         self,
@@ -928,6 +959,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         chat_id: int | str | None = None,
         emoji: str | None = None,
         message_thread_id: int | None = None,
+        message_effect_id: str | None = None,
         business_connection_id: str | None = None,
         disable_notification: bool | None = None,
         protect_content: bool | None = None,
@@ -937,7 +969,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     ) -> Result[MessageCute, APIError]:
         """Shortcut `API.send_sticker()`, see the [documentation](https://core.telegram.org/bots/api#sendsticker)
 
-        Use this method to send static .WEBP, animated .TGS, or video .WEBM stickers. 
+        Use this method to send static .WEBP, animated .TGS, or video .WEBM stickers.
         On success, the sent Message is returned.
 
         :param business_connection_id: Unique identifier of the business connection on behalf of which the message \
@@ -949,6 +981,9 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for \
         forum supergroups only.
 
+        :param message_effect_id: Unique identifier of the message effect to be added to the message; for private \
+        chats only.
+
         :param sticker: Sticker to send. Pass a file_id as String to send a file that exists on the \
         Telegram servers (recommended), pass an HTTP URL as a String for Telegram \
         to get a .WEBP sticker from the Internet, or upload a new .WEBP or .TGS sticker \
@@ -973,23 +1008,16 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     @shortcut(
         "send_video",
         executor=execute_method_answer,
-        custom_params={"reply_parameters", "message_thread_id"},
+        custom_params={"reply_parameters", "message_thread_id", "chat_id"},
     )
     async def answer_video(
         self,
         video: InputFile | str,
         chat_id: int | str | None = None,
+        emoji: str | None = None,
         message_thread_id: int | None = None,
+        message_effect_id: str | None = None,
         business_connection_id: str | None = None,
-        caption: str | None = None,
-        parse_mode: str | None = None,
-        caption_entities: list[MessageEntity] | None = None,
-        duration: int | None = None,
-        width: int | None = None,
-        height: int | None = None,
-        thumbnail: InputFile | str | None = None,
-        has_spoiler: bool | None = None,
-        supports_streaming: bool | None = None,
         disable_notification: bool | None = None,
         protect_content: bool | None = None,
         reply_parameters: ReplyParameters | dict[str, typing.Any] | None = None,
@@ -998,9 +1026,9 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     ) -> Result[MessageCute, APIError]:
         """Shortcut `API.send_video()`, see the [documentation](https://core.telegram.org/bots/api#sendvideo)
 
-        Use this method to send video files, Telegram clients support MPEG4 videos 
-        (other formats may be sent as Document). On success, the sent Message is 
-        returned. Bots can currently send video files of up to 50 MB in size, this 
+        Use this method to send video files, Telegram clients support MPEG4 videos
+        (other formats may be sent as Document). On success, the sent Message is
+        returned. Bots can currently send video files of up to 50 MB in size, this
         limit may be changed in the future.
 
         :param business_connection_id: Unique identifier of the business connection on behalf of which the message \
@@ -1012,6 +1040,9 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for \
         forum supergroups only.
 
+        :param message_effect_id: Unique identifier of the message effect to be added to the message; for private \
+        chats only.
+
         :param video: Video to send. Pass a file_id as String to send a video that exists on the Telegram \
         servers (recommended), pass an HTTP URL as a String for Telegram to get a \
         video from the Internet, or upload a new video using multipart/form-data. \
@@ -1046,6 +1077,8 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
 
         :param disable_notification: Sends the message silently. Users will receive a notification with no sound. \
 
+        :param show_caption_above_media: Pass True, if the caption must be shown above the message media.
+
         :param protect_content: Protects the contents of the sent message from forwarding and saving.
 
         :param reply_parameters: Description of the message to reply to.
@@ -1059,13 +1092,14 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     @shortcut(
         "send_video_note",
         executor=execute_method_answer,
-        custom_params={"reply_parameters", "message_thread_id"},
+        custom_params={"reply_parameters", "message_thread_id", "chat_id"},
     )
     async def answer_video_note(
         self,
         video_note: InputFile | str,
         chat_id: int | str | None = None,
         business_connection_id: str | None = None,
+        message_effect_id: str | None = None,
         duration: int | None = None,
         length: int | None = None,
         message_thread_id: int | None = None,
@@ -1078,8 +1112,8 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     ) -> Result[MessageCute, APIError]:
         """Shortcut `API.send_video_note()`, see the [documentation](https://core.telegram.org/bots/api#sendvideonote)
 
-        As of v.4.0, Telegram clients support rounded square MPEG4 videos of up 
-        to 1 minute long. Use this method to send video messages. On success, the 
+        As of v.4.0, Telegram clients support rounded square MPEG4 videos of up
+        to 1 minute long. Use this method to send video messages. On success, the
         sent Message is returned.
 
         :param business_connection_id: Unique identifier of the business connection on behalf of which the message \
@@ -1091,6 +1125,9 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for \
         forum supergroups only.
 
+        :param message_effect_id: Unique identifier of the message effect to be added to the message; for private \
+        chats only.
+
         :param video_note: Video note to send. Pass a file_id as String to send a video note that exists \
         on the Telegram servers (recommended) or upload a new video using multipart/form-data. \
         More information on Sending Files: https://core.telegram.org/bots/api#sending-files. \
@@ -1123,7 +1160,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     @shortcut(
         "send_voice",
         executor=execute_method_answer,
-        custom_params={"reply_parameters", "message_thread_id"},
+        custom_params={"reply_parameters", "message_thread_id", "chat_id"},
     )
     async def answer_voice(
         self,
@@ -1131,6 +1168,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         chat_id: int | str | None = None,
         message_thread_id: int | None = None,
         business_connection_id: str | None = None,
+        message_effect_id: str | None = None,
         caption: str | None = None,
         parse_mode: str | None = None,
         caption_entities: list[MessageEntity] | None = None,
@@ -1143,10 +1181,10 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     ) -> Result[MessageCute, APIError]:
         """Shortcut `API.send_voice()`, see the [documentation](https://core.telegram.org/bots/api#sendvoice)
 
-        Use this method to send audio files, if you want Telegram clients to display 
-        the file as a playable voice message. For this to work, your audio must be 
-        in an .OGG file encoded with OPUS (other formats may be sent as Audio or Document). 
-        On success, the sent Message is returned. Bots can currently send voice 
+        Use this method to send audio files, if you want Telegram clients to display
+        the file as a playable voice message. For this to work, your audio must be
+        in an .OGG file encoded with OPUS (other formats may be sent as Audio or Document).
+        On success, the sent Message is returned. Bots can currently send voice
         messages of up to 50 MB in size, this limit may be changed in the future.
 
         :param business_connection_id: Unique identifier of the business connection on behalf of which the message \
@@ -1158,6 +1196,9 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for \
         forum supergroups only.
 
+        :param message_effect_id: Unique identifier of the message effect to be added to the message; for private \
+        chats only.
+
         :param voice: Audio file to send. Pass a file_id as String to send a file that exists on the \
         Telegram servers (recommended), pass an HTTP URL as a String for Telegram \
         to get a file from the Internet, or upload a new one using multipart/form-data. \
@@ -1188,7 +1229,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     @shortcut(
         "send_poll",
         executor=execute_method_answer,
-        custom_params={"reply_parameters", "message_thread_id"},
+        custom_params={"reply_parameters", "message_thread_id", "chat_id"},
     )
     async def answer_poll(
         self,
@@ -1197,11 +1238,13 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         chat_id: int | str | None = None,
         business_connection_id: str | None = None,
         message_thread_id: int | None = None,
+        message_effect_id: str | None = None,
         question_parse_mode: str | None = None,
         question_entities: list[MessageEntity] | None = None,
         is_anonymous: bool | None = None,
         type: typing.Literal["quiz", "regular"] | None = None,
         allows_multiple_answers: bool | None = None,
+        show_caption_above_media: bool | None = None,
         correct_option_id: int | None = None,
         explanation: str | None = None,
         explanation_parse_mode: str | None = None,
@@ -1228,6 +1271,9 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for \
         forum supergroups only.
 
+        :param message_effect_id: Unique identifier of the message effect to be added to the message; for private \
+        chats only.
+
         :param question_parse_mode: Mode for parsing entities in the question. See formatting options for more \
         details. Currently, only custom emoji entities are allowed.
 
@@ -1270,6 +1316,8 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
 
         :param disable_notification: Sends the message silently. Users will receive a notification with no sound. \
 
+        :param show_caption_above_media: Pass True, if the caption must be shown above the message media.
+
         :param protect_content: Protects the contents of the sent message from forwarding and saving.
 
         :param reply_parameters: Description of the message to reply to.
@@ -1283,7 +1331,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     @shortcut(
         "send_venue",
         executor=execute_method_answer,
-        custom_params={"reply_parameters", "message_thread_id"},
+        custom_params={"reply_parameters", "message_thread_id", "chat_id"},
     )
     async def answer_venue(
         self,
@@ -1294,6 +1342,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         chat_id: int | str | None = None,
         business_connection_id: str | None = None,
         message_thread_id: int | None = None,
+        message_effect_id: str | None = None,
         foursquare_id: str | None = None,
         foursquare_type: str | None = None,
         google_place_id: str | None = None,
@@ -1306,7 +1355,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     ) -> Result[MessageCute, APIError]:
         """Shortcut `API.send_venue()`, see the [documentation](https://core.telegram.org/bots/api#sendvenue)
 
-        Use this method to send information about a venue. On success, the sent Message 
+        Use this method to send information about a venue. On success, the sent Message
         is returned.
 
         :param business_connection_id: Unique identifier of the business connection on behalf of which the message \
@@ -1318,6 +1367,9 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for \
         forum supergroups only.
 
+        :param message_effect_id: Unique identifier of the message effect to be added to the message; for private \
+        chats only.
+
         :param latitude: Latitude of the venue.
 
         :param longitude: Longitude of the venue.
@@ -1350,7 +1402,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     @shortcut(
         "send_dice",
         executor=execute_method_answer,
-        custom_params={"reply_parameters", "message_thread_id"},
+        custom_params={"reply_parameters", "message_thread_id", "chat_id"},
     )
     async def answer_dice(
         self,
@@ -1358,6 +1410,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         chat_id: int | str | None = None,
         business_connection_id: str | None = None,
         message_thread_id: int | None = None,
+        message_effect_id: str | None = None,
         disable_notification: bool | None = None,
         protect_content: bool | None = None,
         reply_parameters: ReplyParameters | dict[str, typing.Any] | None = None,
@@ -1366,7 +1419,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     ) -> Result[MessageCute, APIError]:
         """Shortcut `API.send_dice()`, see the [documentation](https://core.telegram.org/bots/api#senddice)
 
-        Use this method to send an animated emoji that will display a random value. 
+        Use this method to send an animated emoji that will display a random value.
         On success, the sent Message is returned.
 
         :param business_connection_id: Unique identifier of the business connection on behalf of which the message \
@@ -1378,6 +1431,9 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for \
         forum supergroups only.
 
+        :param message_effect_id: Unique identifier of the message effect to be added to the message; for private \
+        chats only.
+
         :param emoji: Emoji on which the dice throw animation is based. Currently, must be one \
         of `🎲`, `🎯`, `🏀`, `⚽`, `🎳`, or `🎰`. Dice can have values 1-6 for `🎲`, `🎯` and \
         `🎳`, values 1-5 for `🏀` and `⚽`, and values 1-64 for `🎰`. Defaults to `🎲`. \
@@ -1397,14 +1453,15 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     @shortcut(
         "send_game",
         executor=execute_method_answer,
-        custom_params={"reply_parameters", "message_thread_id"},
+        custom_params={"reply_parameters", "message_thread_id", "chat_id"},
     )
     async def answer_game(
         self,
+        game_short_name: str,
         chat_id: int | str | None = None,
         business_connection_id: str | None = None,
         message_thread_id: int | None = None,
-        game_short_name: str | None = None,
+        message_effect_id: str | None = None,
         disable_notification: bool | None = None,
         protect_content: bool | None = None,
         reply_parameters: ReplyParameters | dict[str, typing.Any] | None = None,
@@ -1423,6 +1480,9 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for \
         forum supergroups only.
 
+        :param message_effect_id: Unique identifier of the message effect to be added to the message; for private \
+        chats only.
+
         :param game_short_name: Short name of the game, serves as the unique identifier for the game. Set \
         up your games via @BotFather.
 
@@ -1440,19 +1500,20 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     @shortcut(
         "send_invoice",
         executor=execute_method_answer,
-        custom_params={"reply_parameters", "message_thread_id"},
+        custom_params={"reply_parameters", "message_thread_id", "chat_id"},
     )
     async def answer_invoice(
         self,
         title: str,
         description: str,
         payload: str,
-        provider_token: str,
         currency: str,
         prices: list[LabeledPrice],
         chat_id: int | str | None = None,
         business_connection_id: str | None = None,
+        provider_token: str | None = None,
         message_thread_id: int | None = None,
+        message_effect_id: str | None = None,
         max_tip_amount: int | None = None,
         suggested_tip_amounts: list[int] | None = None,
         start_parameter: str | None = None,
@@ -1487,6 +1548,9 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for \
         forum supergroups only.
 
+        :param message_effect_id: Unique identifier of the message effect to be added to the message; for private \
+        chats only.
+
         :param title: Product name, 1-32 characters.
 
         :param description: Product description, 1-255 characters.
@@ -1560,7 +1624,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     @shortcut(
         "send_chat_action",
         executor=execute_method_answer,
-        custom_params={"reply_parameters", "message_thread_id"},
+        custom_params={"reply_parameters", "message_thread_id", "chat_id"},
     )
     async def answer_chat_action(
         self,
@@ -1572,10 +1636,10 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     ) -> Result[bool, APIError]:
         """Shortcut `API.send_chat_action()`, see the [documentation](https://core.telegram.org/bots/api#sendchataction)
 
-        Use this method when you need to tell the user that something is happening 
-        on the bot's side. The status is set for 5 seconds or less (when a message arrives 
-        from your bot, Telegram clients clear its typing status). Returns True 
-        on success. We only recommend using this method when a response from the 
+        Use this method when you need to tell the user that something is happening
+        on the bot's side. The status is set for 5 seconds or less (when a message arrives
+        from your bot, Telegram clients clear its typing status). Returns True
+        on success. We only recommend using this method when a response from the
         bot will take a noticeable amount of time to arrive.
 
         :param business_connection_id: Unique identifier of the business connection on behalf of which the message \
@@ -1605,6 +1669,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         chat_id: int | str | None = None,
         business_connection_id: str | None = None,
         message_thread_id: int | None = None,
+        message_effect_id: str | None = None,
         caption: str | None = None,
         parse_mode: str | None = None,
         caption_entities: list[MessageEntity] | None = None,
@@ -1615,8 +1680,8 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     ) -> Result[list[MessageCute], APIError]:
         """Shortcut `API.send_media_group()`, see the [documentation](https://core.telegram.org/bots/api#sendmediagroup)
 
-        Use this method to send a group of photos, videos, documents or audios as 
-        an album. Documents and audio files can be only grouped in an album with messages 
+        Use this method to send a group of photos, videos, documents or audios as
+        an album. Documents and audio files can be only grouped in an album with messages
         of the same type. On success, an array of Messages that were sent is returned.
 
         :param business_connection_id: Unique identifier of the business connection on behalf of which the message \
@@ -1628,6 +1693,9 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for \
         forum supergroups only.
 
+        :param message_effect_id: Unique identifier of the message effect to be added to the message; for private \
+        chats only.
+
         :param media: A JSON-serialized array describing messages to be sent, must include 2-10 \
         items.
 
@@ -1664,7 +1732,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     @shortcut(
         "send_location",
         executor=execute_method_answer,
-        custom_params={"reply_parameters", "message_thread_id"},
+        custom_params={"reply_parameters", "message_thread_id", "chat_id"},
     )
     async def answer_location(
         self,
@@ -1673,6 +1741,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         chat_id: int | str | None = None,
         message_thread_id: int | None = None,
         business_connection_id: str | None = None,
+        message_effect_id: str | None = None,
         horizontal_accuracy: float | None = None,
         heading: int | None = None,
         live_period: int | None = None,
@@ -1696,6 +1765,9 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for \
         forum supergroups only.
 
+        :param message_effect_id: Unique identifier of the message effect to be added to the message; for private \
+        chats only.
+
         :param latitude: Latitude of the location.
 
         :param longitude: Longitude of the location.
@@ -1726,7 +1798,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     @shortcut(
         "send_contact",
         executor=execute_method_answer,
-        custom_params={"reply_parameters", "message_thread_id"},
+        custom_params={"reply_parameters", "message_thread_id", "chat_id"},
     )
     async def answer_contact(
         self,
@@ -1737,6 +1809,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         chat_id: int | str | None = None,
         business_connection_id: str | None = None,
         message_thread_id: int | None = None,
+        message_effect_id: str | None = None,
         disable_notification: bool | None = None,
         protect_content: bool | None = None,
         reply_parameters: ReplyParameters | dict[str, typing.Any] | None = None,
@@ -1756,6 +1829,9 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for \
         forum supergroups only.
 
+        :param message_effect_id: Unique identifier of the message effect to be added to the message; for private \
+        chats only.
+
         :param phone_number: Contact's phone number.
 
         :param first_name: Contact's first name.
@@ -1779,14 +1855,15 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     @shortcut(
         "send_audio",
         executor=execute_method_reply,
-        custom_params={"reply_parameters", "message_thread_id"},
+        custom_params={"reply_parameters", "message_thread_id", "chat_id"},
     )
     async def reply_audio(
         self,
         audio: InputFile | str,
         chat_id: int | str | None = None,
-        business_connection_id: str | None = None,
         message_thread_id: int | None = None,
+        business_connection_id: str | None = None,
+        message_effect_id: str | None = None,
         caption: str | None = None,
         parse_mode: str | None = None,
         caption_entities: list[MessageEntity] | None = None,
@@ -1802,10 +1879,10 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     ) -> Result[MessageCute, APIError]:
         """Shortcut `API.send_audio()`, see the [documentation](https://core.telegram.org/bots/api#sendaudio)
 
-        Use this method to send a reply to a message with audio files, if you want Telegram clients to display 
-        them in the music player. Your audio must be in the .MP3 or .M4A format. On 
-        success, the sent Message is returned. Bots can currently send audio files 
-        of up to 50 MB in size, this limit may be changed in the future. For sending 
+        Use this method to send a reply to a message with audio files, if you want Telegram clients to display
+        them in the music player. Your audio must be in the .MP3 or .M4A format. On
+        success, the sent Message is returned. Bots can currently send audio files
+        of up to 50 MB in size, this limit may be changed in the future. For sending
         voice messages, use the sendVoice method instead.
 
         :param business_connection_id: Unique identifier of the business connection on behalf of which the message \
@@ -1817,6 +1894,9 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for \
         forum supergroups only.
 
+        :param message_effect_id: Unique identifier of the message effect to be added to the message; for private \
+        chats only.
+
         :param audio: Audio file to send. Pass a file_id as String to send an audio file that exists \
         on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram \
         to get an audio file from the Internet, or upload a new one using multipart/form-data. \
@@ -1859,17 +1939,19 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     @shortcut(
         "send_animation",
         executor=execute_method_reply,
-        custom_params={"reply_parameters", "message_thread_id"},
+        custom_params={"reply_parameters", "message_thread_id", "chat_id"},
     )
     async def reply_animation(
         self,
         animation: InputFile | str,
         chat_id: int | str | None = None,
-        business_connection_id: str | None = None,
         message_thread_id: int | None = None,
+        business_connection_id: str | None = None,
+        message_effect_id: str | None = None,
         caption: str | None = None,
         parse_mode: str | None = None,
         caption_entities: list[MessageEntity] | None = None,
+        show_caption_above_media: bool | None = None,
         duration: int | None = None,
         width: int | None = None,
         height: int | None = None,
@@ -1883,8 +1965,8 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     ) -> Result[MessageCute, APIError]:
         """Shortcut `API.send_animation()`, see the [documentation](https://core.telegram.org/bots/api#sendanimation)
 
-        Use this method to send a reply to a message with animation files (GIF or H.264/MPEG-4 AVC video without 
-        sound). On success, the sent Message is returned. Bots can currently send 
+        Use this method to send a reply to a message with animation files (GIF or H.264/MPEG-4 AVC video without
+        sound). On success, the sent Message is returned. Bots can currently send
         animation files of up to 50 MB in size, this limit may be changed in the future.
 
         :param business_connection_id: Unique identifier of the business connection on behalf of which the message \
@@ -1896,6 +1978,9 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for \
         forum supergroups only.
 
+        :param message_effect_id: Unique identifier of the message effect to be added to the message; for private \
+        chats only.
+
         :param animation: Animation to send. Pass a file_id as String to send an animation that exists \
         on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram \
         to get an animation from the Internet, or upload a new animation using multipart/form-data. \
@@ -1928,6 +2013,8 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
 
         :param disable_notification: Sends the message silently. Users will receive a notification with no sound. \
 
+        :param show_caption_above_media: Pass True, if the caption must be shown above the message media.
+
         :param protect_content: Protects the contents of the sent message from forwarding and saving.
 
         :param reply_parameters: Description of the message to reply to.
@@ -1941,18 +2028,20 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     @shortcut(
         "send_document",
         executor=execute_method_reply,
-        custom_params={"reply_parameters", "message_thread_id"},
+        custom_params={"reply_parameters", "message_thread_id", "chat_id"},
     )
     async def reply_document(
         self,
         document: InputFile | str,
         chat_id: int | str | None = None,
-        business_connection_id: str | None = None,
         message_thread_id: int | None = None,
+        business_connection_id: str | None = None,
+        message_effect_id: str | None = None,
         caption: str | None = None,
         parse_mode: str | None = None,
         caption_entities: list[MessageEntity] | None = None,
         disable_content_type_detection: bool | None = None,
+        show_caption_above_media: bool | None = None,
         thumbnail: InputFile | str | None = None,
         disable_notification: bool | None = None,
         protect_content: bool | None = None,
@@ -1962,8 +2051,8 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     ) -> Result[MessageCute, APIError]:
         """Shortcut `API.send_document()`, see the [documentation](https://core.telegram.org/bots/api#senddocument)
 
-        Use this method to send a reply to a message with general files. On success, the sent Message is returned. 
-        Bots can currently send files of any type of up to 50 MB in size, this limit 
+        Use this method to send a reply to a message with general files. On success, the sent Message is returned.
+        Bots can currently send files of any type of up to 50 MB in size, this limit
         may be changed in the future.
 
         :param business_connection_id: Unique identifier of the business connection on behalf of which the message \
@@ -1975,6 +2064,9 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for \
         forum supergroups only.
 
+        :param message_effect_id: Unique identifier of the message effect to be added to the message; for private \
+        chats only.
+
         :param document: File to send. Pass a file_id as String to send a file that exists on the Telegram \
         servers (recommended), pass an HTTP URL as a String for Telegram to get a \
         file from the Internet, or upload a new one using multipart/form-data. \
@@ -2002,6 +2094,8 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
 
         :param disable_notification: Sends the message silently. Users will receive a notification with no sound. \
 
+        :param show_caption_above_media: Pass True, if the caption must be shown above the message media.
+
         :param protect_content: Protects the contents of the sent message from forwarding and saving.
 
         :param reply_parameters: Description of the message to reply to.
@@ -2015,17 +2109,19 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     @shortcut(
         "send_photo",
         executor=execute_method_reply,
-        custom_params={"reply_parameters", "message_thread_id"},
+        custom_params={"reply_parameters", "message_thread_id", "chat_id"},
     )
     async def reply_photo(
         self,
         photo: InputFile | str,
         chat_id: int | str | None = None,
-        business_connection_id: str | None = None,
         message_thread_id: int | None = None,
+        business_connection_id: str | None = None,
+        message_effect_id: str | None = None,
         caption: str | None = None,
         parse_mode: str | None = None,
         caption_entities: list[MessageEntity] | None = None,
+        show_caption_above_media: bool | None = None,
         has_spoiler: bool | None = None,
         disable_notification: bool | None = None,
         protect_content: bool | None = None,
@@ -2046,6 +2142,9 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for \
         forum supergroups only.
 
+        :param message_effect_id: Unique identifier of the message effect to be added to the message; for private \
+        chats only.
+
         :param photo: Photo to send. Pass a file_id as String to send a photo that exists on the Telegram \
         servers (recommended), pass an HTTP URL as a String for Telegram to get a \
         photo from the Internet, or upload a new photo using multipart/form-data. \
@@ -2066,6 +2165,8 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
 
         :param disable_notification: Sends the message silently. Users will receive a notification with no sound. \
 
+        :param show_caption_above_media: Pass True, if the caption must be shown above the message media.
+
         :param protect_content: Protects the contents of the sent message from forwarding and saving.
 
         :param reply_parameters: Description of the message to reply to.
@@ -2079,15 +2180,16 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     @shortcut(
         "send_sticker",
         executor=execute_method_reply,
-        custom_params={"reply_parameters", "message_thread_id"},
+        custom_params={"reply_parameters", "message_thread_id", "chat_id"},
     )
     async def reply_sticker(
         self,
         sticker: InputFile | str,
         chat_id: int | str | None = None,
-        business_connection_id: str | None = None,
         emoji: str | None = None,
         message_thread_id: int | None = None,
+        message_effect_id: str | None = None,
+        business_connection_id: str | None = None,
         disable_notification: bool | None = None,
         protect_content: bool | None = None,
         reply_parameters: ReplyParameters | dict[str, typing.Any] | None = None,
@@ -2096,7 +2198,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     ) -> Result[MessageCute, APIError]:
         """Shortcut `API.send_sticker()`, see the [documentation](https://core.telegram.org/bots/api#sendsticker)
 
-        Use this method to send a reply to a message with static .WEBP, animated .TGS, or video .WEBM stickers. 
+        Use this method to send a reply to a message with static .WEBP, animated .TGS, or video .WEBM stickers.
         On success, the sent Message is returned.
 
         :param business_connection_id: Unique identifier of the business connection on behalf of which the message \
@@ -2108,6 +2210,9 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for \
         forum supergroups only.
 
+        :param message_effect_id: Unique identifier of the message effect to be added to the message; for private \
+        chats only.
+
         :param sticker: Sticker to send. Pass a file_id as String to send a file that exists on the \
         Telegram servers (recommended), pass an HTTP URL as a String for Telegram \
         to get a .WEBP sticker from the Internet, or upload a new .WEBP or .TGS sticker \
@@ -2132,23 +2237,16 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     @shortcut(
         "send_video",
         executor=execute_method_reply,
-        custom_params={"reply_parameters", "message_thread_id"},
+        custom_params={"reply_parameters", "message_thread_id", "chat_id"},
     )
     async def reply_video(
         self,
-        video: InputFile | str,
+        sticker: InputFile | str,
         chat_id: int | str | None = None,
-        business_connection_id: str | None = None,
+        emoji: str | None = None,
         message_thread_id: int | None = None,
-        caption: str | None = None,
-        parse_mode: str | None = None,
-        caption_entities: list[MessageEntity] | None = None,
-        duration: int | None = None,
-        width: int | None = None,
-        height: int | None = None,
-        thumbnail: InputFile | str | None = None,
-        has_spoiler: bool | None = None,
-        supports_streaming: bool | None = None,
+        message_effect_id: str | None = None,
+        business_connection_id: str | None = None,
         disable_notification: bool | None = None,
         protect_content: bool | None = None,
         reply_parameters: ReplyParameters | dict[str, typing.Any] | None = None,
@@ -2157,9 +2255,9 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     ) -> Result[MessageCute, APIError]:
         """Shortcut `API.send_video()`, see the [documentation](https://core.telegram.org/bots/api#sendvideo)
 
-        Use this method to send a reply to a message with video files, Telegram clients support MPEG4 videos 
-        (other formats may be sent as Document). On success, the sent Message is 
-        returned. Bots can currently send video files of up to 50 MB in size, this 
+        Use this method to send a reply to a message with video files, Telegram clients support MPEG4 videos
+        (other formats may be sent as Document). On success, the sent Message is
+        returned. Bots can currently send video files of up to 50 MB in size, this
         limit may be changed in the future.
 
         :param business_connection_id: Unique identifier of the business connection on behalf of which the message \
@@ -2171,6 +2269,9 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for \
         forum supergroups only.
 
+        :param message_effect_id: Unique identifier of the message effect to be added to the message; for private \
+        chats only.
+
         :param video: Video to send. Pass a file_id as String to send a video that exists on the Telegram \
         servers (recommended), pass an HTTP URL as a String for Telegram to get a \
         video from the Internet, or upload a new video using multipart/form-data. \
@@ -2218,15 +2319,16 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     @shortcut(
         "send_video_note",
         executor=execute_method_reply,
-        custom_params={"reply_parameters", "message_thread_id"},
+        custom_params={"reply_parameters", "message_thread_id", "chat_id"},
     )
     async def reply_video_note(
         self,
         video_note: InputFile | str,
         chat_id: int | str | None = None,
+        business_connection_id: str | None = None,
+        message_effect_id: str | None = None,
         duration: int | None = None,
         length: int | None = None,
-        business_connection_id: str | None = None,
         message_thread_id: int | None = None,
         thumbnail: InputFile | str | None = None,
         disable_notification: bool | None = None,
@@ -2237,8 +2339,8 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     ) -> Result[MessageCute, APIError]:
         """Shortcut `API.send_video_note()`, see the [documentation](https://core.telegram.org/bots/api#sendvideonote)
 
-        As of v.4.0, Telegram clients support rounded square MPEG4 videos of up 
-        to 1 minute long. Use this method to send a reply to a message with video messages. On success, the 
+        As of v.4.0, Telegram clients support rounded square MPEG4 videos of up
+        to 1 minute long. Use this method to send a reply to a message with video messages. On success, the
         sent Message is returned.
 
         :param business_connection_id: Unique identifier of the business connection on behalf of which the message \
@@ -2250,6 +2352,9 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for \
         forum supergroups only.
 
+        :param message_effect_id: Unique identifier of the message effect to be added to the message; for private \
+        chats only.
+
         :param video_note: Video note to send. Pass a file_id as String to send a video note that exists \
         on the Telegram servers (recommended) or upload a new video using multipart/form-data. \
         More information on Sending Files: https://core.telegram.org/bots/api#sending-files. \
@@ -2282,14 +2387,15 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     @shortcut(
         "send_voice",
         executor=execute_method_reply,
-        custom_params={"reply_parameters", "message_thread_id"},
+        custom_params={"reply_parameters", "message_thread_id", "chat_id"},
     )
     async def reply_voice(
         self,
         voice: InputFile | str,
         chat_id: int | str | None = None,
-        business_connection_id: str | None = None,
         message_thread_id: int | None = None,
+        business_connection_id: str | None = None,
+        message_effect_id: str | None = None,
         caption: str | None = None,
         parse_mode: str | None = None,
         caption_entities: list[MessageEntity] | None = None,
@@ -2302,10 +2408,10 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     ) -> Result[MessageCute, APIError]:
         """Shortcut `API.send_voice()`, see the [documentation](https://core.telegram.org/bots/api#sendvoice)
 
-        Use this method to send a reply to a message with audio files, if you want Telegram clients to display 
-        the file as a playable voice message. For this to work, your audio must be 
-        in an .OGG file encoded with OPUS (other formats may be sent as Audio or Document). 
-        On success, the sent Message is returned. Bots can currently send voice 
+        Use this method to send a reply to a message with audio files, if you want Telegram clients to display
+        the file as a playable voice message. For this to work, your audio must be
+        in an .OGG file encoded with OPUS (other formats may be sent as Audio or Document).
+        On success, the sent Message is returned. Bots can currently send voice
         messages of up to 50 MB in size, this limit may be changed in the future.
 
         :param business_connection_id: Unique identifier of the business connection on behalf of which the message \
@@ -2317,6 +2423,9 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for \
         forum supergroups only.
 
+        :param message_effect_id: Unique identifier of the message effect to be added to the message; for private \
+        chats only.
+
         :param voice: Audio file to send. Pass a file_id as String to send a file that exists on the \
         Telegram servers (recommended), pass an HTTP URL as a String for Telegram \
         to get a file from the Internet, or upload a new one using multipart/form-data. \
@@ -2347,7 +2456,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     @shortcut(
         "send_poll",
         executor=execute_method_reply,
-        custom_params={"reply_parameters", "message_thread_id"},
+        custom_params={"reply_parameters", "message_thread_id", "chat_id"},
     )
     async def reply_poll(
         self,
@@ -2356,11 +2465,13 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         chat_id: int | str | None = None,
         business_connection_id: str | None = None,
         message_thread_id: int | None = None,
+        message_effect_id: str | None = None,
         question_parse_mode: str | None = None,
         question_entities: list[MessageEntity] | None = None,
         is_anonymous: bool | None = None,
         type: typing.Literal["quiz", "regular"] | None = None,
         allows_multiple_answers: bool | None = None,
+        show_caption_above_media: bool | None = None,
         correct_option_id: int | None = None,
         explanation: str | None = None,
         explanation_parse_mode: str | None = None,
@@ -2387,6 +2498,9 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for \
         forum supergroups only.
 
+        :param message_effect_id: Unique identifier of the message effect to be added to the message; for private \
+        chats only.
+
         :param question_parse_mode: Mode for parsing entities in the question. See formatting options for more \
         details. Currently, only custom emoji entities are allowed.
 
@@ -2429,6 +2543,8 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
 
         :param disable_notification: Sends the message silently. Users will receive a notification with no sound. \
 
+        :param show_caption_above_media: Pass True, if the caption must be shown above the message media.
+
         :param protect_content: Protects the contents of the sent message from forwarding and saving.
 
         :param reply_parameters: Description of the message to reply to.
@@ -2442,7 +2558,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     @shortcut(
         "send_venue",
         executor=execute_method_reply,
-        custom_params={"reply_parameters", "message_thread_id"},
+        custom_params={"reply_parameters", "message_thread_id", "chat_id"},
     )
     async def reply_venue(
         self,
@@ -2453,6 +2569,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         chat_id: int | str | None = None,
         business_connection_id: str | None = None,
         message_thread_id: int | None = None,
+        message_effect_id: str | None = None,
         foursquare_id: str | None = None,
         foursquare_type: str | None = None,
         google_place_id: str | None = None,
@@ -2465,7 +2582,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     ) -> Result[MessageCute, APIError]:
         """Shortcut `API.send_venue()`, see the [documentation](https://core.telegram.org/bots/api#sendvenue)
 
-        Use this method to send a reply to a message with information about a venue. On success, the sent Message 
+        Use this method to send a reply to a message with information about a venue. On success, the sent Message
         is returned.
 
         :param business_connection_id: Unique identifier of the business connection on behalf of which the message \
@@ -2477,6 +2594,9 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for \
         forum supergroups only.
 
+        :param message_effect_id: Unique identifier of the message effect to be added to the message; for private \
+        chats only.
+
         :param latitude: Latitude of the venue.
 
         :param longitude: Longitude of the venue.
@@ -2509,14 +2629,15 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     @shortcut(
         "send_dice",
         executor=execute_method_reply,
-        custom_params={"reply_parameters", "message_thread_id"},
+        custom_params={"reply_parameters", "message_thread_id", "chat_id"},
     )
     async def reply_dice(
         self,
+        emoji: DiceEmoji | None = None,
         chat_id: int | str | None = None,
         business_connection_id: str | None = None,
         message_thread_id: int | None = None,
-        emoji: DiceEmoji | None = None,
+        message_effect_id: str | None = None,
         disable_notification: bool | None = None,
         protect_content: bool | None = None,
         reply_parameters: ReplyParameters | dict[str, typing.Any] | None = None,
@@ -2525,7 +2646,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     ) -> Result[MessageCute, APIError]:
         """Shortcut `API.send_dice()`, see the [documentation](https://core.telegram.org/bots/api#senddice)
 
-        Use this method to send a reply to a message with an animated emoji that will display a random value. 
+        Use this method to send a reply to a message with an animated emoji that will display a random value.
         On success, the sent Message is returned.
 
         :param business_connection_id: Unique identifier of the business connection on behalf of which the message \
@@ -2537,6 +2658,9 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for \
         forum supergroups only.
 
+        :param message_effect_id: Unique identifier of the message effect to be added to the message; for private \
+        chats only.
+
         :param emoji: Emoji on which the dice throw animation is based. Currently, must be one \
         of `🎲`, `🎯`, `🏀`, `⚽`, `🎳`, or `🎰`. Dice can have values 1-6 for `🎲`, `🎯` and \
         `🎳`, values 1-5 for `🏀` and `⚽`, and values 1-64 for `🎰`. Defaults to `🎲`. \
@@ -2556,14 +2680,15 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     @shortcut(
         "send_game",
         executor=execute_method_reply,
-        custom_params={"reply_parameters", "message_thread_id"},
+        custom_params={"reply_parameters", "message_thread_id", "chat_id"},
     )
     async def reply_game(
         self,
+        game_short_name: str,
         chat_id: int | str | None = None,
         business_connection_id: str | None = None,
         message_thread_id: int | None = None,
-        game_short_name: str | None = None,
+        message_effect_id: str | None = None,
         disable_notification: bool | None = None,
         protect_content: bool | None = None,
         reply_parameters: ReplyParameters | dict[str, typing.Any] | None = None,
@@ -2582,6 +2707,9 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for \
         forum supergroups only.
 
+        :param message_effect_id: Unique identifier of the message effect to be added to the message; for private \
+        chats only.
+
         :param game_short_name: Short name of the game, serves as the unique identifier for the game. Set \
         up your games via @BotFather.
 
@@ -2599,19 +2727,20 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     @shortcut(
         "send_invoice",
         executor=execute_method_reply,
-        custom_params={"reply_parameters", "message_thread_id"},
+        custom_params={"reply_parameters", "message_thread_id", "chat_id"},
     )
     async def reply_invoice(
         self,
         title: str,
         description: str,
         payload: str,
-        provider_token: str,
         currency: str,
         prices: list[LabeledPrice],
         chat_id: int | str | None = None,
         business_connection_id: str | None = None,
         message_thread_id: int | None = None,
+        provider_token: str | None = None,
+        message_effect_id: str | None = None,
         max_tip_amount: int | None = None,
         suggested_tip_amounts: list[int] | None = None,
         start_parameter: str | None = None,
@@ -2646,6 +2775,9 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for \
         forum supergroups only.
 
+        :param message_effect_id: Unique identifier of the message effect to be added to the message; for private \
+        chats only.
+
         :param title: Product name, 1-32 characters.
 
         :param description: Product description, 1-255 characters.
@@ -2721,6 +2853,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         custom_params={
             "media",
             "reply_parameters",
+            "chat_id",
             "message_thread_id",
             "caption",
             "caption_entities",
@@ -2733,6 +2866,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         chat_id: int | str | None = None,
         business_connection_id: str | None = None,
         message_thread_id: int | None = None,
+        message_effect_id: str | None = None,
         caption: str | None = None,
         parse_mode: str | None = None,
         caption_entities: list[MessageEntity] | None = None,
@@ -2743,8 +2877,8 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     ) -> Result[list[MessageCute], APIError]:
         """Shortcut `API.send_media_group()`, see the [documentation](https://core.telegram.org/bots/api#sendmediagroup)
 
-        Use this method to send a reply to a message with a group of photos, videos, documents or audios as 
-        an album. Documents and audio files can be only grouped in an album with messages 
+        Use this method to send a reply to a message with a group of photos, videos, documents or audios as
+        an album. Documents and audio files can be only grouped in an album with messages
         of the same type. On success, an array of Messages that were sent is returned.
 
         :param business_connection_id: Unique identifier of the business connection on behalf of which the message \
@@ -2756,6 +2890,9 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for \
         forum supergroups only.
 
+        :param message_effect_id: Unique identifier of the message effect to be added to the message; for private \
+        chats only.
+
         :param media: A JSON-serialized array describing messages to be sent, must include 2-10 \
         items.
 
@@ -2780,15 +2917,16 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     @shortcut(
         "send_location",
         executor=execute_method_reply,
-        custom_params={"reply_parameters", "message_thread_id"},
+        custom_params={"reply_parameters", "message_thread_id", "chat_id"},
     )
     async def reply_location(
         self,
         latitude: float,
         longitude: float,
         chat_id: int | str | None = None,
-        business_connection_id: str | None = None,
         message_thread_id: int | None = None,
+        business_connection_id: str | None = None,
+        message_effect_id: str | None = None,
         horizontal_accuracy: float | None = None,
         heading: int | None = None,
         live_period: int | None = None,
@@ -2812,6 +2950,9 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for \
         forum supergroups only.
 
+        :param message_effect_id: Unique identifier of the message effect to be added to the message; for private \
+        chats only.
+
         :param latitude: Latitude of the location.
 
         :param longitude: Longitude of the location.
@@ -2842,7 +2983,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     @shortcut(
         "send_contact",
         executor=execute_method_reply,
-        custom_params={"reply_parameters", "message_thread_id"},
+        custom_params={"reply_parameters", "message_thread_id", "chat_id"},
     )
     async def reply_contact(
         self,
@@ -2853,6 +2994,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         chat_id: int | str | None = None,
         business_connection_id: str | None = None,
         message_thread_id: int | None = None,
+        message_effect_id: str | None = None,
         disable_notification: bool | None = None,
         protect_content: bool | None = None,
         reply_parameters: ReplyParameters | dict[str, typing.Any] | None = None,
@@ -2872,6 +3014,9 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for \
         forum supergroups only.
 
+        :param message_effect_id: Unique identifier of the message effect to be added to the message; for private \
+        chats only.
+
         :param phone_number: Contact's phone number.
 
         :param first_name: Contact's first name.
@@ -2895,7 +3040,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     @shortcut(
         "edit_message_live_location",
         executor=execute_method_edit,
-        custom_params={"message_thread_id"},
+        custom_params={"message_thread_id", "chat_id", "message_id"},
     )
     async def edit_live_location(
         self,
@@ -2914,9 +3059,9 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     ) -> Result[Variative[MessageCute, bool], APIError]:
         """Shortcut `API.edit_message_live_location()`, see the [documentation](https://core.telegram.org/bots/api#editmessagelivelocation)
 
-        Use this method to edit live location messages. A location can be edited 
-        until its live_period expires or editing is explicitly disabled by a call 
-        to stopMessageLiveLocation. On success, if the edited message is not an 
+        Use this method to edit live location messages. A location can be edited
+        until its live_period expires or editing is explicitly disabled by a call
+        to stopMessageLiveLocation. On success, if the edited message is not an
         inline message, the edited Message is returned, otherwise True is returned.
 
         :param chat_id: Required if inline_message_id is not specified. Unique identifier for \
@@ -2957,7 +3102,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     @shortcut(
         "edit_message_caption",
         executor=execute_method_edit,
-        custom_params={"message_thread_id"},
+        custom_params={"message_thread_id", "chat_id", "message_id"},
     )
     async def edit_caption(
         self,
@@ -2967,13 +3112,14 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         message_thread_id: int | None = None,
         parse_mode: str | None = None,
         caption_entities: list[MessageEntity] | None = None,
+        show_caption_above_media: bool | None = None,
         reply_markup: InlineKeyboardMarkup | None = None,
         **other: typing.Any,
     ) -> Result[Variative[MessageCute, bool], APIError]:
         """Shortcut `API.edit_message_caption()`, see the [documentation](https://core.telegram.org/bots/api#editmessagecaption)
 
-        Use this method to edit captions of messages. On success, if the edited message 
-        is not an inline message, the edited Message is returned, otherwise True 
+        Use this method to edit captions of messages. On success, if the edited message
+        is not an inline message, the edited Message is returned, otherwise True
         is returned.
 
         :param chat_id: Required if inline_message_id is not specified. Unique identifier for \
@@ -2993,6 +3139,8 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         :param caption_entities: A JSON-serialized list of special entities that appear in the caption, \
         which can be specified instead of parse_mode.
 
+        :param show_caption_above_media: Pass True, if the caption must be shown above the message media.
+
         :param reply_markup: A JSON-serialized object for an inline keyboard."""
 
         ...
@@ -3004,6 +3152,8 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
             "type",
             "message_thread_id",
             "caption",
+            "chat_id",
+            "message_id",
             "parse_mode",
             "caption_entities",
         },
@@ -3023,12 +3173,12 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     ) -> Result[Variative[MessageCute, bool], APIError]:
         """Shortcut `API.edit_message_media()`, see the [documentation](https://core.telegram.org/bots/api#editmessagemedia)
 
-        Use this method to edit animation, audio, document, photo, or video messages. 
-        If a message is part of a message album, then it can be edited only to an audio 
-        for audio albums, only to a document for document albums and to a photo or 
-        a video otherwise. When an inline message is edited, a new file can't be uploaded; 
-        use a previously uploaded file via its file_id or specify a URL. On success, 
-        if the edited message is not an inline message, the edited Message is returned, 
+        Use this method to edit animation, audio, document, photo, or video messages.
+        If a message is part of a message album, then it can be edited only to an audio
+        for audio albums, only to a document for document albums and to a photo or
+        a video otherwise. When an inline message is edited, a new file can't be uploaded;
+        use a previously uploaded file via its file_id or specify a URL. On success,
+        if the edited message is not an inline message, the edited Message is returned,
         otherwise True is returned.
 
         :param chat_id: Required if inline_message_id is not specified. Unique identifier for \
@@ -3049,7 +3199,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
 
         :param caption_entities: A JSON-serialized list of special entities that appear in the caption, \
         which can be specified instead of parse_mode.
-        
+
         :param type: Required if media is not an `str | InputMedia` object. Type of the media, \
         must be one of `photo`, `video`, `animation`, `audio`, `document`.
 
@@ -3058,9 +3208,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
         params = get_params(locals())
 
         if not isinstance(media, InputMedia):
-            assert (
-                type
-            ), "parameter 'type' is required, because 'media' is not an 'InputMedia' object."
+            assert type, "parameter 'type' is required, because 'media' is not an 'InputMedia' object."
             params["media"] = input_media(
                 params.pop("type"),
                 media,
@@ -3074,7 +3222,7 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     @shortcut(
         "edit_message_reply_markup",
         executor=execute_method_edit,
-        custom_params={"message_thread_id"},
+        custom_params={"message_thread_id", "chat_id", "message_id"},
     )
     async def edit_reply_markup(
         self,
@@ -3086,8 +3234,8 @@ class MessageCute(BaseCute[Message], Message, kw_only=True):
     ) -> Result[Variative[MessageCute, bool], APIError]:
         """Shortcut `API.edit_message_reply_markup()`, see the [documentation](https://core.telegram.org/bots/api#editmessagereplymarkup)
 
-        Use this method to edit only the reply markup of messages. On success, if 
-        the edited message is not an inline message, the edited Message is returned, 
+        Use this method to edit only the reply markup of messages. On success, if
+        the edited message is not an inline message, the edited Message is returned,
         otherwise True is returned.
 
         :param chat_id: Required if inline_message_id is not specified. Unique identifier for \