universal-mcp-applications 0.1.21__py3-none-any.whl → 0.1.22__py3-none-any.whl

universal_mcp/applications/slack/app.py

@@ -17,18 +17,18 @@ class SlackApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Deletes a specific message from a Slack channel. It identifies the message using its channel ID and timestamp (`ts`). This function is distinct from `chat_update` which modifies a message, and `chat_post_message` which sends a new one.
-        
+
         Args:
             as_user (boolean): Pass true to delete the message as the authed user with `chat:write:user` scope. [Bot users](https://slack.dev) in this context are considered authed users. If unused or false, the message will be deleted with `chat:write:bot` scope.
             channel (string): Channel containing the message to be deleted.
             ts (number): Timestamp of the message to be deleted.
-        
+
         Returns:
             dict[str, Any]: Typical success response
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             chat
         """
@@ -71,7 +71,7 @@ class SlackApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Posts a new message to a specified Slack channel. It supports rich content formats like text, attachments, and blocks, along with options for threading and authorship. This function creates new messages, unlike `chat_update` which modifies existing ones or `chat_delete` which removes them.
-        
+
         Args:
             as_user (boolean): Pass true to post the message as the authed user, instead of as a bot. Defaults to false. See [authorship](https://slack.dev) below.
             attachments (string): A JSON-based array of structured attachments, presented as a URL-encoded string.
@@ -88,13 +88,13 @@ class SlackApp(APIApplication):
             unfurl_links (boolean): Pass true to enable unfurling of primarily text-based content.
             unfurl_media (boolean): Pass false to disable unfurling of media content.
             username (string): Set your bot's user name. Must be used in conjunction with `as_user` set to false, otherwise ignored. See [authorship](https://slack.dev) below.
-        
+
         Returns:
             dict[str, Any]: Typical success response
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             chat
         """
@@ -142,7 +142,7 @@ class SlackApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Updates a specific, existing message in a Slack channel, identified by its timestamp. It modifies content such as text, blocks, or attachments by calling the `chat.update` API endpoint, distinguishing it from functions that create (`chat_post_message`) or delete (`chat_delete`) messages.
-        
+
         Args:
             as_user (string): Pass true to update the message as the authed user. [Bot users](https://slack.dev) in this context are considered authed users.
             attachments (string): A JSON-based array of structured attachments, presented as a URL-encoded string. This field is required when not presenting `text`. If you don't include this field, the message's previous `attachments` will be retained. To remove previous `attachments`, include an empty array for this field.
@@ -152,13 +152,13 @@ class SlackApp(APIApplication):
             parse (string): Change how messages are treated. Defaults to `client`, unlike `chat.postMessage`. Accepts either `none` or `full`. If you do not specify a value for this field, the original value set for the message will be overwritten with the default, `client`.
             text (string): New text for the message, using the [default formatting rules](https://slack.dev). It's not required when presenting `blocks` or `attachments`.
             ts (string): Timestamp of the message to be updated.
-        
+
         Returns:
             dict[str, Any]: Typical success response
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             chat, important
         """
@@ -198,7 +198,7 @@ class SlackApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Fetches the message history for a specific Slack conversation or channel. Supports filtering messages by timestamp and pagination using a cursor. This method retrieves messages *within* a conversation, unlike `conversations_list` which retrieves a list of available conversations.
-        
+
         Args:
             token (string): Authentication token used to access conversation history.
             channel (string): The ID of the channel to retrieve the conversation history from.
@@ -207,13 +207,13 @@ class SlackApp(APIApplication):
             inclusive (boolean): Determines whether to include the messages at the end of the history range in the response.
             limit (integer): Specifies the maximum number of conversation history entries to retrieve in a single API call.
             cursor (string): A string token used for cursor-based pagination to fetch the next set of conversation history results starting from a specific point.
-        
+
         Returns:
             dict[str, Any]: Typical success response containing a channel's messages
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             conversations
         """
@@ -244,20 +244,20 @@ class SlackApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Fetches a paginated list of channel-like conversations in a workspace. Allows filtering by type and excluding archived channels. This function lists available conversations, unlike `conversations_history` which retrieves the message history from within a specific conversation.
-        
+
         Args:
             token (string): The token parameter in the query string is a string used for authentication to authorize and identify the client making the GET request to the /conversations.list endpoint.
             exclude_archived (boolean): Exclude archived conversations from the list of results.
             types (string): Specifies the types of conversations to include in the list, as a string query parameter.
             limit (integer): Specifies the maximum number of conversations to return in the response, with a default value of 1.
             cursor (string): A cursor string used for pagination to specify the position from which to continue retrieving the next set of conversation results.
-        
+
         Returns:
             dict[str, Any]: Typical success response with only public channels
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             conversations
         """
@@ -279,18 +279,18 @@ class SlackApp(APIApplication):
     def reactions_add(self, channel: str, name: str, timestamp: str) -> dict[str, Any]:
         """
         Adds a specific emoji reaction to a message in a Slack channel, identifying the message by its channel ID and timestamp. This method creates a new reaction, unlike `reactions_get` or `reactions_list` which retrieve existing reaction data for items or users.
-        
+
         Args:
             channel (string): Channel where the message to add reaction to was posted.
             name (string): Reaction (emoji) name.
             timestamp (string): Timestamp of the message to add reaction to.
-        
+
         Returns:
             dict[str, Any]: Typical success response
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             reactions
         """
@@ -324,7 +324,7 @@ class SlackApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Retrieves all reactions for a single item, such as a message, file, or file comment. This function targets reactions *on* a specific item, unlike `reactions_list` which gets reactions created *by* a user.
-        
+
         Args:
             token (string): The "token" parameter is a required string that must be provided in the query string for authentication purposes when using the GET operation at "/reactions.get" to authorize access to reaction data.
             channel (string): The channel identifier to filter reactions by, specified as a string.
@@ -332,13 +332,13 @@ class SlackApp(APIApplication):
             file_comment (string): A query parameter to filter reactions by a specific file comment.
             full (boolean): Whether to return full reaction details or only basic reaction information.
             timestamp (string): The timestamp parameter filters results based on a specific date and time value, expected in an ISO 8601 format string.
-        
+
         Returns:
             dict[str, Any]: Typical success response
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             reactions
         """
@@ -370,7 +370,7 @@ class SlackApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Retrieves a paginated list of items (e.g., messages, files) that a specific user has reacted to. Unlike `reactions_get`, which fetches all reactions for a single item, this function lists all items a given user has reacted to across Slack.
-        
+
         Args:
             token (string): Required authentication token passed as a query parameter to authenticate the request for listing reactions.
             user (string): Filter reactions by specifying the user, which can be a username or identifier.
@@ -379,13 +379,13 @@ class SlackApp(APIApplication):
             page (integer): The "page" parameter is an integer query parameter used to specify the page number for pagination in the list of reactions.
             cursor (string): A string used to specify the position in the list of reactions for pagination, allowing retrieval of additional items after or before the specified cursor.
             limit (integer): The `limit` parameter specifies the maximum number of reactions to return in the response.
-        
+
         Returns:
             dict[str, Any]: Typical success response
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             reactions
         """
@@ -418,7 +418,7 @@ class SlackApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Searches a Slack workspace for messages matching a specific query. It supports advanced control over results through pagination, sorting by relevance or timestamp, and an option to highlight search terms within the returned message content.
-        
+
         Args:
             token (string): A required string parameter named "token" passed as a query parameter to authenticate the request for retrieving search messages.
             query (string): The search query string to specify the text or keywords to search for in messages.
@@ -427,13 +427,13 @@ class SlackApp(APIApplication):
             page (integer): The page query parameter specifies the page number of search results to retrieve in the GET /search.messages operation.
             sort (string): Sorts the search results by a specified field, allowing clients to customize the order of returned messages.
             sort_dir (string): The "sort_dir" query parameter specifies the direction of sorting for the search results, typically accepting values like "asc" for ascending or "desc" for descending order.
-        
+
         Returns:
             dict[str, Any]: Typical success response
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             search, important
         """
@@ -457,17 +457,17 @@ class SlackApp(APIApplication):
     def team_info(self, token: str, team: str | None = None) -> dict[str, Any]:
         """
         Fetches details for a Slack team, such as name and domain, by calling the `team.info` API endpoint. This function requires an authentication token and can optionally target a specific team by its ID, distinguishing it from user or channel-specific functions.
-        
+
         Args:
             token (string): Mandatory authentication token passed as a query parameter to authenticate the request for retrieving team information.
             team (string): The "team" parameter is a query string parameter of type string, used to specify the team for which information is requested in the GET operation at the "/team.info" path.
-        
+
         Returns:
             dict[str, Any]: Typical success response
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             team
         """
@@ -486,18 +486,18 @@ class SlackApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Fetches detailed profile information for a single Slack user, identified by their user ID. Unlike `users_list`, which retrieves all workspace members, this function targets an individual and can optionally include their locale information. It directly calls the `users.info` Slack API endpoint.
-        
+
         Args:
             token (string): The token query parameter is a required string used to authenticate and authorize the API request to access user information in the GET /users.info operation.
             include_locale (boolean): Indicates whether to include locale information in the response, with a value of true or false.
             user (string): A string parameter used to identify or specify a user in the request.
-        
+
         Returns:
             dict[str, Any]: Typical success response
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             users, important
         """
@@ -523,19 +523,19 @@ class SlackApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Fetches a paginated list of all users in a Slack workspace, including deactivated members. Unlike `users_info` which retrieves a single user's details, this function returns a collection and supports limiting results or including locale data through optional parameters.
-        
+
         Args:
             token (string): Required authentication token for accessing the list of users.
             limit (integer): Specifies the maximum number of users to return in the response, defaults to 1.
             cursor (string): A unique string identifier used for cursor-based pagination, indicating the starting point for retrieving the next set of users in the list.
             include_locale (boolean): A boolean query parameter to optionally include locale information in the response.
-        
+
         Returns:
             dict[str, Any]: Typical success response
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             users
         """

universal_mcp/applications/tavily/app.py

@@ -11,17 +11,17 @@ class TavilyApp(APIApplication):
     def search_and_summarize(self, query: str) -> str:
         """
         Queries the Tavily API to perform a web search. It returns a direct AI-generated answer if available; otherwise, it provides a formatted summary of the top three search results, including their titles and snippets.
-        
+
         Args:
             query: The search query string to be processed by Tavily's search engine
-        
+
         Returns:
             A string containing either a direct answer from Tavily's AI or a formatted summary of the top 3 search results, with each result containing the title and snippet
-        
+
         Raises:
             ValueError: When authentication credentials are invalid or missing (via validate() method)
             HTTPError: When the API request fails or returns an error response
-        
+
         Tags:
             search, ai, web, query, important, api-client, text-processing
         """

universal_mcp/applications/twitter/api_segments/compliance_api.py

@@ -12,19 +12,19 @@ class ComplianceApi(APISegmentBase):
     ) -> dict[str, Any]:
         """
         Retrieves a list of compliance jobs, requiring a job `type` ('tweets' or 'users') and allowing optional filtering by `status`. This function fetches multiple jobs, distinguishing it from `get_batch_compliance_job` which retrieves a single job by its unique ID.
-        
+
         Args:
             type (string): The type parameter specifies the compliance job type and must be either "tweets" or "users".
             status (string): Filters compliance jobs by their current status, which can be one of: created, in_progress, failed, or complete.
             compliance_job_fields (array): A comma separated list of ComplianceJob fields to display. Example: "['created_at', 'download_expires_at', 'download_url', 'id', 'name', 'resumable', 'status', 'type', 'upload_expires_at', 'upload_url']".
-        
+
         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:
             Compliance
         """
@@ -47,19 +47,19 @@ class ComplianceApi(APISegmentBase):
     ) -> dict[str, Any]:
         """
         Creates a new batch compliance job for a specified type ('tweets' or 'users'). A custom name can be provided, and resumable uploads can be enabled. This initiates the job creation process, differing from functions that list or retrieve existing jobs.
-        
+
         Args:
             type (string): Type of compliance job to list.
             name (string): User-provided name for a compliance job. Example: 'my-job'.
             resumable (boolean): If true, this endpoint will return a pre-signed URL with resumable uploads enabled.
-        
+
         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:
             Compliance
         """
@@ -79,23 +79,21 @@ class ComplianceApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def get_compliance_job(
-        self, id, compliance_job_fields=None
-    ) -> dict[str, Any]:
+    def get_compliance_job(self, id, compliance_job_fields=None) -> dict[str, Any]:
         """
         Retrieves a single batch compliance job by its unique ID. Unlike `list_batch_compliance_jobs`, which fetches a list, this function returns details for one specific job. Optional parameters can customize which data fields are returned in the response.
-        
+
         Args:
             id (string): id
             compliance_job_fields (array): A comma separated list of ComplianceJob fields to display. Example: "['created_at', 'download_expires_at', 'download_url', 'id', 'name', 'resumable', 'status', 'type', 'upload_expires_at', 'upload_url']".
-        
+
         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:
             Compliance
         """

universal_mcp/applications/twitter/api_segments/dm_conversations_api.py

@@ -12,19 +12,19 @@ class DmConversationsApi(APISegmentBase):
     ) -> dict[str, Any]:
         """
         Creates a new group Direct Message conversation with specified participants and sends an initial message. This function specifically handles the creation of new multi-participant conversations, distinct from other methods in this class that add messages to existing one-to-one or group DMs.
-        
+
         Args:
             conversation_type (string): The conversation type that is being created.
             message (string): message
             participant_ids (array): Participants for the DM Conversation.
-        
+
         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:
             Direct Messages
         """
