python-telegram-bot · Bibo-Joshi · Jul 20, 2025 · Jul 20, 2025 · Jul 20, 2025 · Jul 20, 2025
diff --git a/...released/4837.cVTsY7pxfQqgVXfFW9hgZK.toml → ...25-07-20/4837.cVTsY7pxfQqgVXfFW9hgZK.toml b/...released/4837.cVTsY7pxfQqgVXfFW9hgZK.toml → ...25-07-20/4837.cVTsY7pxfQqgVXfFW9hgZK.toml
diff --git a/...released/4839.gExNhF7C6kR5VrBg6cBaar.toml → ...25-07-20/4839.gExNhF7C6kR5VrBg6cBaar.toml b/...released/4839.gExNhF7C6kR5VrBg6cBaar.toml → ...25-07-20/4839.gExNhF7C6kR5VrBg6cBaar.toml
diff --git a/...released/4840.jz9uGugc5DUd8x8pQHPyzg.toml → ...25-07-20/4840.jz9uGugc5DUd8x8pQHPyzg.toml b/...released/4840.jz9uGugc5DUd8x8pQHPyzg.toml → ...25-07-20/4840.jz9uGugc5DUd8x8pQHPyzg.toml
diff --git a/...released/4841.HHVCCXXZbYAaaQVmKHCJm2.toml → ...25-07-20/4841.HHVCCXXZbYAaaQVmKHCJm2.toml b/...released/4841.HHVCCXXZbYAaaQVmKHCJm2.toml → ...25-07-20/4841.HHVCCXXZbYAaaQVmKHCJm2.toml
diff --git a/...released/4842.PSW9ZbxENhwfRhbSfemCwE.toml → ...25-07-20/4842.PSW9ZbxENhwfRhbSfemCwE.toml b/...released/4842.PSW9ZbxENhwfRhbSfemCwE.toml → ...25-07-20/4842.PSW9ZbxENhwfRhbSfemCwE.toml
diff --git a/...released/4843.f5aZ5Vpxevw8fEEudawU5u.toml → ...25-07-20/4843.f5aZ5Vpxevw8fEEudawU5u.toml b/...released/4843.f5aZ5Vpxevw8fEEudawU5u.toml → ...25-07-20/4843.f5aZ5Vpxevw8fEEudawU5u.toml
diff --git a/...released/4847.8ujbbBbaZ2VTEdRLeqirSZ.toml → ...25-07-20/4847.8ujbbBbaZ2VTEdRLeqirSZ.toml b/...released/4847.8ujbbBbaZ2VTEdRLeqirSZ.toml → ...25-07-20/4847.8ujbbBbaZ2VTEdRLeqirSZ.toml
diff --git a/...released/4852.mz3RDjX636ZdGoR456C6v9.toml → ...25-07-20/4852.mz3RDjX636ZdGoR456C6v9.toml b/...released/4852.mz3RDjX636ZdGoR456C6v9.toml → ...25-07-20/4852.mz3RDjX636ZdGoR456C6v9.toml
diff --git a/...released/4855.8hCFRFMeMaRWpBEYaxrTMq.toml → ...25-07-20/4855.8hCFRFMeMaRWpBEYaxrTMq.toml b/...released/4855.8hCFRFMeMaRWpBEYaxrTMq.toml → ...25-07-20/4855.8hCFRFMeMaRWpBEYaxrTMq.toml
diff --git a/...released/4858.ajt46xDsbfzFqcghJ2rP6g.toml → ...25-07-20/4858.ajt46xDsbfzFqcghJ2rP6g.toml b/...released/4858.ajt46xDsbfzFqcghJ2rP6g.toml → ...25-07-20/4858.ajt46xDsbfzFqcghJ2rP6g.toml
diff --git a/changes/22.3_2025-07-20/4870.QeVo4BE5TNouLRJjCFbRMo.toml b/changes/22.3_2025-07-20/4870.QeVo4BE5TNouLRJjCFbRMo.toml
@@ -0,0 +1,5 @@
+other = "Bump Version to v22.3"
+[[pull_requests]]
+uid = "4870"
+author_uid = "Bibo-Joshi"
+closes_threads = []
diff --git a/changes/config.py b/changes/config.py
@@ -80,7 +80,7 @@ def release(self, version: Version) -> bool:
         """replace "14.5" with version.uid except in the contrib guide
         then call super
         """
