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

universal_mcp/applications/ms_teams/app.py

@@ -22,7 +22,7 @@ class MsTeamsApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Retrieves a collection of chats the authenticated user is participating in. Supports optional OData query parameters for advanced filtering, sorting, pagination, and field selection, enabling customized data retrieval from the Microsoft Graph API.
-        
+
         Args:
             top (integer): Show only the first n items Example: '50'.
             skip (integer): Skip the first n items
@@ -32,13 +32,13 @@ class MsTeamsApp(APIApplication):
             orderby (array): Order items by property values
             select (array): Select properties to be returned
             expand (array): Expand related entities
-        
+
         Returns:
             dict[str, Any]: Retrieved collection
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             chats.chat, important
         """
@@ -63,13 +63,13 @@ class MsTeamsApp(APIApplication):
     def get_joined_teams(self) -> list[dict[str, Any]]:
         """
         Fetches all Microsoft Teams the authenticated user belongs to by querying the `/me/joinedTeams` Graph API endpoint. It returns a list of dictionaries, where each dictionary represents a single team's details, unlike functions that list channels or chats for a specific team.
-        
+
         Returns:
             A list of dictionaries, where each dictionary represents a team.
-        
+
         Raises:
             httpx.HTTPStatusError: If the API request fails due to authentication or other issues.
-        
+
         Tags:
             read, list, teams, microsoft-teams, api, important
         """
@@ -93,7 +93,7 @@ class MsTeamsApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Retrieves the collection of channels for a specified Microsoft Teams team by its ID. It supports advanced OData query parameters for filtering, sorting, and pagination, distinguishing it from functions that fetch single channels like `get_channel_details`.
-        
+
         Args:
             team_id (string): team-id
             top (integer): Show only the first n items Example: '50'.
@@ -104,13 +104,13 @@ class MsTeamsApp(APIApplication):
             orderby (array): Order items by property values
             select (array): Select properties to be returned
             expand (array): Expand related entities
-        
+
         Returns:
             dict[str, Any]: Retrieved collection
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             teams.channel, important
         """
@@ -137,17 +137,17 @@ class MsTeamsApp(APIApplication):
     def send_chat_message(self, chat_id: str, content: str) -> dict[str, Any]:
         """
         Posts a new message to a specific Microsoft Teams chat using its unique ID. This function targets direct or group chats, distinguishing it from `send_channel_message`, which posts to public team channels, and `reply_to_chat_message`, which responds to existing messages.
-        
+
         Args:
             chat_id: The unique identifier of the chat.
             content: The message content to send (can be plain text or HTML).
-        
+
         Returns:
             A dictionary containing the API response for the sent message, including its ID.
-        
+
         Raises:
             httpx.HTTPStatusError: If the API request fails due to invalid ID, permissions, etc.
-        
+
         Tags:
             create, send, message, chat, microsoft-teams, api, important
         """
@@ -161,18 +161,18 @@ class MsTeamsApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Posts a new message to a specified team channel, initiating a new conversation thread. Unlike `reply_to_channel_message`, which replies to a message, this function starts a new topic. It's distinct from `send_chat_message`, which is for private or group chats, not team channels.
-        
+
         Args:
             team_id: The unique identifier of the team.
             channel_id: The unique identifier of the channel within the team.
             content: The message content to send (can be plain text or HTML).
-        
+
         Returns:
             A dictionary containing the API response for the sent message, including its ID.
-        
+
         Raises:
             httpx.HTTPStatusError: If the API request fails due to invalid IDs, permissions, etc.
-        
+
         Tags:
             create, send, message, channel, microsoft-teams, api, important
         """
@@ -186,19 +186,19 @@ class MsTeamsApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Posts a reply to a specific message within a Microsoft Teams channel. It uses the team, channel, and original message IDs to target an existing conversation thread, distinguishing it from `send_channel_message` which starts a new one.
-        
+
         Args:
             team_id: The unique identifier of the team.
             channel_id: The unique identifier of the channel.
             message_id: The unique identifier of the message to reply to.
             content: The reply message content (can be plain text or HTML).
-        
+
         Returns:
             A dictionary containing the API response for the sent reply, including its ID.
-        
+
         Raises:
             httpx.HTTPStatusError: If the API request fails due to invalid IDs, permissions, etc.
-        
+
         Tags:
             create, send, reply, message, channel, microsoft-teams, api, important
         """
