Add new subscription_id param to fetch_eventsub_subs

Author: chillymosh

twitchio/client.py

@@ -2336,6 +2336,7 @@ async def fetch_eventsub_subscriptions(
         token_for: str | PartialUser | None = None,
         type: str | None = None,
         user_id: str | PartialUser | None = None,
+        subscription_id: str | None = None,
         status: Literal[
             "enabled",
             "webhook_callback_verification_pending",
@@ -2362,7 +2363,7 @@ async def fetch_eventsub_subscriptions(
         Fetches Eventsub Subscriptions for either webhook or websocket.
 
         .. note::
-            type, status and user_id are mutually exclusive and only one can be passed, otherwise ValueError will be raised.
+            type, status, user_id, and subscription_id are mutually exclusive and only one can be passed, otherwise ValueError will be raised.
 
             This endpoint returns disabled WebSocket subscriptions for a minimum of 1 minute as compared to webhooks which returns disabled subscriptions for a minimum of 10 days.
 
@@ -2376,6 +2377,8 @@ async def fetch_eventsub_subscriptions(
             Filter subscriptions by subscription type. e.g. ``channel.follow`` For a list of subscription types, see `Subscription Types <https://dev.twitch.tv/docs/eventsub/eventsub-subscription-types/#subscription-types>`_.
         user_id: str | PartialUser | None
             Filter subscriptions by user ID, or PartialUser. The response contains subscriptions where this ID matches a user ID that you specified in the Condition object when you created the subscription.
+        subscription_id: str | None
+            The specific subscription ID to fetch.
         status: str | None = None
             Filter subscriptions by its status. Possible values are:
 
@@ -2430,17 +2433,20 @@ async def fetch_eventsub_subscriptions(
         Raises
         ------
         ValueError
-            Only one of 'status', 'user_id', or 'type' can be provided.
+            Only one of 'status', 'user_id', 'subscription_id', or 'type' can be provided.
         """
 
-        provided: int = len([v for v in (type, user_id, status) if v])
+        provided: int = len([v for v in (type, user_id, status, subscription_id) if v])
         if provided > 1:
-            raise ValueError("Only one of 'status', 'user_id', or 'type' can be provided.")
+            raise ValueError("Only one of 'status', 'user_id', 'subscription_id', or 'type' can be provided.")
 
         return await self._http.get_eventsub_subscription(
             type=type,
             max_results=max_results,
             token_for=token_for,
+            subscription_id=subscription_id,
+            user_id=user_id,
+            status=status,
         )
 
     async def delete_eventsub_subscription(self, id: str, *, token_for: str | PartialUser | None = None) -> None:

twitchio/http.py

@@ -1486,6 +1486,7 @@ async def get_eventsub_subscription(
         ]
         | None = None,
         user_id: str | PartialUser | None = None,
+        subscription_id: str | None = None,
         type: str | None = None,
         max_results: int | None = None,
         token_for: str | PartialUser | None = None,
@@ -1498,6 +1499,8 @@ async def get_eventsub_subscription(
             params["status"] = status
         if user_id is not None:
             params["user_id"] = str(user_id)
+        if subscription_id is not None:
+            params["subscription_id"] = subscription_id
 
         route: Route = Route("GET", "eventsub/subscriptions", params=params, token_for=token_for)