-        root = Path(__file__).parent.parent / "telegram"
+        root = Path(__file__).parent.parent / "src"
         python_files = root.rglob("*.py")
         pattern = re.compile(r"NEXT\.VERSION")
         excluded_paths = {root / "docs/source/contribute.rst"}

diff --git a/src/telegram/_bot.py b/src/telegram/_bot.py
@@ -7578,7 +7578,7 @@ async def send_checklist(
         """
         Use this method to send a checklist on behalf of a connected business account.
 
-        .. versionadded:: NEXT.VERSION
+        .. versionadded:: 22.3
 
         Args:
             business_connection_id (:obj:`str`):
@@ -7653,7 +7653,7 @@ async def edit_message_checklist(
         """
         Use this method to edit a checklist on behalf of a connected business account.
 
-        .. versionadded:: NEXT.VERSION
+        .. versionadded:: 22.3
 
         Args:
             business_connection_id (:obj:`str`):
@@ -11220,7 +11220,7 @@ async def get_my_star_balance(
     ) -> StarAmount:
         """A method to get the current Telegram Stars balance of the bot. Requires no parameters.
 
-        .. versionadded:: NEXT.VERSION
+        .. versionadded:: 22.3
 
         Returns:
             :class:`telegram.StarAmount`

diff --git a/src/telegram/_business.py b/src/telegram/_business.py
@@ -191,7 +191,7 @@ class BusinessConnection(TelegramObject):
     .. versionchanged:: 22.1
         Equality comparison now considers :attr:`rights` instead of ``can_reply``.
 
-    .. versionremoved:: NEXT.VERSION
+    .. versionremoved:: 22.3
        Removed argument and attribute ``can_reply`` deprecated  by API 9.0.
 
     Args:

diff --git a/src/telegram/_callbackquery.py b/src/telegram/_callbackquery.py
@@ -364,7 +364,7 @@ async def edit_message_checklist(
         For the documentation of the arguments, please see
         :meth:`telegram.Message.edit_checklist`.
 
-        .. versionadded:: NEXT.VERSION
+        .. versionadded:: 22.3
 
         Returns:
             :class:`telegram.Message`: On success, the edited Message is returned.

diff --git a/src/telegram/_chat.py b/src/telegram/_chat.py
@@ -1496,7 +1496,7 @@ async def send_checklist(
 
         For the documentation of the arguments, please see :meth:`telegram.Bot.send_checklist`.
 
-        .. versionadded:: NEXT.VERSION
+        .. versionadded:: 22.3
 
         Returns:
             :class:`telegram.Message`: On success, instance representing the message posted.

diff --git a/src/telegram/_chatfullinfo.py b/src/telegram/_chatfullinfo.py
@@ -60,7 +60,7 @@ class ChatFullInfo(_ChatBase):
         object. Previously those were only available because this class inherited from
         :class:`telegram.Chat`.
 
-    .. versionremoved:: NEXT.VERSION
+    .. versionremoved:: 22.3
        Removed argument and attribute ``can_send_gift`` deprecated  by API 9.0.
 
     Args:

diff --git a/src/telegram/_checklists.py b/src/telegram/_checklists.py
@@ -41,7 +41,7 @@ class ChecklistTask(TelegramObject):
     Objects of this class are comparable in terms of equality.
     Two objects of this class are considered equal, if all their :attr:`id` is equal.
 
-    .. versionadded:: NEXT.VERSION
+    .. versionadded:: 22.3
 
     Args:
         id (:obj:`int`): Unique identifier of the task.
@@ -165,7 +165,7 @@ class Checklist(TelegramObject):
     Objects of this class are comparable in terms of equality.
     Two objects of this class are considered equal, if all their :attr:`tasks` are equal.
 
-    .. versionadded:: NEXT.VERSION
+    .. versionadded:: 22.3
 
     Args:
         title (:obj:`str`): Title of the checklist.
@@ -276,7 +276,7 @@ class ChecklistTasksDone(TelegramObject):
     Two objects of this class are considered equal, if their :attr:`marked_as_done_task_ids` and
     :attr:`marked_as_not_done_task_ids` are equal.
 
-    .. versionadded:: NEXT.VERSION
+    .. versionadded:: 22.3
 
     Args:
         checklist_message (:class:`telegram.Message`, optional): Message containing the checklist
@@ -344,7 +344,7 @@ class ChecklistTasksAdded(TelegramObject):
     Objects of this class are comparable in terms of equality.
     Two objects of this class are considered equal, if their :attr:`tasks` are equal.
 
-    .. versionadded:: NEXT.VERSION
+    .. versionadded:: 22.3
 
     Args:
         checklist_message (:class:`telegram.Message`, optional): Message containing the checklist

diff --git a/src/telegram/_directmessagepricechanged.py b/src/telegram/_directmessagepricechanged.py
@@ -30,7 +30,7 @@ class DirectMessagePriceChanged(TelegramObject):
     Describes a service message about a change in the price of direct messages sent to a channel
     chat.
 
-    .. versionadded:: NEXT.VERSION
+    .. versionadded:: 22.3
 
     Objects of this class are comparable in terms of equality. Two objects of this class are
     considered equal, if their :attr:`are_direct_messages_enabled`, and

diff --git a/src/telegram/_inputchecklist.py b/src/telegram/_inputchecklist.py
@@ -34,7 +34,7 @@ class InputChecklistTask(TelegramObject):
     Objects of this class are comparable in terms of equality.
     Two objects of this class are considered equal if their :attr:`id` is equal.
 
-    .. versionadded:: NEXT.VERSION
+    .. versionadded:: 22.3
 
     Args:
         id (:obj:`int`):
@@ -104,7 +104,7 @@ class InputChecklist(TelegramObject):
     Objects of this class are comparable in terms of equality.
     Two objects of this class are considered equal if their :attr:`tasks` is equal.
 
-    .. versionadded:: NEXT.VERSION
+    .. versionadded:: 22.3
 
     Args:
         title (:obj:`str`):

diff --git a/src/telegram/_message.py b/src/telegram/_message.py
@@ -529,7 +529,7 @@ class Message(MaybeInaccessibleMessage):
             .. versionadded:: 20.0
         checklist (:class:`telegram.Checklist`, optional): Message is a checklist
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 22.3
         users_shared (:class:`telegram.UsersShared`, optional): Service message: users were shared
             with the bot
 
@@ -610,11 +610,11 @@ class Message(MaybeInaccessibleMessage):
         checklist_tasks_done (:class:`telegram.ChecklistTasksDone`, optional): Service message:
             some tasks in a checklist were marked as done or not done
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 22.3
         checklist_tasks_added (:class:`telegram.ChecklistTasksAdded`, optional): Service message:
             tasks were added to a checklist
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 22.3
         paid_media (:class:`telegram.PaidMediaInfo`, optional): Message contains paid media;
             information about the paid media.
 
@@ -627,7 +627,7 @@ class Message(MaybeInaccessibleMessage):
             Service message: the price for paid messages in the corresponding direct messages chat
             of a channel has changed.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 22.3
 
     Attributes:
         message_id (:obj:`int`): Unique message identifier inside this chat. In specific instances
@@ -889,7 +889,7 @@ class Message(MaybeInaccessibleMessage):
             .. versionadded:: 20.0
         checklist (:class:`telegram.Checklist`): Optional. Message is a checklist
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 22.3
         users_shared (:class:`telegram.UsersShared`): Optional. Service message: users were shared
             with the bot
 
@@ -971,11 +971,11 @@ class Message(MaybeInaccessibleMessage):
         checklist_tasks_done (:class:`telegram.ChecklistTasksDone`): Optional. Service message:
             some tasks in a checklist were marked as done or not done
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 22.3
         checklist_tasks_added (:class:`telegram.ChecklistTasksAdded`): Optional. Service message:
             tasks were added to a checklist
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 22.3
         paid_media (:class:`telegram.PaidMediaInfo`): Optional. Message contains paid media;
             information about the paid media.
 
@@ -988,7 +988,7 @@ class Message(MaybeInaccessibleMessage):
             Optional. Service message: the price for paid messages in the corresponding direct
             messages chat of a channel has changed.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 22.3
 
     .. |custom_emoji_no_md1_support| replace:: Since custom emoji entities are not supported by
        :attr:`~telegram.constants.ParseMode.MARKDOWN`, this method now raises a
@@ -3338,7 +3338,7 @@ async def reply_checklist(
 
         For the documentation of the arguments, please see :meth:`telegram.Bot.send_checklist`.
 
-        .. versionadded:: NEXT.VERSION
+        .. versionadded:: 22.3
 
         Keyword Args:
             do_quote (:obj:`bool` | :obj:`dict`, optional): |do_quote|
@@ -3998,7 +3998,7 @@ async def edit_checklist(
         For the documentation of the arguments, please see
         :meth:`telegram.Bot.edit_message_checklist`.
 
-        .. versionadded:: NEXT.VERSION
+        .. versionadded:: 22.3
 
         Note:
             You can only edit messages that the bot sent itself (i.e. of the ``bot.send_*`` family

diff --git a/src/telegram/_ownedgift.py b/src/telegram/_ownedgift.py
@@ -357,7 +357,7 @@ class OwnedGiftUnique(OwnedGift):
         next_transfer_date (:obj:`datetime.datetime`, optional): Date when the gift can be
             transferred. If it's in the past, then the gift can be transferred now.
             |datetime_localization|
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 22.3
 
     Attributes:
         type (:obj:`str`): Type of the owned gift, always :tg-const:`~telegram.OwnedGift.UNIQUE`.
@@ -376,7 +376,7 @@ class OwnedGiftUnique(OwnedGift):
         next_transfer_date (:obj:`datetime.datetime`): Optional. Date when the gift can be
             transferred. If it's in the past, then the gift can be transferred now.
             |datetime_localization|
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 22.3
     """
 
     __slots__ = (

diff --git a/src/telegram/_reply.py b/src/telegram/_reply.py
@@ -92,7 +92,7 @@ class ExternalReplyInfo(TelegramObject):
             a spoiler animation.
         checklist (:class:`telegram.Checklist`, optional): Message is a checklist
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 22.3
         contact (:class:`telegram.Contact`, optional): Message is a shared contact, information
             about the contact.
         dice (:class:`telegram.Dice`, optional): Message is a dice with random value.
@@ -144,7 +144,7 @@ class ExternalReplyInfo(TelegramObject):
             a spoiler animation.
         checklist (:class:`telegram.Checklist`): Optional. Message is a checklist
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 22.3
         contact (:class:`telegram.Contact`): Optional. Message is a shared contact, information
             about the contact.
         dice (:class:`telegram.Dice`): Optional. Message is a dice with random value.

diff --git a/src/telegram/_uniquegift.py b/src/telegram/_uniquegift.py
@@ -346,7 +346,7 @@ class UniqueGiftInfo(TelegramObject):
             upgraded from regular gifts, :attr:`TRANSFER` for gifts transferred from other users
             or channels, or :attr:`RESALE` for gifts bought from other users.
 
-            .. versionchanged:: NEXT.VERSION
+            .. versionchanged:: 22.3
                 The :attr:`RESALE` origin was added.
         owned_gift_id (:obj:`str`, optional) Unique identifier of the received gift for the
             bot; only present for gifts received on behalf of business accounts.
@@ -355,20 +355,20 @@ class UniqueGiftInfo(TelegramObject):
         last_resale_star_count (:obj:`int`, optional): For gifts bought from other users, the price
             paid for the gift.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 22.3
         next_transfer_date (:obj:`datetime.datetime`, optional): Date when the gift can be
             transferred. If it's in the past, then the gift can be transferred now.
             |datetime_localization|
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 22.3
 
     Attributes:
         gift (:class:`UniqueGift`): Information about the gift.
         origin (:obj:`str`): Origin of the gift. Currently, either :attr:`UPGRADE` for gifts
             upgraded from regular gifts, :attr:`TRANSFER` for gifts transferred from other users
             or channels, or :attr:`RESALE` for gifts bought from other users.
 
-            .. versionchanged:: NEXT.VERSION
+            .. versionchanged:: 22.3
                 The :attr:`RESALE` origin was added.
         owned_gift_id (:obj:`str`) Optional. Unique identifier of the received gift for the
             bot; only present for gifts received on behalf of business accounts.
@@ -377,12 +377,12 @@ class UniqueGiftInfo(TelegramObject):
         last_resale_star_count (:obj:`int`): Optional. For gifts bought from other users, the price
             paid for the gift.
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 22.3
         next_transfer_date (:obj:`datetime.datetime`): Optional. Date when the gift can be
             transferred. If it's in the past, then the gift can be transferred now.
             |datetime_localization|
 
-            .. versionadded:: NEXT.VERSION
+            .. versionadded:: 22.3
     """
 
     UPGRADE: Final[str] = constants.UniqueGiftInfoOrigin.UPGRADE
@@ -392,7 +392,7 @@ class UniqueGiftInfo(TelegramObject):
     RESALE: Final[str] = constants.UniqueGiftInfoOrigin.RESALE
     """:const:`telegram.constants.UniqueGiftInfoOrigin.RESALE`
 
-    .. versionadded:: NEXT.VERSION
+    .. versionadded:: 22.3
     """
 
     __slots__ = (

diff --git a/src/telegram/_version.py b/src/telegram/_version.py
@@ -51,6 +51,6 @@ def __str__(self) -> str:
 
 
 __version_info__: Final[Version] = Version(
-    major=22, minor=2, micro=0, releaselevel="final", serial=0
+    major=22, minor=3, micro=0, releaselevel="final", serial=0
 )
 __version__: Final[str] = str(__version_info__)
diff --git a/src/telegram/constants.py b/src/telegram/constants.py
@@ -28,7 +28,7 @@
 
     * Most of the constants in this module are grouped into enums.
 
-.. versionremoved:: NEXT.VERSION
+.. versionremoved:: 22.3
     Removed deprecated class ``StarTransactions``. Please instead use
     :attr:`telegram.constants.Nanostar.VALUE`.
 """
@@ -1418,7 +1418,7 @@ class InputChecklistLimit(IntEnum):
     :class:`telegram.InputChecklistTask`. The enum
     members of this enumeration are instances of :class:`int` and can be treated as such.
 
-    .. versionadded:: NEXT.VERSION
+    .. versionadded:: 22.3
     """
 
     __slots__ = ()
@@ -2104,17 +2104,17 @@ class MessageType(StringEnum):
     CHECKLIST = "checklist"
     """:obj:`str`: Messages with :attr:`telegram.Message.checklist`.
 
-    .. versionadded:: NEXT.VERSION
+    .. versionadded:: 22.3
     """
     CHECKLIST_TASKS_ADDED = "checklist_tasks_added"
     """:obj:`str`: Messages with :attr:`telegram.Message.checklist_tasks_added`.
 
-    .. versionadded:: NEXT.VERSION
+    .. versionadded:: 22.3
     """
     CHECKLIST_TASKS_DONE = "checklist_tasks_done"
     """:obj:`str`: Messages with :attr:`telegram.Message.checklist_tasks_done`.
 
-    .. versionadded:: NEXT.VERSION
+    .. versionadded:: 22.3
     """
     CONNECTED_WEBSITE = "connected_website"
     """:obj:`str`: Messages with :attr:`telegram.Message.connected_website`."""
@@ -2127,7 +2127,7 @@ class MessageType(StringEnum):
     DIRECT_MESSAGE_PRICE_CHANGED = "direct_message_price_changed"
     """:obj:`str`: Messages with :attr:`telegram.Message.direct_message_price_changed`.
 
-    .. versionadded:: NEXT.VERSION
+    .. versionadded:: 22.3
     """
     DOCUMENT = "document"
     """:obj:`str`: Messages with :attr:`telegram.Message.document`."""
@@ -2810,7 +2810,7 @@ class StarTransactionsLimit(IntEnum):
 
     .. versionadded:: 21.4
 
-    .. versionremoved:: NEXT.VERSION
+    .. versionremoved:: 22.3
         Removed deprecated attributes ``StarTransactionsLimit.NANOSTAR_MIN_AMOUNT``
         and ``StarTransactionsLimit.NANOSTAR_MAX_AMOUNT``. Please instead use
         :attr:`telegram.constants.NanostarLimit.MIN_AMOUNT`
@@ -3183,7 +3183,7 @@ class PollLimit(IntEnum):
     to the :paramref:`~telegram.Bot.send_poll.options` parameter of
     :meth:`telegram.Bot.send_poll`.
 
-    .. versionchanged:: NEXT.VERSION
+    .. versionchanged:: 22.3
         This value was changed from ``10`` to ``12`` in accordance to Bot API 9.1.
     """
     MAX_EXPLANATION_LENGTH = 200
@@ -3242,7 +3242,7 @@ class UniqueGiftInfoOrigin(StringEnum):
     RESALE = "resale"
     """:obj:`str` gift bought from other users
 
-    .. versionadded:: NEXT.VERSION
+    .. versionadded:: 22.3
     """