@@ -229,7 +229,7 @@ class MsTeamsApp(APIApplication):
     ) -> Any:
         """
         Creates a new one-on-one or group chat in Microsoft Teams. This function provisions a new conversation using optional parameters like chatType and members, distinguishing it from functions that create teams (`create_team`) or send messages to existing chats (`send_chat_message`).
-        
+
         Args:
             id (string): The unique identifier for an entity. Read-only.
             chatType (string): chatType
@@ -248,13 +248,13 @@ class MsTeamsApp(APIApplication):
             permissionGrants (array): A collection of permissions granted to apps for the chat.
             pinnedMessages (array): A collection of all the pinned messages in the chat. Nullable.
             tabs (array): A collection of all the tabs in the chat. Nullable.
-        
+
         Returns:
             Any: Created entity
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             chats.chat
         """
@@ -299,18 +299,18 @@ class MsTeamsApp(APIApplication):
     ) -> Any:
         """
         Retrieves the properties and relationships of a specific chat conversation by its unique ID. Unlike `get_user_chats` which lists all chats, this targets one chat. Optional parameters can select specific fields or expand related entities like members or apps to customize the returned data.
-        
+
         Args:
             chat_id (string): chat-id
             select (array): Select properties to be returned
             expand (array): Expand related entities
-        
+
         Returns:
             Any: Retrieved entity
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             chats.chat
         """
@@ -346,7 +346,7 @@ class MsTeamsApp(APIApplication):
     ) -> Any:
         """
         Updates properties of a specific chat, such as its topic, using its unique ID. This function performs a partial update (PATCH), distinguishing it from `get_chat_details` which only retrieves data, and `create_chat` which creates an entirely new chat conversation.
-        
+
         Args:
             chat_id (string): chat-id
             id (string): The unique identifier for an entity. Read-only.
@@ -366,13 +366,13 @@ class MsTeamsApp(APIApplication):
             permissionGrants (array): A collection of permissions granted to apps for the chat.
             pinnedMessages (array): A collection of all the pinned messages in the chat. Nullable.
             tabs (array): A collection of all the tabs in the chat. Nullable.
-        
+
         Returns:
             Any: Success
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             chats.chat
         """
@@ -420,7 +420,7 @@ class MsTeamsApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Retrieves applications installed in a specific chat, identified by `chat_id`. Differentiating from `list_user_installed_apps`, which targets a user's personal scope, this function queries a single conversation. It supports optional parameters for advanced filtering, sorting, and pagination to customize the returned collection.
-        
+
         Args:
             chat_id (string): chat-id
             top (integer): Show only the first n items Example: '50'.
@@ -431,13 +431,13 @@ class MsTeamsApp(APIApplication):
             orderby (array): Order items by property values
             select (array): Select properties to be returned
             expand (array): Expand related entities
-        
+
         Returns:
             dict[str, Any]: Retrieved collection
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             chats.teamsAppInstallation
         """
@@ -475,7 +475,7 @@ class MsTeamsApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Retrieves a collection of all members in a specific chat using its ID. It supports OData query parameters for pagination, filtering, and sorting. Unlike `get_chat_member`, which fetches a single individual, this function returns the entire collection of members for the specified chat.
-        
+
         Args:
             chat_id (string): chat-id
             top (integer): Show only the first n items Example: '50'.
@@ -486,13 +486,13 @@ class MsTeamsApp(APIApplication):
             orderby (array): Order items by property values
             select (array): Select properties to be returned
             expand (array): Expand related entities
-        
+
         Returns:
             dict[str, Any]: Retrieved collection
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             chats.conversationMember
         """
@@ -526,20 +526,20 @@ class MsTeamsApp(APIApplication):
     ) -> Any:
         """
         Adds a new member to a specific Microsoft Teams chat using its `chat_id`. This function allows for configuring member roles and chat history visibility. It is the direct counterpart to `delete_chat_member`, performing the 'create' action for a chat's membership.
-        
+
         Args:
             chat_id (string): chat-id
             id (string): The unique identifier for an entity. Read-only.
             displayName (string): The display name of the user.
             roles (array): The roles for that user. This property contains more qualifiers only when relevant - for example, if the member has owner privileges, the roles property contains owner as one of the values. Similarly, if the member is an in-tenant guest, the roles property contains guest as one of the values. A basic member shouldn't have any values specified in the roles property. An Out-of-tenant external member is assigned the owner role.
             visibleHistoryStartDateTime (string): The timestamp denoting how far back a conversation's history is shared with the conversation member. This property is settable only for members of a chat.
-        
+
         Returns:
             Any: Created navigation property.
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             chats.conversationMember
         """
