universal-mcp-applications 0.1.12__py3-none-any.whl → 0.1.14__py3-none-any.whl

universal_mcp/applications/twitter/api_segments/users_api.py

@@ -7,26 +7,25 @@ class UsersApi(APISegmentBase):
     def __init__(self, main_app_client: Any):
         super().__init__(main_app_client)
 
-    def find_users_by_id(
+    def get_users_by_ids(
         self, ids, user_fields=None, expansions=None, tweet_fields=None
     ) -> dict[str, Any]:
         """
-
-        Retrieves information about one or more users specified by their IDs, allowing for customization with user fields and expansions.
-
+        Retrieves detailed information for multiple users in a single API request, specified by a list of their unique IDs. Unlike `find_user_by_id`, which fetches a single user, this function performs a bulk lookup and allows for response customization with optional fields and expansions.
+        
         Args:
             ids (array): A required query parameter specifying an array of user IDs to retrieve information for multiple users in a single request. Example: '2244994945,6253282,12'.
             user_fields (array): A comma separated list of User fields to display. Example: "['affiliation', 'connection_status', 'created_at', 'description', 'entities', 'id', 'location', 'most_recent_tweet_id', 'name', 'pinned_tweet_id', 'profile_banner_url', 'profile_image_url', 'protected', 'public_metrics', 'receives_your_dm', 'subscription_type', 'url', 'username', 'verified', 'verified_type', 'withheld']".
             expansions (array): A comma separated list of fields to expand. Example: "['affiliation.user_id', 'most_recent_tweet_id', 'pinned_tweet_id']".
             tweet_fields (array): A comma separated list of Tweet fields to display. Example: "['article', 'attachments', 'author_id', 'card_uri', 'context_annotations', 'conversation_id', 'created_at', 'edit_controls', 'edit_history_tweet_ids', 'entities', 'geo', 'id', 'in_reply_to_user_id', 'lang', 'non_public_metrics', 'note_tweet', 'organic_metrics', 'possibly_sensitive', 'promoted_metrics', 'public_metrics', 'referenced_tweets', 'reply_settings', 'scopes', 'source', 'text', 'username', 'withheld']".
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Users
         """
@@ -45,26 +44,25 @@ class UsersApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def find_users_by_username(
+    def get_users_by_usernames(
         self, usernames, user_fields=None, expansions=None, tweet_fields=None
     ) -> dict[str, Any]:
         """
-
-        Retrieves information about one or more users specified by their usernames using the Twitter API, allowing optional specification of additional user fields and expansions.
-
+        Fetches public data for a batch of users specified by their usernames. This function supports retrieving multiple users in a single request, unlike `find_user_by_username`. It allows for data customization through optional fields and expansions.
+        
         Args:
             usernames (array): Required array of usernames to filter users by. Example: 'TwitterDev,TwitterAPI'.
             user_fields (array): A comma separated list of User fields to display. Example: "['affiliation', 'connection_status', 'created_at', 'description', 'entities', 'id', 'location', 'most_recent_tweet_id', 'name', 'pinned_tweet_id', 'profile_banner_url', 'profile_image_url', 'protected', 'public_metrics', 'receives_your_dm', 'subscription_type', 'url', 'username', 'verified', 'verified_type', 'withheld']".
             expansions (array): A comma separated list of fields to expand. Example: "['affiliation.user_id', 'most_recent_tweet_id', 'pinned_tweet_id']".
             tweet_fields (array): A comma separated list of Tweet fields to display. Example: "['article', 'attachments', 'author_id', 'card_uri', 'context_annotations', 'conversation_id', 'created_at', 'edit_controls', 'edit_history_tweet_ids', 'entities', 'geo', 'id', 'in_reply_to_user_id', 'lang', 'non_public_metrics', 'note_tweet', 'organic_metrics', 'possibly_sensitive', 'promoted_metrics', 'public_metrics', 'referenced_tweets', 'reply_settings', 'scopes', 'source', 'text', 'username', 'withheld']".
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Users
         """
@@ -87,22 +85,21 @@ class UsersApi(APISegmentBase):
         self, username, user_fields=None, expansions=None, tweet_fields=None
     ) -> dict[str, Any]:
         """
-
-        Retrieves information about a user specified by their username, optionally including additional fields and expansions, using the "GET" method with authentication.
-
+        Retrieves detailed information for a single user specified by their username, with options to include additional user, tweet, and expansion fields. This differs from `find_users_by_username`, which fetches data for multiple users in a single request.
+        
         Args:
             username (string): username
             user_fields (array): A comma separated list of User fields to display. Example: "['affiliation', 'connection_status', 'created_at', 'description', 'entities', 'id', 'location', 'most_recent_tweet_id', 'name', 'pinned_tweet_id', 'profile_banner_url', 'profile_image_url', 'protected', 'public_metrics', 'receives_your_dm', 'subscription_type', 'url', 'username', 'verified', 'verified_type', 'withheld']".
             expansions (array): A comma separated list of fields to expand. Example: "['affiliation.user_id', 'most_recent_tweet_id', 'pinned_tweet_id']".
             tweet_fields (array): A comma separated list of Tweet fields to display. Example: "['article', 'attachments', 'author_id', 'card_uri', 'context_annotations', 'conversation_id', 'created_at', 'edit_controls', 'edit_history_tweet_ids', 'entities', 'geo', 'id', 'in_reply_to_user_id', 'lang', 'non_public_metrics', 'note_tweet', 'organic_metrics', 'possibly_sensitive', 'promoted_metrics', 'public_metrics', 'referenced_tweets', 'reply_settings', 'scopes', 'source', 'text', 'username', 'withheld']".
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Users
         """
@@ -126,22 +123,21 @@ class UsersApi(APISegmentBase):
         self, partition, backfill_minutes=None, start_time=None, end_time=None
     ) -> Any:
         """
-
-        Streams compliance data for users using the "GET" method, supporting optional backfill minutes, start and end times, and requiring a partition parameter.
-
+        Streams real-time user compliance events, such as account deletions or suspensions, from a specified data partition. Allows for backfilling missed data after a disconnection and filtering the event stream by a specific time range for targeted data retrieval.
+        
         Args:
             partition (integer): The "partition" parameter is a required integer query parameter that determines which partition of the compliance stream data to retrieve.
             backfill_minutes (integer): Optional integer parameter to specify the number of minutes of missed data to recover after a disconnection; valid values are between 1 and 5 minutes.
             start_time (string): Optional start time in string format for filtering the compliance stream. Example: '2021-02-01T18:40:40.000Z'.
             end_time (string): Optional end time for filtering the compliance stream data, specified as a string. Example: '2021-02-01T18:40:40.000Z'.
-
+        
         Returns:
             Any: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Compliance
         """