@@ -62,7 +62,7 @@ class DmConversationsApi(APISegmentBase):
     ) -> dict[str, Any]:
         """
         Retrieves direct message events from a conversation identified by a specific participant's ID. Supports pagination and filtering by event type. This method is distinct from `get_dm_conversations_id_dm_events`, which uses a direct conversation ID for retrieval instead of a participant's ID.
-        
+
         Args:
             participant_id (string): participant_id
             max_results (integer): The maximum number of direct message events to return in the response, with a default of 100.
@@ -73,14 +73,14 @@ class DmConversationsApi(APISegmentBase):
             media_fields (array): A comma separated list of Media fields to display. Example: "['alt_text', 'duration_ms', 'height', 'media_key', 'non_public_metrics', 'organic_metrics', 'preview_image_url', 'promoted_metrics', 'public_metrics', 'type', 'url', 'variants', 'width']".
             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']".
             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:
             Direct Messages
         """
@@ -110,19 +110,19 @@ class DmConversationsApi(APISegmentBase):
     ) -> dict[str, Any]:
         """
         Sends a direct message to a user specified by their participant ID. It creates a new one-on-one conversation or appends the message to an existing one. Unlike other functions, this method identifies the conversation using the participant's ID rather than a pre-existing conversation ID.
-        
+
         Args:
             participant_id (string): participant_id
             attachments (array): Attachments to a DM Event.
             text (string): Text of the message.
-        
+
         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:
             Direct Messages
         """
