Merge branch 'main' into chore/consolidate-dependabot-updates-2

Author: gavinbarron

.devcontainer/devcontainer.json

@@ -3,13 +3,12 @@
 {
   "name": "Python 3",
   // Or use a Dockerfile or Docker Compose file. More info: https://containers.dev/guide/dockerfile
-  // "image": "mcr.microsoft.com/devcontainers/python:3.9-bookworm",
   // "image": "mcr.microsoft.com/devcontainers/python:3.10-bookworm",
   // "image": "mcr.microsoft.com/devcontainers/python:3.11-bookworm",
   // "image": "mcr.microsoft.com/devcontainers/python:3.12-bookworm",
   // "image": "mcr.microsoft.com/devcontainers/python:1-3.12-bullseye",
-  //"image": "mcr.microsoft.com/devcontainers/python:3.13-bookworm",
-  "image": "mcr.microsoft.com/devcontainers/python:3.13-bullseye",
+  //"image": "mcr.microsoft.com/devcontainers/python:3.14-bookworm",
+  "image": "mcr.microsoft.com/devcontainers/python:3.14-bullseye",
 
   "features": {
     "ghcr.io/hspaans/devcontainer-features/pytest:1": {},

.github/workflows/build.yml

@@ -15,7 +15,7 @@ jobs:
     strategy:
       max-parallel: 5
       matrix:
-        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
     steps:
     - uses: actions/checkout@v6
     - name: Set up Python ${{ matrix.python-version }}
@@ -42,4 +42,3 @@ jobs:
       - name: One or more build matrix options failed
         if: ${{ contains(needs.*.result, 'failure') }}
         run: exit 1
-

.github/workflows/publish.yml

@@ -21,7 +21,7 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v6
         with:
-          python-version: 3.13
+          python-version: 3.14
       - name: Install flit
         run: |
           pip install flit

README.md

@@ -19,6 +19,7 @@ pip install msgraph-sdk
 
 > **Note:**
 >
+> * This library supports Python 3.10+.
 > * The Microsoft Graph SDK for Python is a fairly large package. It may take a few minutes for the initial installation to complete.
 > * Enable long paths in your environment if you receive a `Could not install packages due to an OSError`. For details, see [Enable Long Paths in Windows 10, Version 1607, and Later](https://learn.microsoft.com/en-us/windows/win32/fileio/maximum-file-path-limitation?tabs=powershell#enable-long-paths-in-windows-10-version-1607-and-later).
 

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:
             """