feat(generation): update request builders and models (#1483)

Update generated files with build 219281

Co-authored-by: Microsoft Graph DevX Tooling <GraphTooling@service.microsoft.com>

Author: microsoft-graph-devx-bot[bot]

msgraph/generated/admin/exchange/mailboxes/item/create_import_session/create_import_session_request_builder.py

@@ -32,9 +32,10 @@ def __init__(self,request_adapter: RequestAdapter, path_parameters: Union[str, d
 
     async def post(self,request_configuration: Optional[RequestConfiguration[QueryParameters]] = None) -> Optional[MailboxItemImportSession]:
         """
-        Invoke action createImportSession
+        Create a session to import an Exchange mailbox item that was exported using the exportItems API.
         param request_configuration: Configuration for the request such as headers, query parameters, and middleware options.
         Returns: Optional[MailboxItemImportSession]
+        Find more info here: https://learn.microsoft.com/graph/api/mailbox-createimportsession?view=graph-rest-1.0
         """
         request_info = self.to_post_request_information(
             request_configuration
@@ -52,7 +53,7 @@ async def post(self,request_configuration: Optional[RequestConfiguration[QueryPa
 
     def to_post_request_information(self,request_configuration: Optional[RequestConfiguration[QueryParameters]] = None) -> RequestInformation:
         """
-        Invoke action createImportSession
+        Create a session to import an Exchange mailbox item that was exported using the exportItems API.
         param request_configuration: Configuration for the request such as headers, query parameters, and middleware options.
         Returns: RequestInformation
         """

msgraph/generated/admin/exchange/mailboxes/item/export_items/export_items_request_builder.py

@@ -33,10 +33,11 @@ def __init__(self,request_adapter: RequestAdapter, path_parameters: Union[str, d
 
     async def post(self,body: ExportItemsPostRequestBody, request_configuration: Optional[RequestConfiguration[QueryParameters]] = None) -> Optional[ExportItemsPostResponse]:
         """
-        Invoke action exportItems
+        Export Exchange mailboxItem objects in full fidelity. This API exports each item as an opaque stream. The data stream isn't intended for parsing, but can be used to import an item back into an Exchange mailbox. For more information, see Overview of the mailbox import and export APIs in Microsoft Graph. You can export up to 20 items in a single export request.
         param body: The request body
         param request_configuration: Configuration for the request such as headers, query parameters, and middleware options.
         Returns: Optional[ExportItemsPostResponse]
+        Find more info here: https://learn.microsoft.com/graph/api/mailbox-exportitems?view=graph-rest-1.0
         """
         if body is None:
             raise TypeError("body cannot be null.")
@@ -56,7 +57,7 @@ async def post(self,body: ExportItemsPostRequestBody, request_configuration: Opt
 
     def to_post_request_information(self,body: ExportItemsPostRequestBody, request_configuration: Optional[RequestConfiguration[QueryParameters]] = None) -> RequestInformation:
         """
-        Invoke action exportItems
+        Export Exchange mailboxItem objects in full fidelity. This API exports each item as an opaque stream. The data stream isn't intended for parsing, but can be used to import an item back into an Exchange mailbox. For more information, see Overview of the mailbox import and export APIs in Microsoft Graph. You can export up to 20 items in a single export request.
         param body: The request body
         param request_configuration: Configuration for the request such as headers, query parameters, and middleware options.
         Returns: RequestInformation

msgraph/generated/admin/exchange/mailboxes/item/folders/delta/delta_request_builder.py

@@ -32,9 +32,10 @@ def __init__(self,request_adapter: RequestAdapter, path_parameters: Union[str, d
 
     async def get(self,request_configuration: Optional[RequestConfiguration[DeltaRequestBuilderGetQueryParameters]] = None) -> Optional[DeltaGetResponse]:
         """
-        Invoke function delta
+        Get a set of mailboxFolder objects that were added, deleted, or removed from the user's mailbox. A delta function call for folders in a mailbox is similar to a GET request, except that by appropriately applying state tokens in one or more of these calls, you can query for incremental changes in the folders. This approach allows you to maintain and synchronize a local store of a user's mail folders without having to fetch all the folders of that mailbox from the server every time.
         param request_configuration: Configuration for the request such as headers, query parameters, and middleware options.
         Returns: Optional[DeltaGetResponse]
+        Find more info here: https://learn.microsoft.com/graph/api/mailboxfolder-delta?view=graph-rest-1.0
         """
         request_info = self.to_get_request_information(
             request_configuration
@@ -52,7 +53,7 @@ async def get(self,request_configuration: Optional[RequestConfiguration[DeltaReq
 
     def to_get_request_information(self,request_configuration: Optional[RequestConfiguration[DeltaRequestBuilderGetQueryParameters]] = None) -> RequestInformation:
         """
-        Invoke function delta
+        Get a set of mailboxFolder objects that were added, deleted, or removed from the user's mailbox. A delta function call for folders in a mailbox is similar to a GET request, except that by appropriately applying state tokens in one or more of these calls, you can query for incremental changes in the folders. This approach allows you to maintain and synchronize a local store of a user's mail folders without having to fetch all the folders of that mailbox from the server every time.
         param request_configuration: Configuration for the request such as headers, query parameters, and middleware options.
         Returns: RequestInformation
         """
@@ -74,7 +75,7 @@ def with_url(self,raw_url: str) -> DeltaRequestBuilder:
     @dataclass
     class DeltaRequestBuilderGetQueryParameters():
         """
-        Invoke function delta
+        Get a set of mailboxFolder objects that were added, deleted, or removed from the user's mailbox. A delta function call for folders in a mailbox is similar to a GET request, except that by appropriately applying state tokens in one or more of these calls, you can query for incremental changes in the folders. This approach allows you to maintain and synchronize a local store of a user's mail folders without having to fetch all the folders of that mailbox from the server every time.
         """
         def get_query_parameter(self,original_name: str) -> str:
             """

msgraph/generated/admin/exchange/mailboxes/item/folders/folders_request_builder.py

@@ -49,9 +49,10 @@ def by_mailbox_folder_id(self,mailbox_folder_id: str) -> MailboxFolderItemReques
 
     async def get(self,request_configuration: Optional[RequestConfiguration[FoldersRequestBuilderGetQueryParameters]] = None) -> Optional[MailboxFolderCollectionResponse]:
         """
-        Get folders from admin
+        Get all the mailboxFolder objects in the specified mailbox, including any search folders.
         param request_configuration: Configuration for the request such as headers, query parameters, and middleware options.
         Returns: Optional[MailboxFolderCollectionResponse]
+        Find more info here: https://learn.microsoft.com/graph/api/mailbox-list-folders?view=graph-rest-1.0
         """
         request_info = self.to_get_request_information(
             request_configuration
@@ -69,7 +70,7 @@ async def get(self,request_configuration: Optional[RequestConfiguration[FoldersR
 
     def to_get_request_information(self,request_configuration: Optional[RequestConfiguration[FoldersRequestBuilderGetQueryParameters]] = None) -> RequestInformation:
         """
-        Get folders from admin
+        Get all the mailboxFolder objects in the specified mailbox, including any search folders.
         param request_configuration: Configuration for the request such as headers, query parameters, and middleware options.
         Returns: RequestInformation
         """
@@ -109,7 +110,7 @@ def delta(self) -> DeltaRequestBuilder:
     @dataclass
     class FoldersRequestBuilderGetQueryParameters():
         """
-        Get folders from admin
+        Get all the mailboxFolder objects in the specified mailbox, including any search folders.
         """
         def get_query_parameter(self,original_name: str) -> str:
             """

msgraph/generated/admin/exchange/mailboxes/item/folders/item/child_folders/child_folders_request_builder.py

@@ -49,9 +49,10 @@ def by_mailbox_folder_id1(self,mailbox_folder_id1: str) -> MailboxFolderItemRequ
 
     async def get(self,request_configuration: Optional[RequestConfiguration[ChildFoldersRequestBuilderGetQueryParameters]] = None) -> Optional[MailboxFolderCollectionResponse]:
         """
-        Get childFolders from admin
+        Get the mailboxFolder collection under the specified mailboxFolder in a mailbox.
         param request_configuration: Configuration for the request such as headers, query parameters, and middleware options.
         Returns: Optional[MailboxFolderCollectionResponse]
+        Find more info here: https://learn.microsoft.com/graph/api/mailboxfolder-list-childfolders?view=graph-rest-1.0
         """
         request_info = self.to_get_request_information(
             request_configuration
@@ -69,7 +70,7 @@ async def get(self,request_configuration: Optional[RequestConfiguration[ChildFol
 
     def to_get_request_information(self,request_configuration: Optional[RequestConfiguration[ChildFoldersRequestBuilderGetQueryParameters]] = None) -> RequestInformation:
         """
-        Get childFolders from admin
+        Get the mailboxFolder collection under the specified mailboxFolder in a mailbox.
         param request_configuration: Configuration for the request such as headers, query parameters, and middleware options.
         Returns: RequestInformation
         """
@@ -109,7 +110,7 @@ def delta(self) -> DeltaRequestBuilder:
     @dataclass
     class ChildFoldersRequestBuilderGetQueryParameters():
         """
-        Get childFolders from admin
+        Get the mailboxFolder collection under the specified mailboxFolder in a mailbox.
         """
         def get_query_parameter(self,original_name: str) -> str:
             """

msgraph/generated/admin/exchange/mailboxes/item/folders/item/child_folders/delta/delta_request_builder.py

@@ -32,9 +32,10 @@ def __init__(self,request_adapter: RequestAdapter, path_parameters: Union[str, d
 
     async def get(self,request_configuration: Optional[RequestConfiguration[DeltaRequestBuilderGetQueryParameters]] = None) -> Optional[DeltaGetResponse]:
         """
-        Invoke function delta
+        Get a set of mailboxFolder objects that were added, deleted, or removed from the user's mailbox. A delta function call for folders in a mailbox is similar to a GET request, except that by appropriately applying state tokens in one or more of these calls, you can query for incremental changes in the folders. This approach allows you to maintain and synchronize a local store of a user's mail folders without having to fetch all the folders of that mailbox from the server every time.
         param request_configuration: Configuration for the request such as headers, query parameters, and middleware options.
         Returns: Optional[DeltaGetResponse]
+        Find more info here: https://learn.microsoft.com/graph/api/mailboxfolder-delta?view=graph-rest-1.0
         """
         request_info = self.to_get_request_information(
             request_configuration
@@ -52,7 +53,7 @@ async def get(self,request_configuration: Optional[RequestConfiguration[DeltaReq
 
     def to_get_request_information(self,request_configuration: Optional[RequestConfiguration[DeltaRequestBuilderGetQueryParameters]] = None) -> RequestInformation:
         """
-        Invoke function delta
+        Get a set of mailboxFolder objects that were added, deleted, or removed from the user's mailbox. A delta function call for folders in a mailbox is similar to a GET request, except that by appropriately applying state tokens in one or more of these calls, you can query for incremental changes in the folders. This approach allows you to maintain and synchronize a local store of a user's mail folders without having to fetch all the folders of that mailbox from the server every time.
         param request_configuration: Configuration for the request such as headers, query parameters, and middleware options.
         Returns: RequestInformation
         """
@@ -74,7 +75,7 @@ def with_url(self,raw_url: str) -> DeltaRequestBuilder:
     @dataclass
     class DeltaRequestBuilderGetQueryParameters():
         """
-        Invoke function delta
+        Get a set of mailboxFolder objects that were added, deleted, or removed from the user's mailbox. A delta function call for folders in a mailbox is similar to a GET request, except that by appropriately applying state tokens in one or more of these calls, you can query for incremental changes in the folders. This approach allows you to maintain and synchronize a local store of a user's mail folders without having to fetch all the folders of that mailbox from the server every time.
         """
         def get_query_parameter(self,original_name: str) -> str:
             """

msgraph/generated/admin/exchange/mailboxes/item/folders/item/child_folders/item/items/delta/delta_request_builder.py

@@ -32,7 +32,7 @@ def __init__(self,request_adapter: RequestAdapter, path_parameters: Union[str, d
 
     async def get(self,request_configuration: Optional[RequestConfiguration[DeltaRequestBuilderGetQueryParameters]] = None) -> Optional[DeltaGetResponse]:
         """
-        Invoke function delta
+        Get a set of mailboxItem objects that were added, deleted, or updated in a specified mailboxFolder. A delta function call for items in a folder is similar to a GET request, except that by appropriately applying state tokens in one or more of these calls, you can query for incremental changes in the items in that folder. This approach allows you to maintain and synchronize a local store of a user's mailbox items without having to fetch the entire set of items from the server every time.
         param request_configuration: Configuration for the request such as headers, query parameters, and middleware options.
         Returns: Optional[DeltaGetResponse]
         """
@@ -52,7 +52,7 @@ async def get(self,request_configuration: Optional[RequestConfiguration[DeltaReq
 
     def to_get_request_information(self,request_configuration: Optional[RequestConfiguration[DeltaRequestBuilderGetQueryParameters]] = None) -> RequestInformation:
         """
-        Invoke function delta
+        Get a set of mailboxItem objects that were added, deleted, or updated in a specified mailboxFolder. A delta function call for items in a folder is similar to a GET request, except that by appropriately applying state tokens in one or more of these calls, you can query for incremental changes in the items in that folder. This approach allows you to maintain and synchronize a local store of a user's mailbox items without having to fetch the entire set of items from the server every time.
         param request_configuration: Configuration for the request such as headers, query parameters, and middleware options.
         Returns: RequestInformation
         """
@@ -74,7 +74,7 @@ def with_url(self,raw_url: str) -> DeltaRequestBuilder:
     @dataclass
     class DeltaRequestBuilderGetQueryParameters():
         """
-        Invoke function delta
+        Get a set of mailboxItem objects that were added, deleted, or updated in a specified mailboxFolder. A delta function call for items in a folder is similar to a GET request, except that by appropriately applying state tokens in one or more of these calls, you can query for incremental changes in the items in that folder. This approach allows you to maintain and synchronize a local store of a user's mailbox items without having to fetch the entire set of items from the server every time.
         """
         def get_query_parameter(self,original_name: str) -> str:
             """

msgraph/generated/admin/exchange/mailboxes/item/folders/item/child_folders/item/items/item/mailbox_item_item_request_builder.py

@@ -32,7 +32,7 @@ def __init__(self,request_adapter: RequestAdapter, path_parameters: Union[str, d
 
     async def get(self,request_configuration: Optional[RequestConfiguration[MailboxItemItemRequestBuilderGetQueryParameters]] = None) -> Optional[MailboxItem]:
         """
-        Get items from admin
+        The collection of items in this folder.
         param request_configuration: Configuration for the request such as headers, query parameters, and middleware options.
         Returns: Optional[MailboxItem]
         """
@@ -52,7 +52,7 @@ async def get(self,request_configuration: Optional[RequestConfiguration[MailboxI
 
     def to_get_request_information(self,request_configuration: Optional[RequestConfiguration[MailboxItemItemRequestBuilderGetQueryParameters]] = None) -> RequestInformation:
         """
-        Get items from admin
+        The collection of items in this folder.
         param request_configuration: Configuration for the request such as headers, query parameters, and middleware options.
         Returns: RequestInformation
         """
@@ -74,7 +74,7 @@ def with_url(self,raw_url: str) -> MailboxItemItemRequestBuilder:
     @dataclass
     class MailboxItemItemRequestBuilderGetQueryParameters():
         """
-        Get items from admin
+        The collection of items in this folder.
         """
         def get_query_parameter(self,original_name: str) -> str:
             """

msgraph/generated/admin/exchange/mailboxes/item/folders/item/child_folders/item/items/items_request_builder.py

@@ -49,7 +49,7 @@ def by_mailbox_item_id(self,mailbox_item_id: str) -> MailboxItemItemRequestBuild
 
     async def get(self,request_configuration: Optional[RequestConfiguration[ItemsRequestBuilderGetQueryParameters]] = None) -> Optional[MailboxItemCollectionResponse]:
         """
-        Get items from admin
+        The collection of items in this folder.
         param request_configuration: Configuration for the request such as headers, query parameters, and middleware options.
         Returns: Optional[MailboxItemCollectionResponse]
         """
@@ -69,7 +69,7 @@ async def get(self,request_configuration: Optional[RequestConfiguration[ItemsReq
 
     def to_get_request_information(self,request_configuration: Optional[RequestConfiguration[ItemsRequestBuilderGetQueryParameters]] = None) -> RequestInformation:
         """
-        Get items from admin
+        The collection of items in this folder.
         param request_configuration: Configuration for the request such as headers, query parameters, and middleware options.
         Returns: RequestInformation
         """
@@ -109,7 +109,7 @@ def delta(self) -> DeltaRequestBuilder:
     @dataclass
     class ItemsRequestBuilderGetQueryParameters():
         """
-        Get items from admin
+        The collection of items in this folder.
         """
         def get_query_parameter(self,original_name: str) -> str:
             """

msgraph/generated/admin/exchange/mailboxes/item/folders/item/child_folders/item/mailbox_folder_item_request_builder.py

@@ -33,7 +33,7 @@ def __init__(self,request_adapter: RequestAdapter, path_parameters: Union[str, d
 
     async def get(self,request_configuration: Optional[RequestConfiguration[MailboxFolderItemRequestBuilderGetQueryParameters]] = None) -> Optional[MailboxFolder]:
         """
-        Get childFolders from admin
+        The collection of child folders in this folder.
         param request_configuration: Configuration for the request such as headers, query parameters, and middleware options.
         Returns: Optional[MailboxFolder]
         """
@@ -53,7 +53,7 @@ async def get(self,request_configuration: Optional[RequestConfiguration[MailboxF
 
     def to_get_request_information(self,request_configuration: Optional[RequestConfiguration[MailboxFolderItemRequestBuilderGetQueryParameters]] = None) -> RequestInformation:
         """
-        Get childFolders from admin
+        The collection of child folders in this folder.
         param request_configuration: Configuration for the request such as headers, query parameters, and middleware options.
         Returns: RequestInformation
         """
@@ -84,7 +84,7 @@ def items(self) -> ItemsRequestBuilder:
     @dataclass
     class MailboxFolderItemRequestBuilderGetQueryParameters():
         """
-        Get childFolders from admin
+        The collection of child folders in this folder.
         """
         def get_query_parameter(self,original_name: str) -> str:
             """