Skip to content
5 changes: 5 additions & 0 deletions changes/22.8_2026-06-12/5262.ULa4t5ti2rRFyMWgpmVccq.toml
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
other = "Bump Version to 22.8"
[[pull_requests]]
uid = "5262"
author_uids = ["Poolitzer"]
closes_threads = []
5 changes: 5 additions & 0 deletions changes/22.8_2026-06-12/5262.nZcWnWfJyHhUwG484KJx9q.toml
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
other = "Bump Version to 22.8"
[[pull_requests]]
uid = "5262"
author_uids = ["Poolitzer"]
closes_threads = []
54 changes: 27 additions & 27 deletions src/telegram/_bot.py
Original file line number Diff line number Diff line change
Expand Up @@ -1247,7 +1247,7 @@ async def send_message_draft(
0-:tg-const:`telegram.constants.MessageLimit.MAX_TEXT_LENGTH` characters after
entities parsing. Pass an empty text to show a "Thinking..." placeholder.

.. versionchanged:: NEXT.VERSION
.. versionchanged:: 22.8
Bot API 10.0 now makes this an optional parameter.

message_thread_id (:obj:`int`, optional): Unique identifier for the target
Expand Down Expand Up @@ -5031,7 +5031,7 @@ async def get_chat_administrators(
that are administrators of the chat. By default, bots other than the current bot
are omitted.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.8

Returns:
tuple[:class:`telegram.ChatMember`]: On success, returns a tuple of ``ChatMember``
Expand Down Expand Up @@ -5721,7 +5721,7 @@ async def answer_guest_query(
) -> SentGuestMessage:
"""Use this method to reply to a received guest message.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.8

Args:
guest_query_id (:obj:`str`): Unique identifier for the query to be answered.
Expand Down Expand Up @@ -7376,7 +7376,7 @@ async def send_poll(
is_anonymous: bool | None = None,
type: str | None = None, # pylint: disable=redefined-builtin
allows_multiple_answers: bool | None = None,
# tags: deprecated in NEXT.VERSION, to be removed
# tags: deprecated in 22.8, to be removed
# replaced by `correct_option_ids`
correct_option_id: CorrectOptionID | None = None,
is_closed: bool | None = None,
Expand Down Expand Up @@ -7446,7 +7446,7 @@ async def send_poll(
correct_option_id (:obj:`int`, optional): 0-based identifier of the correct answer
option, required for polls in quiz mode.

.. deprecated:: NEXT.VERSION
.. deprecated:: 22.8
Bot API 9.6 replaces this with :paramref:`correct_option_ids` instead.

explanation (:obj:`str`, optional): Text that is shown when a user chooses an incorrect
Expand Down Expand Up @@ -7517,60 +7517,60 @@ async def send_poll(
change the chosen answer options, defaults to :obj:`False`
for quizzes and to :obj:`True` for regular polls

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.8
allow_adding_options (:obj:`bool`, optional): :obj:`True`, if answer options can be
added to the poll after creation; not supported for anonymous polls and quizzes

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.8
hide_results_until_closes (:obj:`bool`, optional): :obj:`True`, if poll results
must be shown only after the poll closes

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.8
correct_option_ids (Sequence[:class:`int`], optional): A list of monotonically
increasing 0-based identifiers of the correct answer options,
required for polls in quiz mode.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.8
description (:obj:`str`, optional): Description of the poll to be sent,
0-:tg-const:`telegram.Poll.MAX_DESCRIPTION_CHARACTERS` characters
after entities parsing.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.8
description_parse_mode (:obj:`str`, optional): Mode for parsing entities
in the poll description. See the constants
in :class:`telegram.constants.ParseMode`

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.8
description_entities (Sequence[:class:`telegram.MessageEntity`], optional): A
JSON-serialized list of special entities that appear in the poll description,
which can be specified instead of :paramref:`description_parse_mode`

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.8
shuffle_options (:obj:`bool`, optional): :obj:`True`, if the poll options must be
shown in random order

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.8
members_only (:obj:`bool`, optional): :obj:`True`, if voting is limited to users who
have been members of the chat where the poll is being sent for more than
:tg-const:`telegram.Poll.MIN_MEMBERSHIP_HOURS` hours; for channel chats only

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.8
country_codes (Sequence[:obj:`str`], optional): A list of
0-:tg-const:`telegram.constants.PollLimit.MAX_COUNTRY_CODES` two-letter
``ISO 3166-1 alpha-2`` country codes indicating the countries from which users can
vote in the poll; for channel chats only. Use ``"FT"`` as a country code to allow
users with anonymous numbers to vote. If omitted or empty, then users from any
country can participate in the poll.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.8
explanation_media (:class:`telegram.InputPollMedia`, optional): Media added to the quiz
explanation

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.8
media (:class:`telegram.InputPollMedia`, optional): Media added to the poll
description.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.8

Keyword Args:
allow_sending_without_reply (:obj:`bool`, optional): |allow_sending_without_reply|
Expand Down Expand Up @@ -7599,7 +7599,7 @@ async def send_poll(
if correct_option_id is not None:
warn(
PTBDeprecationWarning(
version="NEXT.VERSION",
version="22.8",
message="Bot API 9.6 deprecated `correct_option_id` in favour of "
"`correct_option_ids`, please use that.",
),
Expand Down Expand Up @@ -10728,7 +10728,7 @@ async def get_managed_bot_access_settings(
"""
Use this method to get the access settings of a managed bot.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.8

Args:
user_id (:obj:`int`): User identifier of the managed bot whose access settings will be
Expand Down Expand Up @@ -10770,7 +10770,7 @@ async def set_managed_bot_access_settings(
"""
Use this method to change the access settings of a managed bot.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.8

Args:
user_id (:obj:`int`): User identifier of the managed bot whose access settings will be
Expand Down Expand Up @@ -10817,7 +10817,7 @@ async def get_user_personal_chat_messages(
Use this method to get the last messages from the personal chat (i.e., the chat currently
added to their profile) of a given user.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.8

Args:
user_id (:obj:`int`): Unique identifier of the target user.
Expand Down Expand Up @@ -11833,7 +11833,7 @@ async def get_managed_bot_token(
"""
Use this method to get the token of a managed bot.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.8

Args:
user_id (:obj:`int`): User identifier of the managed bot whose token will be returned.
Expand Down Expand Up @@ -11868,7 +11868,7 @@ async def replace_managed_bot_token(
"""
Use this method to revoke the current token of a managed bot and generate a new one.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.8

Args:
user_id (:obj:`int`): User identifier of the managed bot whose token will be replaced.
Expand Down Expand Up @@ -11904,7 +11904,7 @@ async def save_prepared_keyboard_button(
"""
Stores a keyboard button that can be used by a user within a Mini App.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.8

Args:
user_id (:obj:`int`): Unique identifier of the target user that can use the button.
Expand Down Expand Up @@ -11970,7 +11970,7 @@ async def send_live_photo(

.. seealso:: :wiki:`Working with Files and Media <Working-with-Files-and-Media>`

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.8

Args:
chat_id (:obj:`int` | :obj:`str`): |chat_id_channel|
Expand Down Expand Up @@ -12085,7 +12085,7 @@ async def delete_message_reaction(
The bot must have the :attr:`~telegram.ChatMemberAdministrator.can_delete_messages`
administrator right in the chat.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.8

Args:
chat_id (:obj:`int` | :obj:`str`): |chat_id_group|
Expand Down Expand Up @@ -12132,7 +12132,7 @@ async def delete_all_message_reactions(
:attr:`~telegram.ChatMemberAdministrator.can_delete_messages` administrator right in the
chat.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.8

Args:
chat_id (:obj:`int` | :obj:`str`): |chat_id_group|
Expand Down
2 changes: 1 addition & 1 deletion src/telegram/_botaccesssettings.py
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ class BotAccessSettings(TelegramObject):
Objects of this class are comparable in terms of equality. Two objects of this class are
considered equal, if their :attr:`is_access_restricted` and :attr:`added_users` are equal.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.8

Args:
is_access_restricted (:obj:`bool`): :obj:`True`, if only selected users can access the bot.
Expand Down
8 changes: 4 additions & 4 deletions src/telegram/_chat.py
Original file line number Diff line number Diff line change
Expand Up @@ -1110,7 +1110,7 @@ async def send_message_draft(

For the documentation of the arguments, please see :meth:`telegram.Bot.send_message_draft`.

.. versionchanged:: NEXT.VERSION
.. versionchanged:: 22.8
Bot API 10.0 makes the ``text`` argument optional.

Returns:
Expand Down Expand Up @@ -1392,7 +1392,7 @@ async def send_live_photo(

For the documentation of the arguments, please see :meth:`telegram.Bot.send_live_photo`.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.8

Returns:
:class:`telegram.Message`: On success, instance representing the message posted.
Expand Down Expand Up @@ -4155,7 +4155,7 @@ async def delete_reaction(
For the documentation of the arguments, please see
:meth:`telegram.Bot.delete_message_reaction`.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.8

Returns:
:obj:`bool`: On success, :obj:`True` is returned.
Expand Down Expand Up @@ -4195,7 +4195,7 @@ async def delete_all_reactions(
For the documentation of the arguments, please see
:meth:`telegram.Bot.delete_all_message_reactions`.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.8

Returns:
:obj:`bool`: On success, :obj:`True` is returned.
Expand Down
6 changes: 3 additions & 3 deletions src/telegram/_chatmember.py
Original file line number Diff line number Diff line change
Expand Up @@ -521,7 +521,7 @@ class ChatMemberRestricted(ChatMember):
can_react_to_messages (:obj:`bool`): :obj:`True`, if the user is allowed to react to
messages.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.8
tag (:obj:`str`, optional): Tag of the member.

.. versionadded:: 22.7
Expand Down Expand Up @@ -582,7 +582,7 @@ class ChatMemberRestricted(ChatMember):
can_react_to_messages (:obj:`bool`): :obj:`True`, if the user is allowed to react to
messages.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.8
tag (:obj:`str`): Optional. Tag of the member.

.. versionadded:: 22.7
Expand Down Expand Up @@ -632,7 +632,7 @@ def __init__(
can_send_voice_notes: bool,
can_edit_tag: bool,
tag: str | None = None,
# tags: NEXT.VERSION
# tags: 22.8
# temporarily optional to make it not breaking
can_react_to_messages: bool | None = None,
*,
Expand Down
6 changes: 3 additions & 3 deletions src/telegram/_chatpermissions.py
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,7 @@ class ChatPermissions(TelegramObject):
.. versionchanged:: 22.7
:attr:`can_edit_tag` is considered as well when comparing objects of
this type in terms of equality.
.. versionchanged:: NEXT.VERSION
.. versionchanged:: 22.8
:attr:`can_react_to_messages` is considered as well when comparing objects of
this type in terms of equality.

Expand Down Expand Up @@ -106,7 +106,7 @@ class ChatPermissions(TelegramObject):
can_react_to_messages (:obj:`bool`, optional): :obj:`True`, if the user is allowed to react
to messages. If omitted, defaults to the value of :attr:`can_send_messages`.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.8

Attributes:
can_send_messages (:obj:`bool`): Optional. :obj:`True`, if the user is allowed to send text
Expand Down Expand Up @@ -155,7 +155,7 @@ class ChatPermissions(TelegramObject):
can_react_to_messages (:obj:`bool`): Optional. :obj:`True`, if the user is allowed to react
to messages. If omitted, defaults to the value of :attr:`can_send_messages`.

.. versionadded:: NEXT.VERSION
.. versionadded:: 22.8

"""

Expand Down
Loading
Loading