@@ -160,25 +156,24 @@ class UsersApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def find_my_user(
+    def get_authenticated_user(
         self, user_fields=None, expansions=None, tweet_fields=None
     ) -> dict[str, Any]:
         """
-
-        Retrieves detailed information about the authenticated user, including optional expansions and fields for user and tweet data.
-
+        Retrieves detailed information about the authenticated user making the request. Optional parameters allow for customizing the returned user and tweet data fields and including expanded objects. This differs from other 'find' functions as it requires no ID or username.
+        
         Args:
             user_fields (array): A comma separated list of User fields to display. Example: "['affiliation', 'connection_status', 'created_at', 'description', 'entities', 'id', 'location', 'most_recent_tweet_id', 'name', 'pinned_tweet_id', 'profile_banner_url', 'profile_image_url', 'protected', 'public_metrics', 'receives_your_dm', 'subscription_type', 'url', 'username', 'verified', 'verified_type', 'withheld']".
             expansions (array): A comma separated list of fields to expand. Example: "['affiliation.user_id', 'most_recent_tweet_id', 'pinned_tweet_id']".
             tweet_fields (array): A comma separated list of Tweet fields to display. Example: "['article', 'attachments', 'author_id', 'card_uri', 'context_annotations', 'conversation_id', 'created_at', 'edit_controls', 'edit_history_tweet_ids', 'entities', 'geo', 'id', 'in_reply_to_user_id', 'lang', 'non_public_metrics', 'note_tweet', 'organic_metrics', 'possibly_sensitive', 'promoted_metrics', 'public_metrics', 'referenced_tweets', 'reply_settings', 'scopes', 'source', 'text', 'username', 'withheld']".
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Users
         """
@@ -196,7 +191,7 @@ class UsersApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def search_user_by_query(
+    def search_users_by_query(
         self,
         query,
         max_results=None,
@@ -206,9 +201,8 @@ class UsersApi(APISegmentBase):
         tweet_fields=None,
     ) -> dict[str, Any]:
         """
-
-        Searches for users using a query string, returning a list of matching users with optional fields for user details, expansions, and related tweet fields.
-
+        Searches for users matching a specific query string. Supports pagination and allows customizing the response by specifying which user, tweet, and expansion fields to include in the results, providing a flexible way to discover users.
+        
         Args:
             query (string): Search query to filter users based on specific criteria. Example: 'someXUser'.
             max_results (integer): Maximum number of results to return in the search query, with a default of 100.
@@ -216,14 +210,14 @@ class UsersApi(APISegmentBase):
             user_fields (array): A comma separated list of User fields to display. Example: "['affiliation', 'connection_status', 'created_at', 'description', 'entities', 'id', 'location', 'most_recent_tweet_id', 'name', 'pinned_tweet_id', 'profile_banner_url', 'profile_image_url', 'protected', 'public_metrics', 'receives_your_dm', 'subscription_type', 'url', 'username', 'verified', 'verified_type', 'withheld']".
             expansions (array): A comma separated list of fields to expand. Example: "['affiliation.user_id', 'most_recent_tweet_id', 'pinned_tweet_id']".
             tweet_fields (array): A comma separated list of Tweet fields to display. Example: "['article', 'attachments', 'author_id', 'card_uri', 'context_annotations', 'conversation_id', 'created_at', 'edit_controls', 'edit_history_tweet_ids', 'entities', 'geo', 'id', 'in_reply_to_user_id', 'lang', 'non_public_metrics', 'note_tweet', 'organic_metrics', 'possibly_sensitive', 'promoted_metrics', 'public_metrics', 'referenced_tweets', 'reply_settings', 'scopes', 'source', 'text', 'username', 'withheld']".
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Users
         """
@@ -248,22 +242,21 @@ class UsersApi(APISegmentBase):
         self, id, user_fields=None, expansions=None, tweet_fields=None
     ) -> dict[str, Any]:
         """
-
-        Retrieves information about a user specified by their ID, with optional parameters for specifying additional user fields, expansions, and tweet fields.
-
+        Retrieves detailed information for a single user specified by their unique ID. This function allows for response customization using optional fields and expansions. It differs from `find_users_by_id`, which fetches data for multiple users in a single request.
+        
         Args:
             id (string): id
             user_fields (array): A comma separated list of User fields to display. Example: "['affiliation', 'connection_status', 'created_at', 'description', 'entities', 'id', 'location', 'most_recent_tweet_id', 'name', 'pinned_tweet_id', 'profile_banner_url', 'profile_image_url', 'protected', 'public_metrics', 'receives_your_dm', 'subscription_type', 'url', 'username', 'verified', 'verified_type', 'withheld']".
             expansions (array): A comma separated list of fields to expand. Example: "['affiliation.user_id', 'most_recent_tweet_id', 'pinned_tweet_id']".
             tweet_fields (array): A comma separated list of Tweet fields to display. Example: "['article', 'attachments', 'author_id', 'card_uri', 'context_annotations', 'conversation_id', 'created_at', 'edit_controls', 'edit_history_tweet_ids', 'entities', 'geo', 'id', 'in_reply_to_user_id', 'lang', 'non_public_metrics', 'note_tweet', 'organic_metrics', 'possibly_sensitive', 'promoted_metrics', 'public_metrics', 'referenced_tweets', 'reply_settings', 'scopes', 'source', 'text', 'username', 'withheld']".
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Users
         """
@@ -283,7 +276,7 @@ class UsersApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def users_id_blocking(
+    def list_blocked_users(
         self,
         id,
         max_results=None,
@@ -293,9 +286,8 @@ class UsersApi(APISegmentBase):
         tweet_fields=None,
     ) -> dict[str, Any]:
         """
-
-        Retrieves a list of user objects that are blocked by the specified user ID, allowing for additional fields and expansions to be specified.
-
+        Retrieves a paginated list of users blocked by a specified user ID. The response can be customized by specifying additional fields for users, tweets, and expansions to tailor the returned data objects.
+        
         Args:
             id (string): id
             max_results (integer): Limits the number of user blocking records returned in the response, with no default value set and requiring an integer input.
@@ -303,14 +295,14 @@ class UsersApi(APISegmentBase):
             user_fields (array): A comma separated list of User fields to display. Example: "['affiliation', 'connection_status', 'created_at', 'description', 'entities', 'id', 'location', 'most_recent_tweet_id', 'name', 'pinned_tweet_id', 'profile_banner_url', 'profile_image_url', 'protected', 'public_metrics', 'receives_your_dm', 'subscription_type', 'url', 'username', 'verified', 'verified_type', 'withheld']".
             expansions (array): A comma separated list of fields to expand. Example: "['affiliation.user_id', 'most_recent_tweet_id', 'pinned_tweet_id']".
             tweet_fields (array): A comma separated list of Tweet fields to display. Example: "['article', 'attachments', 'author_id', 'card_uri', 'context_annotations', 'conversation_id', 'created_at', 'edit_controls', 'edit_history_tweet_ids', 'entities', 'geo', 'id', 'in_reply_to_user_id', 'lang', 'non_public_metrics', 'note_tweet', 'organic_metrics', 'possibly_sensitive', 'promoted_metrics', 'public_metrics', 'referenced_tweets', 'reply_settings', 'scopes', 'source', 'text', 'username', 'withheld']".
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Users
         """
@@ -332,7 +324,7 @@ class UsersApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def get_users_id_bookmarks(
+    def list_user_bookmarks(
         self,
         id,
         max_results=None,
@@ -345,9 +337,8 @@ class UsersApi(APISegmentBase):
         place_fields=None,
     ) -> dict[str, Any]:
         """
-
-        Retrieves a list of bookmarks for a user with the specified ID, allowing optional pagination and customization of returned fields.
-
+        Retrieves a paginated list of tweets bookmarked by a specified user. Allows extensive customization of the response data by specifying tweet, media, user, and place fields, as well as object expansions.
+        
         Args:
             id (string): id
             max_results (integer): The "max_results" parameter, an optional integer query parameter with a default value of 2, limits the number of bookmark results returned when retrieving a user's bookmarks via the GET operation at "/2/users/{id}/bookmarks".
@@ -358,14 +349,14 @@ class UsersApi(APISegmentBase):
             poll_fields (array): A comma separated list of Poll fields to display. Example: "['duration_minutes', 'end_datetime', 'id', 'options', 'voting_status']".
             user_fields (array): A comma separated list of User fields to display. Example: "['affiliation', 'connection_status', 'created_at', 'description', 'entities', 'id', 'location', 'most_recent_tweet_id', 'name', 'pinned_tweet_id', 'profile_banner_url', 'profile_image_url', 'protected', 'public_metrics', 'receives_your_dm', 'subscription_type', 'url', 'username', 'verified', 'verified_type', 'withheld']".
             place_fields (array): A comma separated list of Place fields to display. Example: "['contained_within', 'country', 'country_code', 'full_name', 'geo', 'id', 'name', 'place_type']".
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Bookmarks
         """
@@ -390,22 +381,21 @@ class UsersApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def post_users_id_bookmarks(self, id, tweet_id) -> dict[str, Any]:
+    def bookmark_tweet(self, id, tweet_id) -> dict[str, Any]:
         """
-
-        Adds bookmarks for a specified user using the provided JSON data and returns a successful response upon completion.
-
+        Bookmarks a specific tweet for a user. This action adds the tweet, identified by `tweet_id`, to the bookmarks of the user specified by their unique `id`, making a POST request to the bookmarks endpoint.
+        
         Args:
             id (string): id
             tweet_id (string): Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers. Example: '1346889436626259968'.
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Bookmarks
         """
@@ -427,22 +417,21 @@ class UsersApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def users_id_bookmarks_delete(self, id, tweet_id) -> dict[str, Any]:
+    def remove_bookmark(self, id, tweet_id) -> dict[str, Any]:
         """
-
-        Deletes a bookmarked tweet for a specified user using the "DELETE" method.
-
+        Deletes a bookmarked tweet for a specified user. This action requires both the user's ID and the tweet's ID to target the correct bookmark for removal via an API DELETE request. It is the inverse of `post_users_id_bookmarks`.
+        
         Args:
             id (string): id
             tweet_id (string): tweet_id
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Bookmarks
         """
@@ -456,7 +445,7 @@ class UsersApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def user_followed_lists(
+    def get_user_followed_lists(
         self,
         id,
         max_results=None,
@@ -466,9 +455,8 @@ class UsersApi(APISegmentBase):
         user_fields=None,
     ) -> dict[str, Any]:
         """
-
-        Retrieves a list of Twitter lists followed by a specified user, with optional parameters for pagination, list fields, and user fields.
-
+        Retrieves a paginated list of Twitter Lists that a specified user follows. Identified by user ID, this function allows response customization with optional parameters for pagination, expansions, and specific list or user fields to include in the results.
+        
         Args:
             id (string): id
             max_results (integer): Specifies the maximum number of followed lists to return per page, with a default value of 100.
@@ -476,14 +464,14 @@ class UsersApi(APISegmentBase):
             list_fields (array): A comma separated list of List fields to display. Example: "['created_at', 'description', 'follower_count', 'id', 'member_count', 'name', 'owner_id', 'private']".
             expansions (array): A comma separated list of fields to expand. Example: "['owner_id']".
             user_fields (array): A comma separated list of User fields to display. Example: "['affiliation', 'connection_status', 'created_at', 'description', 'entities', 'id', 'location', 'most_recent_tweet_id', 'name', 'pinned_tweet_id', 'profile_banner_url', 'profile_image_url', 'protected', 'public_metrics', 'receives_your_dm', 'subscription_type', 'url', 'username', 'verified', 'verified_type', 'withheld']".
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Lists
         """
@@ -505,22 +493,21 @@ class UsersApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def list_user_follow(self, id, list_id=None) -> dict[str, Any]:
+    def follow_list(self, id, list_id=None) -> dict[str, Any]:
         """
-
-        Adds a Twitter user to a list of followed lists using the Twitter API and returns a status message.
-
+        Causes a specified user to follow a particular Twitter List. It sends a POST request to the `/users/{id}/followed_lists` endpoint with the list's ID. This contrasts with `user_followed_lists`, which retrieves the lists a user already follows, and `list_user_unfollow`, which removes a list.
+        
         Args:
             id (string): id
             list_id (string): The unique identifier of this List. Example: '1146654567674912769'.
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Lists
         """
@@ -542,22 +529,21 @@ class UsersApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def list_user_unfollow(self, id, list_id) -> dict[str, Any]:
+    def unfollow_list(self, id, list_id) -> dict[str, Any]:
         """
-
-        Deletes the specified list followed by the user identified by the given user ID and list ID.
-
+        Causes a user, specified by their ID, to unfollow a particular Twitter List, identified by its list ID. This action sends a DELETE request to the API, removing the follow relationship between the user and the list.
+        
         Args:
             id (string): id
             list_id (string): list_id
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Lists
         """
@@ -571,7 +557,7 @@ class UsersApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def users_id_followers(
+    def get_user_followers(
         self,
         id,
         max_results=None,
@@ -581,9 +567,8 @@ class UsersApi(APISegmentBase):
         tweet_fields=None,
     ) -> dict[str, Any]:
         """
-
-        Retrieves a list of users who follow a specified user using the Twitter API, with optional parameters for result pagination and additional user or tweet fields.
-
+        Fetches a paginated list of users who follow a specified user ID. The response can be customized with optional parameters to control the number of results, expand related objects, and specify which user or tweet fields to return.
+        
         Args:
             id (string): id
             max_results (integer): The maximum number of follower results to return in the response.
@@ -591,14 +576,14 @@ class UsersApi(APISegmentBase):
             user_fields (array): A comma separated list of User fields to display. Example: "['affiliation', 'connection_status', 'created_at', 'description', 'entities', 'id', 'location', 'most_recent_tweet_id', 'name', 'pinned_tweet_id', 'profile_banner_url', 'profile_image_url', 'protected', 'public_metrics', 'receives_your_dm', 'subscription_type', 'url', 'username', 'verified', 'verified_type', 'withheld']".
             expansions (array): A comma separated list of fields to expand. Example: "['affiliation.user_id', 'most_recent_tweet_id', 'pinned_tweet_id']".
             tweet_fields (array): A comma separated list of Tweet fields to display. Example: "['article', 'attachments', 'author_id', 'card_uri', 'context_annotations', 'conversation_id', 'created_at', 'edit_controls', 'edit_history_tweet_ids', 'entities', 'geo', 'id', 'in_reply_to_user_id', 'lang', 'non_public_metrics', 'note_tweet', 'organic_metrics', 'possibly_sensitive', 'promoted_metrics', 'public_metrics', 'referenced_tweets', 'reply_settings', 'scopes', 'source', 'text', 'username', 'withheld']".
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Users
         """
@@ -620,7 +605,7 @@ class UsersApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def users_id_following(
+    def get_following_by_user_id(
         self,
         id,
         max_results=None,
@@ -630,9 +615,8 @@ class UsersApi(APISegmentBase):
         tweet_fields=None,
     ) -> dict[str, Any]:
         """
-
-        Retrieves a list of users followed by the specified user ID, allowing optional parameters to customize the response with additional user fields, expansions, and tweet fields.
-
+        Retrieves a paginated list of users followed by a specific user ID. The response can be customized by requesting additional user fields, tweet fields, and data expansions to include more detailed information about the followed accounts.
+        
         Args:
             id (string): id
             max_results (integer): Optional parameter to limit the number of results returned in the response for the GET operation at "/2/users/{id}/following", specified as an integer.
@@ -640,14 +624,14 @@ class UsersApi(APISegmentBase):
             user_fields (array): A comma separated list of User fields to display. Example: "['affiliation', 'connection_status', 'created_at', 'description', 'entities', 'id', 'location', 'most_recent_tweet_id', 'name', 'pinned_tweet_id', 'profile_banner_url', 'profile_image_url', 'protected', 'public_metrics', 'receives_your_dm', 'subscription_type', 'url', 'username', 'verified', 'verified_type', 'withheld']".
             expansions (array): A comma separated list of fields to expand. Example: "['affiliation.user_id', 'most_recent_tweet_id', 'pinned_tweet_id']".
             tweet_fields (array): A comma separated list of Tweet fields to display. Example: "['article', 'attachments', 'author_id', 'card_uri', 'context_annotations', 'conversation_id', 'created_at', 'edit_controls', 'edit_history_tweet_ids', 'entities', 'geo', 'id', 'in_reply_to_user_id', 'lang', 'non_public_metrics', 'note_tweet', 'organic_metrics', 'possibly_sensitive', 'promoted_metrics', 'public_metrics', 'referenced_tweets', 'reply_settings', 'scopes', 'source', 'text', 'username', 'withheld']".
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Users
         """
@@ -669,22 +653,21 @@ class UsersApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def users_id_follow(self, id, target_user_id=None) -> dict[str, Any]:
+    def follow_user(self, id, target_user_id=None) -> dict[str, Any]:
         """
-
-        Follows another user on behalf of the current user using the Twitter API, returning a status message indicating whether the action was successful.
-
+        Causes a source user, specified by `id`, to follow a target user (`target_user_id`). It sends a POST request to the `/2/users/{id}/following` endpoint to create the follow relationship, distinct from `users_id_following` which retrieves a list of followed users.
+        
         Args:
             id (string): id
             target_user_id (string): Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers. Example: '2244994945'.
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Users
         """
@@ -706,7 +689,7 @@ class UsersApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def users_id_liked_tweets(
+    def get_liked_tweets_by_user(
         self,
         id,
         max_results=None,
@@ -719,9 +702,8 @@ class UsersApi(APISegmentBase):
         place_fields=None,
     ) -> dict[str, Any]:
         """
-
-        Retrieves a list of tweets liked by the specified user, supporting pagination and optional expansions and fields for tweets, users, media, polls, and places.
-
+        Fetches a list of tweets liked by a specified user ID. This function supports pagination and allows for extensive customization of the returned data, including expansions and specific fields for tweets, media, users, polls, and places.
+        
         Args:
             id (string): id
             max_results (integer): Optional integer parameter to limit the number of liked tweets returned in the response.
@@ -732,14 +714,14 @@ class UsersApi(APISegmentBase):
             poll_fields (array): A comma separated list of Poll fields to display. Example: "['duration_minutes', 'end_datetime', 'id', 'options', 'voting_status']".
             user_fields (array): A comma separated list of User fields to display. Example: "['affiliation', 'connection_status', 'created_at', 'description', 'entities', 'id', 'location', 'most_recent_tweet_id', 'name', 'pinned_tweet_id', 'profile_banner_url', 'profile_image_url', 'protected', 'public_metrics', 'receives_your_dm', 'subscription_type', 'url', 'username', 'verified', 'verified_type', 'withheld']".
             place_fields (array): A comma separated list of Place fields to display. Example: "['contained_within', 'country', 'country_code', 'full_name', 'geo', 'id', 'name', 'place_type']".
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Tweets
         """
@@ -764,22 +746,21 @@ class UsersApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def users_id_like(self, id, tweet_id=None) -> dict[str, Any]:
+    def like_tweet(self, id, tweet_id=None) -> dict[str, Any]:
         """
-
-        Creates a new like for a user's content using the provided user ID and returns a status message.
-
+        Causes a user, specified by `id`, to like a tweet, specified by `tweet_id`. This function sends a POST request to add a like, contrasting with `users_id_unlike` which removes a like and `users_id_liked_tweets` which retrieves a list of liked tweets.
+        
         Args:
             id (string): id
             tweet_id (string): Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers. Example: '1346889436626259968'.
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Tweets
         """
@@ -801,22 +782,21 @@ class UsersApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def users_id_unlike(self, id, tweet_id) -> dict[str, Any]:
+    def unlike_tweet(self, id, tweet_id) -> dict[str, Any]:
         """
-
-        Deletes a user's like on a specific tweet using the provided user ID and tweet ID, requiring OAuth2UserToken with "like.write," "tweet.read," and "users.read" permissions.
-
+        Removes a like from a tweet on behalf of an authenticated user. This function identifies the specific like to be deleted using the user's ID and the tweet's ID, then sends a corresponding DELETE request to the Twitter API.
+        
         Args:
             id (string): id
             tweet_id (string): tweet_id
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Tweets
         """
@@ -840,9 +820,8 @@ class UsersApi(APISegmentBase):
         user_fields=None,
     ) -> dict[str, Any]:
         """
-
-        Retrieves a list of memberships for a specified user using their ID, allowing for optional filtering by maximum results and pagination, and returns the membership details.
-
+        Retrieves all Twitter Lists of which a specific user is a member. Supports pagination and allows for response customization by specifying which list fields, user fields, and expansions to return, differentiating it from functions that get followed, owned, or pinned lists.
+        
         Args:
             id (string): id
             max_results (integer): The maximum number of membership results to return, defaulting to 100 if not specified.
@@ -850,14 +829,14 @@ class UsersApi(APISegmentBase):
             list_fields (array): A comma separated list of List fields to display. Example: "['created_at', 'description', 'follower_count', 'id', 'member_count', 'name', 'owner_id', 'private']".
             expansions (array): A comma separated list of fields to expand. Example: "['owner_id']".
             user_fields (array): A comma separated list of User fields to display. Example: "['affiliation', 'connection_status', 'created_at', 'description', 'entities', 'id', 'location', 'most_recent_tweet_id', 'name', 'pinned_tweet_id', 'profile_banner_url', 'profile_image_url', 'protected', 'public_metrics', 'receives_your_dm', 'subscription_type', 'url', 'username', 'verified', 'verified_type', 'withheld']".
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Lists
         """
@@ -879,7 +858,7 @@ class UsersApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def users_id_mentions(
+    def get_user_mentions(
         self,
         id,
         since_id=None,
@@ -896,9 +875,8 @@ class UsersApi(APISegmentBase):
         place_fields=None,
     ) -> dict[str, Any]:
         """
-
-        Retrieves the timeline of tweets that mention the user associated with the provided ID, allowing for customization with parameters such as since and until IDs, pagination tokens, and various field expansions.
-
+        Retrieves a timeline of tweets mentioning a specified user, identified by their ID. Allows for pagination and filtering by time or tweet ID, with options to customize the returned data fields for tweets, users, media, and other entities.
+        
         Args:
             id (string): id
             since_id (string): Optional parameter to return results with an ID greater than (i.e., more recent than) the specified ID. Example: '1346889436626259968'.
@@ -913,14 +891,14 @@ class UsersApi(APISegmentBase):
             poll_fields (array): A comma separated list of Poll fields to display. Example: "['duration_minutes', 'end_datetime', 'id', 'options', 'voting_status']".
             user_fields (array): A comma separated list of User fields to display. Example: "['affiliation', 'connection_status', 'created_at', 'description', 'entities', 'id', 'location', 'most_recent_tweet_id', 'name', 'pinned_tweet_id', 'profile_banner_url', 'profile_image_url', 'protected', 'public_metrics', 'receives_your_dm', 'subscription_type', 'url', 'username', 'verified', 'verified_type', 'withheld']".
             place_fields (array): A comma separated list of Place fields to display. Example: "['contained_within', 'country', 'country_code', 'full_name', 'geo', 'id', 'name', 'place_type']".
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Tweets
         """
@@ -949,7 +927,7 @@ class UsersApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def users_id_muting(
+    def get_muted_users(
         self,
         id,
         max_results=None,
@@ -959,9 +937,8 @@ class UsersApi(APISegmentBase):
         tweet_fields=None,
     ) -> dict[str, Any]:
         """
-
-        Retrieves a list of users muted by the specified user using the Twitter API with optional filtering by max results, pagination token, user fields, user expansions, tweet fields, and returns the response upon authorization with the required "mute.read," "tweet.read," and "users.read" scopes.
-
+        Retrieves a list of users muted by a specific user, identified by ID. Supports pagination and allows for customizing the returned data, including user fields, expansions, and tweet fields, to tailor the response.
+        
         Args:
             id (string): id
             max_results (integer): The "max_results" parameter limits the number of results returned in the response for the GET operation at "/2/users/{id}/muting", with a default value of 100.
@@ -969,14 +946,14 @@ class UsersApi(APISegmentBase):
             user_fields (array): A comma separated list of User fields to display. Example: "['affiliation', 'connection_status', 'created_at', 'description', 'entities', 'id', 'location', 'most_recent_tweet_id', 'name', 'pinned_tweet_id', 'profile_banner_url', 'profile_image_url', 'protected', 'public_metrics', 'receives_your_dm', 'subscription_type', 'url', 'username', 'verified', 'verified_type', 'withheld']".
             expansions (array): A comma separated list of fields to expand. Example: "['affiliation.user_id', 'most_recent_tweet_id', 'pinned_tweet_id']".
             tweet_fields (array): A comma separated list of Tweet fields to display. Example: "['article', 'attachments', 'author_id', 'card_uri', 'context_annotations', 'conversation_id', 'created_at', 'edit_controls', 'edit_history_tweet_ids', 'entities', 'geo', 'id', 'in_reply_to_user_id', 'lang', 'non_public_metrics', 'note_tweet', 'organic_metrics', 'possibly_sensitive', 'promoted_metrics', 'public_metrics', 'referenced_tweets', 'reply_settings', 'scopes', 'source', 'text', 'username', 'withheld']".
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Users
         """
@@ -998,22 +975,21 @@ class UsersApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def users_id_mute(self, id, target_user_id=None) -> dict[str, Any]:
+    def mute_user(self, id, target_user_id=None) -> dict[str, Any]:
         """
-
-        Mutes a user identified by their ID using the API, requiring a POST request with appropriate OAuth2 credentials.
-
+        Mutes a target user on behalf of an authenticated user. This action requires the authenticated user's ID and the target user's ID. It differs from `users_id_unmute` (which unmutes) and `users_id_muting` (which lists muted users) by performing the actual mute operation via POST request.
+        
         Args:
             id (string): id
             target_user_id (string): Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers. Example: '2244994945'.
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Users
         """
@@ -1035,7 +1011,7 @@ class UsersApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def list_user_owned_lists(
+    def get_user_owned_lists(
         self,
         id,
         max_results=None,
@@ -1045,9 +1021,8 @@ class UsersApi(APISegmentBase):
         user_fields=None,
     ) -> dict[str, Any]:
         """
-
-        Retrieves a list of Twitter Lists owned by the specified user, supporting optional pagination and field expansions.
-
+        Retrieves all Twitter Lists owned by a specified user ID. Supports pagination and custom data fields for detailed results. This function fetches lists created by the user, distinguishing it from methods that retrieve lists the user follows (`user_followed_lists`) or has pinned (`list_user_pinned_lists`).
+        
         Args:
             id (string): id
             max_results (integer): Maximum number of owned lists to return in the response; defaults to 100 if not specified.
@@ -1055,14 +1030,14 @@ class UsersApi(APISegmentBase):
             list_fields (array): A comma separated list of List fields to display. Example: "['created_at', 'description', 'follower_count', 'id', 'member_count', 'name', 'owner_id', 'private']".
             expansions (array): A comma separated list of fields to expand. Example: "['owner_id']".
             user_fields (array): A comma separated list of User fields to display. Example: "['affiliation', 'connection_status', 'created_at', 'description', 'entities', 'id', 'location', 'most_recent_tweet_id', 'name', 'pinned_tweet_id', 'profile_banner_url', 'profile_image_url', 'protected', 'public_metrics', 'receives_your_dm', 'subscription_type', 'url', 'username', 'verified', 'verified_type', 'withheld']".
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Lists
         """
@@ -1084,26 +1059,25 @@ class UsersApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def list_user_pinned_lists(
+    def get_user_pinned_lists(
         self, id, list_fields=None, expansions=None, user_fields=None
     ) -> dict[str, Any]:
         """
-
-        Retrieves the pinned Lists of a specified user by their user ID, returning detailed information about each pinned List.
-
+        Retrieves the collection of lists pinned by a specific user, identified by their ID. Optional parameters allow for customizing the returned list and user data fields, and including expansions. This is distinct from fetching lists a user follows or owns.
+        
         Args:
             id (string): id
             list_fields (array): A comma separated list of List fields to display. Example: "['created_at', 'description', 'follower_count', 'id', 'member_count', 'name', 'owner_id', 'private']".
             expansions (array): A comma separated list of fields to expand. Example: "['owner_id']".
             user_fields (array): A comma separated list of User fields to display. Example: "['affiliation', 'connection_status', 'created_at', 'description', 'entities', 'id', 'location', 'most_recent_tweet_id', 'name', 'pinned_tweet_id', 'profile_banner_url', 'profile_image_url', 'protected', 'public_metrics', 'receives_your_dm', 'subscription_type', 'url', 'username', 'verified', 'verified_type', 'withheld']".
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Lists
         """
@@ -1123,22 +1097,21 @@ class UsersApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def list_user_pin(self, id, list_id) -> dict[str, Any]:
+    def pin_list(self, id, list_id) -> dict[str, Any]:
         """
-
-        Creates a pinned list for a user identified by {id} using JSON data and OAuth2UserToken or UserToken authentication.
-
+        Pins a specified list to a user's profile via a POST request, using the user and list IDs. This creates a new pin, differing from `list_user_unpin` which removes a pin and `list_user_pinned_lists` which retrieves all of a user's currently pinned lists.
+        
         Args:
             id (string): id
             list_id (string): The unique identifier of this List. Example: '1146654567674912769'.
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Lists
         """
@@ -1160,22 +1133,21 @@ class UsersApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def list_user_unpin(self, id, list_id) -> dict[str, Any]:
+    def unpin_list(self, id, list_id) -> dict[str, Any]:
         """
-
-        Deletes a specified pinned list from a user's account by user ID and list ID.
-
+        Unpins a specific list from a user's profile, identified by their user ID and the list's ID. This action sends a DELETE request to the API, removing the specified list from the user's collection of pinned lists.
+        
         Args:
             id (string): id
             list_id (string): list_id
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Lists
         """
@@ -1189,22 +1161,21 @@ class UsersApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def users_id_retweets(self, id, tweet_id=None) -> dict[str, Any]:
+    def create_retweet(self, id, tweet_id=None) -> dict[str, Any]:
         """
-
-        Retweets a post using the X API on behalf of a specified user, requiring authentication with OAuth2UserToken and appropriate permissions.
-
+        Causes a user, identified by `id`, to retweet a specific tweet. This action sends a POST request to the `/2/users/{id}/retweets` endpoint, requiring the `tweet_id` of the tweet to be retweeted. It is the opposite of the `users_id_unretweets` function, which deletes a retweet.
+        
         Args:
             id (string): id
             tweet_id (string): Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers. Example: '1346889436626259968'.
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Tweets
         """
@@ -1226,22 +1197,21 @@ class UsersApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def users_id_unretweets(self, id, source_tweet_id) -> dict[str, Any]:
+    def delete_retweet(self, id, source_tweet_id) -> dict[str, Any]:
         """
-
-        Undoes a retweet of a specified tweet by a user using the Twitter API v2, requiring OAuth authentication and user permissions.
-
+        Removes a retweet for a specified user by sending a DELETE request to the Twitter API. It requires the user's ID and the ID of the original tweet that was retweeted to successfully undo the action.
+        
         Args:
             id (string): id
             source_tweet_id (string): source_tweet_id
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Tweets
         """
@@ -1255,7 +1225,7 @@ class UsersApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def users_id_timeline(
+    def get_user_tweet_timeline(
         self,
         id,
         since_id=None,
@@ -1273,9 +1243,8 @@ class UsersApi(APISegmentBase):
         place_fields=None,
     ) -> dict[str, Any]:
         """
-
-        Retrieves a user's reverse chronological timeline, returning tweets in the order they were posted, with optional filtering by time range, tweet IDs, and additional metadata fields.
-
+        Retrieves tweets from a user's timeline in reverse chronological order. Supports filtering by time or tweet ID, pagination, and excluding replies or retweets. Optional parameters allow for expanding returned data with additional tweet, user, and media fields.
+        
         Args:
             id (string): id
             since_id (string): The `since_id` parameter specifies the smallest ID of the statuses to be returned, retrieving the newest statuses first, but it may not return all statuses if there are too many between the newest and the specified ID. Example: '791775337160081409'.
@@ -1291,14 +1260,14 @@ class UsersApi(APISegmentBase):
             poll_fields (array): A comma separated list of Poll fields to display. Example: "['duration_minutes', 'end_datetime', 'id', 'options', 'voting_status']".
             user_fields (array): A comma separated list of User fields to display. Example: "['affiliation', 'connection_status', 'created_at', 'description', 'entities', 'id', 'location', 'most_recent_tweet_id', 'name', 'pinned_tweet_id', 'profile_banner_url', 'profile_image_url', 'protected', 'public_metrics', 'receives_your_dm', 'subscription_type', 'url', 'username', 'verified', 'verified_type', 'withheld']".
             place_fields (array): A comma separated list of Place fields to display. Example: "['contained_within', 'country', 'country_code', 'full_name', 'geo', 'id', 'name', 'place_type']".
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Tweets
         """
@@ -1328,7 +1297,7 @@ class UsersApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def users_id_tweets(
+    def get_tweets_by_user_id(
         self,
         id,
         since_id=None,
@@ -1346,9 +1315,8 @@ class UsersApi(APISegmentBase):
         place_fields=None,
     ) -> dict[str, Any]:
         """
-
-        Retrieves a list of tweets for a user with the specified ID, allowing optional filtering by tweet ID range, result count, pagination token, excluded fields, and time range, using the "GET" method.
-
+        Retrieves tweets authored by a specific user, identified by their ID. Supports pagination and filtering by time range, allowing response customization to exclude replies or retweets. This fetches tweets composed by the user, unlike the more general `users_id_timeline` function which includes retweets.
+        
         Args:
             id (string): id
             since_id (string): Returns only Tweets with IDs greater than (more recent than) the specified ID, allowing retrieval of Tweets posted after that ID. Example: '791775337160081409'.
@@ -1364,14 +1332,14 @@ class UsersApi(APISegmentBase):
             poll_fields (array): A comma separated list of Poll fields to display. Example: "['duration_minutes', 'end_datetime', 'id', 'options', 'voting_status']".
             user_fields (array): A comma separated list of User fields to display. Example: "['affiliation', 'connection_status', 'created_at', 'description', 'entities', 'id', 'location', 'most_recent_tweet_id', 'name', 'pinned_tweet_id', 'profile_banner_url', 'profile_image_url', 'protected', 'public_metrics', 'receives_your_dm', 'subscription_type', 'url', 'username', 'verified', 'verified_type', 'withheld']".
             place_fields (array): A comma separated list of Place fields to display. Example: "['contained_within', 'country', 'country_code', 'full_name', 'geo', 'id', 'name', 'place_type']".
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Tweets
         """
@@ -1401,22 +1369,21 @@ class UsersApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def users_id_unfollow(self, source_user_id, target_user_id) -> dict[str, Any]:
+    def unfollow_user(self, source_user_id, target_user_id) -> dict[str, Any]:
         """
-
-        Unfollows a target user by deleting the follow relationship between the source user and the target user using the "DELETE" method.
-
+        Causes a specified user (`source_user_id`) to unfollow another user (`target_user_id`). This function sends a DELETE API request to remove the follow relationship, requiring both user IDs to successfully complete the action.
+        
         Args:
             source_user_id (string): source_user_id
             target_user_id (string): target_user_id
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Users
         """
@@ -1430,22 +1397,21 @@ class UsersApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def users_id_unmute(self, source_user_id, target_user_id) -> dict[str, Any]:
+    def unmute_user(self, source_user_id, target_user_id) -> dict[str, Any]:
         """
-
-        Unmutes a target user using the "DELETE" method on the "/2/users/{source_user_id}/muting/{target_user_id}" path, reversing the mute action applied by the source user to the target user.
-
+        Allows an authenticated user (source) to unmute another user (target). This action removes the specified target user from the source user's mute list, reversing a previous mute action.
+        
         Args:
             source_user_id (string): source_user_id
             target_user_id (string): target_user_id
-
+        
         Returns:
             dict[str, Any]: The request has succeeded.
-
+        
         Raises:
             HTTPError: Raised when the API request fails (e.g., non-2XX status code).
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
-
+        
         Tags:
             Users
         """
@@ -1461,38 +1427,38 @@ class UsersApi(APISegmentBase):
 
     def list_tools(self):
         return [
-            self.find_users_by_id,
-            self.find_users_by_username,
+            self.get_users_by_ids,
+            self.get_users_by_usernames,
             self.find_user_by_username,
             self.get_users_compliance_stream,
-            self.find_my_user,
-            self.search_user_by_query,
+            self.get_authenticated_user,
+            self.search_users_by_query,
             self.find_user_by_id,
-            self.users_id_blocking,
-            self.get_users_id_bookmarks,
-            self.post_users_id_bookmarks,
-            self.users_id_bookmarks_delete,
-            self.user_followed_lists,
-            self.list_user_follow,
-            self.list_user_unfollow,
-            self.users_id_followers,
-            self.users_id_following,
-            self.users_id_follow,
-            self.users_id_liked_tweets,
-            self.users_id_like,
-            self.users_id_unlike,
+            self.list_blocked_users,
+            self.list_user_bookmarks,
+            self.bookmark_tweet,
+            self.remove_bookmark,
+            self.get_user_followed_lists,
+            self.follow_list,
+            self.unfollow_list,
+            self.get_user_followers,
+            self.get_following_by_user_id,
+            self.follow_user,
+            self.get_liked_tweets_by_user,
+            self.like_tweet,
+            self.unlike_tweet,
             self.get_user_list_memberships,
-            self.users_id_mentions,
-            self.users_id_muting,
-            self.users_id_mute,
-            self.list_user_owned_lists,
-            self.list_user_pinned_lists,
-            self.list_user_pin,
-            self.list_user_unpin,
-            self.users_id_retweets,
-            self.users_id_unretweets,
-            self.users_id_timeline,
-            self.users_id_tweets,
-            self.users_id_unfollow,
-            self.users_id_unmute,
+            self.get_user_mentions,
+            self.get_muted_users,
+            self.mute_user,
+            self.get_user_owned_lists,
+            self.get_user_pinned_lists,
+            self.pin_list,
+            self.unpin_list,
+            self.create_retweet,
+            self.delete_retweet,
+            self.get_user_tweet_timeline,
+            self.get_tweets_by_user_id,
+            self.unfollow_user,
+            self.unmute_user,
         ]