@@ -149,19 +149,19 @@ class DmConversationsApi(APISegmentBase):
     ) -> dict[str, Any]:
         """
         Sends a new message with optional text and attachments to an existing Direct Message conversation. The target conversation is specified by its `dm_conversation_id`, distinguishing it from functions that create new conversations or send one-to-one messages using a participant ID.
-        
+
         Args:
             dm_conversation_id (string): dm_conversation_id
             attachments (array): Attachments to a DM Event.
             text (string): Text of the message.
-        
+
         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:
             Direct Messages
         """
@@ -197,7 +197,7 @@ class DmConversationsApi(APISegmentBase):
     ) -> dict[str, Any]:
         """
         Retrieves direct message events for a specific conversation using its unique ID. This function, distinct from fetching by participant ID, supports pagination, event type filtering, and data field expansion for detailed results.
-        
+
         Args:
             id (string): id
             max_results (integer): Limits the number of DM events returned in the response, with a default value of 100, allowing users to customize the amount of data retrieved.
@@ -208,14 +208,14 @@ class DmConversationsApi(APISegmentBase):
             media_fields (array): A comma separated list of Media fields to display. Example: "['alt_text', 'duration_ms', 'height', 'media_key', 'non_public_metrics', 'organic_metrics', 'preview_image_url', 'promoted_metrics', 'public_metrics', 'type', 'url', 'variants', 'width']".
             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']".
             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:
             Direct Messages
         """

