From ad4881592622251451199240a1a8f3c8a7b64b6b Mon Sep 17 00:00:00 2001
From: Rapptz <rapptz@gmail.com>
Date: Tue, 19 Aug 2025 03:58:40 -0400
Subject: [PATCH] Add Permissions.pin_messages

---
 discord/permissions.py | 20 +++++++++++++++++---
 1 file changed, 17 insertions(+), 3 deletions(-)

diff --git a/discord/permissions.py b/discord/permissions.py
index 9d3cac89f..59cb685e5 100644
--- a/discord/permissions.py
+++ b/discord/permissions.py
@@ -93,6 +93,7 @@ if TYPE_CHECKING:
         send_polls: BoolOrNoneT
         create_polls: BoolOrNoneT
         use_external_apps: BoolOrNoneT
+        pin_messages: BoolOrNoneT
 
     class _PermissionsKwargs(_BasePermissionsKwargs[bool]): ...
 
@@ -251,7 +252,7 @@ class Permissions(BaseFlags):
         permissions set to ``True``.
         """
         # Some of these are 0 because we don't want to set unnecessary bits
-        return cls(0b0000_0000_0000_0110_0111_1111_1111_1111_1111_1111_1111_1111_1111_1111_1111_1111)
+        return cls(0b0000_0000_0000_1110_0111_1111_1111_1111_1111_1111_1111_1111_1111_1111_1111_1111)
 
     @classmethod
     def _timeout_mask(cls) -> int:
@@ -266,6 +267,7 @@ class Permissions(BaseFlags):
         base.read_messages = True
         base.send_tts_messages = False
         base.manage_messages = False
+        base.pin_messages = True
         base.create_private_threads = False
         base.create_public_threads = False
         base.manage_threads = False
@@ -324,7 +326,7 @@ class Permissions(BaseFlags):
             Added :attr:`send_polls`, :attr:`send_voice_messages`, attr:`use_external_sounds`,
             :attr:`use_embedded_activities`, and :attr:`use_external_apps` permissions.
         """
-        return cls(0b0000_0000_0000_0110_0110_0100_1111_1101_1011_0011_1111_0111_1111_1111_0101_0001)
+        return cls(0b0000_0000_0000_1110_0110_0100_1111_1101_1011_0011_1111_0111_1111_1111_0101_0001)
 
     @classmethod
     def general(cls) -> Self:
@@ -372,8 +374,11 @@ class Permissions(BaseFlags):
 
         .. versionchanged:: 2.4
             Added :attr:`send_polls` and :attr:`use_external_apps` permissions.
+
+        .. versionchanged:: 2.7
+            Added :attr:`pin_messages` permission.
         """
-        return cls(0b0000_0000_0000_0110_0100_0000_0111_1100_1000_0000_0000_0111_1111_1000_0100_0000)
+        return cls(0b0000_0000_0000_1110_0100_0000_0111_1100_1000_0000_0000_0111_1111_1000_0100_0000)
 
     @classmethod
     def voice(cls) -> Self:
@@ -858,6 +863,14 @@ class Permissions(BaseFlags):
         """
         return 1 << 50
 
+    @flag_value
+    def pin_messages(self) -> int:
+        """:class:`bool`: Returns ``True`` if a user can pin messages.
+
+        .. versionadded:: 2.7
+        """
+        return 1 << 51
+
 
 def _augment_from_permissions(cls):
     cls.VALID_NAMES = set(Permissions.VALID_FLAGS)
@@ -981,6 +994,7 @@ class PermissionOverwrite:
         send_polls: Optional[bool]
         create_polls: Optional[bool]
         use_external_apps: Optional[bool]
+        pin_messages: Optional[bool]
 
     def __init__(self, **kwargs: Unpack[_PermissionOverwriteKwargs]) -> None:
         self._values: Dict[str, Optional[bool]] = {}