@@ -574,19 +574,19 @@ class MsTeamsApp(APIApplication):
     ) -> Any:
         """
         Retrieves detailed information for a specific member within a chat using their unique ID. This function targets a single individual, distinguishing it from `list_chat_members` which returns all members. The response can be customized by selecting specific properties or expanding related entities.
-        
+
         Args:
             chat_id (string): chat-id
             conversationMember_id (string): conversationMember-id
             select (array): Select properties to be returned
             expand (array): Expand related entities
-        
+
         Returns:
             Any: Retrieved navigation property
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             chats.conversationMember
         """
@@ -604,17 +604,17 @@ class MsTeamsApp(APIApplication):
     def delete_chat_member(self, chat_id: str, conversationMember_id: str) -> Any:
         """
         Removes a specific member from a chat using their unique ID and the chat's ID. This function sends a DELETE request to the Microsoft Graph API to permanently remove the user from the conversation, acting as the counterpart to `add_member_to_chat`.
-        
+
         Args:
             chat_id (string): chat-id
             conversationMember_id (string): conversationMember-id
-        
+
         Returns:
             Any: Success
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             chats.conversationMember
         """
@@ -641,7 +641,7 @@ class MsTeamsApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Retrieves messages from a specific chat using its ID. Unlike `get_chat_message`, which fetches a single message, this function returns a collection and supports advanced querying for filtering, sorting, and pagination to refine the results.
-        
+
         Args:
             chat_id (string): chat-id
             top (integer): Show only the first n items Example: '50'.
@@ -652,13 +652,13 @@ class MsTeamsApp(APIApplication):
             orderby (array): Order items by property values
             select (array): Select properties to be returned
             expand (array): Expand related entities
-        
+
         Returns:
             dict[str, Any]: Retrieved collection
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             chats.chatMessage
         """
@@ -691,19 +691,19 @@ class MsTeamsApp(APIApplication):
     ) -> Any:
         """
         Retrieves the full details of a single message from a specific chat using both chat and message IDs. This function targets an individual message, differentiating it from `list_chat_messages`, which retrieves a collection. Optional parameters can customize the response by selecting specific properties or expanding entities.
-        
+
         Args:
             chat_id (string): chat-id
             chatMessage_id (string): chatMessage-id
             select (array): Select properties to be returned
             expand (array): Expand related entities
-        
+
         Returns:
             Any: Retrieved navigation property
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             chats.chatMessage
         """
@@ -733,7 +733,7 @@ class MsTeamsApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Retrieves all replies for a specific message within a chat, using the parent message's ID. This function, unlike `get_chat_reply_details`, returns a collection and supports OData query parameters for advanced filtering, sorting, and pagination of the results.
-        
+
         Args:
             chat_id (string): chat-id
             chatMessage_id (string): chatMessage-id
@@ -745,13 +745,13 @@ class MsTeamsApp(APIApplication):
             orderby (array): Order items by property values
             select (array): Select properties to be returned
             expand (array): Expand related entities
-        
+
         Returns:
             dict[str, Any]: Retrieved collection
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             chats.chatMessage
         """
@@ -809,7 +809,7 @@ class MsTeamsApp(APIApplication):
     ) -> Any:
         """
         Posts a reply to a specific message within a chat. This comprehensive function allows for detailed configuration of the reply's properties, like its body and attachments. It differs from `reply_to_channel_message`, which sends simpler replies to messages within team channels.
-        
+
         Args:
             chat_id (string): chat-id
             chatMessage_id (string): chatMessage-id
@@ -838,13 +838,13 @@ class MsTeamsApp(APIApplication):
             webUrl (string): Read-only. Link to the message in Microsoft Teams.
             hostedContents (array): Content in a message hosted by Microsoft Teams - for example, images or code snippets.
             replies (array): Replies for a specified message. Supports $expand for channel messages.
-        
+
         Returns:
             Any: Created navigation property.
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             chats.chatMessage
         """