universal_mcp/applications/twitter/api_segments/dm_events_api.py

@@ -20,7 +20,7 @@ class DmEventsApi(APISegmentBase):
     ) -> dict[str, Any]:
         """
         Retrieves a list of direct message events, unlike `get_dm_events_by_id` which fetches a single event. Supports pagination, filtering by event type, and specifying which data fields to return for various objects to customize the API response.
-        
+
         Args:
             max_results (integer): Limits the number of DM events returned in the response, with a default of 100 if not specified.
             pagination_token (string): Optional token used to specify the starting point for paginating the response of DM events.
@@ -30,14 +30,14 @@ class DmEventsApi(APISegmentBase):
             media_fields (array): A comma separated list of Media fields to display. Example: "['alt_text', 'duration_ms', 'height', 'media_key', 'non_public_metrics', 'organic_metrics', 'preview_image_url', 'promoted_metrics', 'public_metrics', 'type', 'url', 'variants', 'width']".
             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']".
             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:
             Direct Messages
         """
@@ -63,17 +63,17 @@ class DmEventsApi(APISegmentBase):
     def delete_dm_event(self, event_id) -> dict[str, Any]:
         """
         Deletes a specific Direct Message (DM) event identified by its unique ID. This function issues an authenticated HTTP DELETE request to the API to permanently remove the specified event, returning a confirmation of the deletion.
-        
+
         Args:
             event_id (string): event_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:
             Direct Messages
         """
@@ -96,7 +96,7 @@ class DmEventsApi(APISegmentBase):
     ) -> dict[str, Any]:
         """
         Fetches a specific Direct Message event using its unique ID. Optional parameters allow customizing the response by selecting specific fields for the event, media, users, and tweets, and by including expanded object details. This differs from `get_dm_events`, which retrieves a list of events.
-        
+
         Args:
             event_id (string): event_id
             dm_event_fields (array): A comma separated list of DmEvent fields to display. Example: "['attachments', 'created_at', 'dm_conversation_id', 'entities', 'event_type', 'id', 'participant_ids', 'referenced_tweets', 'sender_id', 'text']".
@@ -104,14 +104,14 @@ class DmEventsApi(APISegmentBase):
             media_fields (array): A comma separated list of Media fields to display. Example: "['alt_text', 'duration_ms', 'height', 'media_key', 'non_public_metrics', 'organic_metrics', 'preview_image_url', 'promoted_metrics', 'public_metrics', 'type', 'url', 'variants', 'width']".
             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']".
             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:
             Direct Messages
         """