From: Harmon <Harmon758@gmail.com>
Date: Sat, 26 Aug 2023 17:45:15 +0000 (-0500)
Subject: Add notes about endpoint removals in Client / AsyncClient documentation
X-Git-Url: https://vcs.fsf.org/?a=commitdiff_plain;h=f32d12dbddbd877470446657812a10a04292d0c9;p=tweepy.git

Add notes about endpoint removals in Client / AsyncClient documentation

https://developer.twitter.com/en/updates/changelog
---

diff --git a/docs/asyncclient.rst b/docs/asyncclient.rst
index 4458308..3baef86 100644
--- a/docs/asyncclient.rst
+++ b/docs/asyncclient.rst
@@ -527,3 +527,8 @@ Batch compliance
 .. automethod:: AsyncClient.get_compliance_job
 
 .. automethod:: AsyncClient.create_compliance_job
+
+
+.. rubric:: Footnotes
+
+.. [#changelog] https://developer.twitter.com/en/updates/changelog
diff --git a/docs/client.rst b/docs/client.rst
index 2fec1b6..bb7643f 100644
--- a/docs/client.rst
+++ b/docs/client.rst
@@ -531,3 +531,8 @@ Batch compliance
 .. automethod:: Client.get_compliance_job
 
 .. automethod:: Client.create_compliance_job
+
+
+.. rubric:: Footnotes
+
+.. [#changelog] https://developer.twitter.com/en/updates/changelog
diff --git a/tweepy/asynchronous/client.py b/tweepy/asynchronous/client.py
index 312332a..08b65ef 100644
--- a/tweepy/asynchronous/client.py
+++ b/tweepy/asynchronous/client.py
@@ -1835,6 +1835,11 @@ class AsyncClient(AsyncBaseClient):
 
         Returns a list of users who are followers of the specified user ID.
 
+        .. note::
+
+            The Twitter API endpoint that this method uses has been removed
+            from the Basic and Pro tiers [#changelog]_.
+
         Parameters
         ----------
         id : int | str
@@ -1883,6 +1888,11 @@ class AsyncClient(AsyncBaseClient):
 
         Returns a list of users the specified user ID is following.
 
+        .. note::
+
+            The Twitter API endpoint that this method uses has been removed
+            from the Basic and Pro tiers [#changelog]_.
+
         Parameters
         ----------
         id : int | str
@@ -2822,6 +2832,11 @@ class AsyncClient(AsyncBaseClient):
 
         Returns a list of users who are followers of the specified List.
 
+        .. note::
+
+            The Twitter API endpoint that this method uses has been removed
+            from the Basic and Pro tiers [#changelog]_.
+
         Parameters
         ----------
         id : list[str] | str
@@ -2869,6 +2884,11 @@ class AsyncClient(AsyncBaseClient):
 
         Returns all Lists a specified user follows.
 
+        .. note::
+
+            The Twitter API endpoint that this method uses has been removed
+            from the Basic and Pro tiers [#changelog]_.
+
         Parameters
         ----------
         id : list[str] | str
diff --git a/tweepy/client.py b/tweepy/client.py
index 1217386..bf0f57d 100644
--- a/tweepy/client.py
+++ b/tweepy/client.py
@@ -1973,6 +1973,11 @@ class Client(BaseClient):
 
         Returns a list of users who are followers of the specified user ID.
 
+        .. note::
+
+            The Twitter API endpoint that this method uses has been removed
+            from the Basic and Pro tiers [#changelog]_.
+
         Parameters
         ----------
         id : int | str
@@ -2021,6 +2026,11 @@ class Client(BaseClient):
 
         Returns a list of users the specified user ID is following.
 
+        .. note::
+
+            The Twitter API endpoint that this method uses has been removed
+            from the Basic and Pro tiers [#changelog]_.
+
         Parameters
         ----------
         id : int | str
@@ -3028,6 +3038,11 @@ class Client(BaseClient):
 
         Returns a list of users who are followers of the specified List.
 
+        .. note::
+
+            The Twitter API endpoint that this method uses has been removed
+            from the Basic and Pro tiers [#changelog]_.
+
         .. versionadded:: 4.4
 
         Parameters
@@ -3077,6 +3092,11 @@ class Client(BaseClient):
 
         Returns all Lists a specified user follows.
 
+        .. note::
+
+            The Twitter API endpoint that this method uses has been removed
+            from the Basic and Pro tiers [#changelog]_.
+
         .. versionadded:: 4.4
 
         Parameters