@@ -903,20 +903,20 @@ class MsTeamsApp(APIApplication):
     ) -> Any:
         """
         Retrieves a specific reply from a chat message thread using the chat, parent message, and reply IDs. Unlike `list_chat_message_replies`, which fetches all replies, this function targets a single reply for detailed information, allowing for customized field selection.
-        
+
         Args:
             chat_id (string): chat-id
             chatMessage_id (string): chatMessage-id
             chatMessage_id1 (string): chatMessage-id1
             select (array): Select properties to be returned
             expand (array): Expand related entities
-        
+
         Returns:
             Any: Retrieved navigation property
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             chats.chatMessage
         """
@@ -969,7 +969,7 @@ class MsTeamsApp(APIApplication):
     ) -> Any:
         """
         Enables Microsoft Teams functionality for a pre-existing Microsoft 365 group using its ID. This 'team-ifies' the group, allowing optional configuration of team properties. It differs from `create_team`, which provisions both a new team and its associated group simultaneously.
-        
+
         Args:
             group_id (string): group-id
             id (string): The unique identifier for an entity. Read-only.
@@ -1002,13 +1002,13 @@ class MsTeamsApp(APIApplication):
             schedule (string): schedule
             tags (array): The tags associated with the team.
             template (string): template
-        
+
         Returns:
             Any: Success
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             groups.team
         """
@@ -1095,7 +1095,7 @@ class MsTeamsApp(APIApplication):
     ) -> Any:
         """
         Creates a new Microsoft Team and its associated Microsoft 365 group. This method builds a team from scratch, allowing specification of initial properties like display name, description, and members. It differs from `create_team_from_group`, which enables team functionality for an existing group.
-        
+
         Args:
             id (string): The unique identifier for an entity. Read-only.
             classification (string): An optional label. Typically describes the data or business sensitivity of the team. Must match one of a preconfigured set in the tenant's directory.
@@ -1127,13 +1127,13 @@ class MsTeamsApp(APIApplication):
             schedule (string): schedule
             tags (array): The tags associated with the team.
             template (string): template
-        
+
         Returns:
             Any: Created entity
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             teams.team
         """
@@ -1192,19 +1192,19 @@ class MsTeamsApp(APIApplication):
     ) -> Any:
         """
         Retrieves detailed information for a specific channel within a Microsoft Teams team, identified by both team and channel IDs. Optional parameters can select specific properties or expand related entities in the response, distinguishing it from list_channels_for_team, which retrieves a collection of channels.
-        
+
         Args:
             team_id (string): team-id
             channel_id (string): channel-id
             select (array): Select properties to be returned
             expand (array): Expand related entities
-        
+
         Returns:
             Any: Retrieved navigation property
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             teams.channel
         """
@@ -1252,7 +1252,7 @@ class MsTeamsApp(APIApplication):
     ) -> Any:
         """
         Updates an existing message within a Microsoft Teams channel, identified by team, channel, and message IDs. This function modifies the original message's properties, like its body, via a PATCH request, distinguishing it from functions that create new messages or update replies.
-        
+
         Args:
             team_id (string): team-id
             channel_id (string): channel-id
@@ -1282,13 +1282,13 @@ class MsTeamsApp(APIApplication):
             webUrl (string): Read-only. Link to the message in Microsoft Teams.
             hostedContents (array): Content in a message hosted by Microsoft Teams - for example, images or code snippets.
             replies (array): Replies for a specified message. Supports $expand for channel messages.
-        
+
         Returns:
             Any: Success
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             teams.channel
         """
@@ -1368,7 +1368,7 @@ class MsTeamsApp(APIApplication):
     ) -> Any:
         """
         Updates an existing reply to a specific message within a Microsoft Teams channel. It identifies the target reply using team, channel, parent message, and reply IDs, modifying its properties (e.g., body content, attachments) via a PATCH request.
-        
+
         Args:
             team_id (string): team-id
             channel_id (string): channel-id
@@ -1399,13 +1399,13 @@ class MsTeamsApp(APIApplication):
             webUrl (string): Read-only. Link to the message in Microsoft Teams.
             hostedContents (array): Content in a message hosted by Microsoft Teams - for example, images or code snippets.
             replies (array): Replies for a specified message. Supports $expand for channel messages.
-        
+
         Returns:
             Any: Success
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             teams.channel
         """
@@ -1468,7 +1468,7 @@ class MsTeamsApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Retrieves a collection of tabs from a specified channel within a Microsoft Teams team. Unlike `get_channel_tab_details`, which fetches a single tab, this function lists all tabs and supports advanced OData query parameters for filtering, sorting, and pagination of the entire collection.
-        
+
         Args:
             team_id (string): team-id
             channel_id (string): channel-id
@@ -1480,13 +1480,13 @@ class MsTeamsApp(APIApplication):
             orderby (array): Order items by property values
             select (array): Select properties to be returned
             expand (array): Expand related entities
-        
+
         Returns:
             dict[str, Any]: Retrieved collection
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             teams.channel
         """
@@ -1524,7 +1524,7 @@ class MsTeamsApp(APIApplication):
     ) -> Any:
         """
         Creates a new tab in a specified Microsoft Teams channel using team and channel IDs. This function configures the tab's initial properties, such as display name and application, distinguishing it from functions that list (`list_channel_tabs`) or modify (`update_channel_tab`) existing tabs.
-        
+
         Args:
             team_id (string): team-id
             channel_id (string): channel-id
@@ -1533,13 +1533,13 @@ class MsTeamsApp(APIApplication):
             displayName (string): Name of the tab.
             webUrl (string): Deep link URL of the tab instance. Read only.
             teamsApp (string): teamsApp
-        
+
         Returns:
             Any: Created navigation property.
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             teams.channel
         """
@@ -1578,20 +1578,20 @@ class MsTeamsApp(APIApplication):
     ) -> Any:
         """
         Fetches properties for a single tab within a specific Microsoft Teams channel, identified by its team, channel, and tab IDs. Unlike `list_channel_tabs` which gets all tabs, this targets a specific one, with options to select fields or expand related entities in the response.
-        
+
         Args:
             team_id (string): team-id
             channel_id (string): channel-id
             teamsTab_id (string): teamsTab-id
             select (array): Select properties to be returned
             expand (array): Expand related entities
-        
+
         Returns:
             Any: Retrieved navigation property
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             teams.channel
         """
@@ -1623,7 +1623,7 @@ class MsTeamsApp(APIApplication):
     ) -> Any:
         """
         Modifies properties of an existing tab within a specific Microsoft Teams channel. It uses the team, channel, and tab IDs to target the tab, allowing for partial updates to its configuration or display name via a PATCH request, differentiating it from tab creation or deletion functions.
-        
+
         Args:
             team_id (string): team-id
             channel_id (string): channel-id
@@ -1633,13 +1633,13 @@ class MsTeamsApp(APIApplication):
             displayName (string): Name of the tab.
             webUrl (string): Deep link URL of the tab instance. Read only.
             teamsApp (string): teamsApp
-        
+
         Returns:
             Any: Success
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             teams.channel
         """
@@ -1672,18 +1672,18 @@ class MsTeamsApp(APIApplication):
     ) -> Any:
         """
         Permanently removes a specific tab from a Microsoft Teams channel using its unique ID, along with the parent team and channel IDs. This function is the destructive counterpart to `create_channel_tab`, designed to delete a tab rather than create, list, or update one.
-        
+
         Args:
             team_id (string): team-id
             channel_id (string): channel-id
             teamsTab_id (string): teamsTab-id
-        
+
         Returns:
             Any: Success
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             teams.channel
         """
@@ -1708,18 +1708,18 @@ class MsTeamsApp(APIApplication):
     ) -> Any:
         """
         Retrieves the primary channel (usually 'General') for a specified team using its ID. Unlike `get_channel_details`, this function directly accesses the team's default channel without requiring a specific channel ID. Optional parameters can select or expand properties in the returned data.
-        
+
         Args:
             team_id (string): team-id
             select (array): Select properties to be returned
             expand (array): Expand related entities
-        
+
         Returns:
             Any: Retrieved navigation property
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             teams.channel
         """
@@ -1746,7 +1746,7 @@ class MsTeamsApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Retrieves applications installed in a user's personal Microsoft Teams scope, identified by their ID. Unlike `list_installed_chat_apps` which targets chat installations, this focuses on the user's scope. It supports optional OData parameters for filtering, sorting, and pagination to customize the returned app collection.
-        
+
         Args:
             user_id (string): user-id
             top (integer): Show only the first n items Example: '50'.
@@ -1757,13 +1757,13 @@ class MsTeamsApp(APIApplication):
             orderby (array): Order items by property values
             select (array): Select properties to be returned
             expand (array): Expand related entities
-        
+
         Returns:
             dict[str, Any]: Retrieved collection
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             users.userTeamwork
         """