Merge pull request #28275 from microsoftgraph/exoimexapi-ga-updates

Mailbox Import and Export API GA

Author: Danipocket

api-reference/beta/api/mailbox-createimportsession.md

@@ -1,6 +1,6 @@
 ---
 title: "mailbox: createImportSession"
-description: "Create a session to import an Exchange mailbox item using its FastTransfer stream (FTS) format."
+description: "Create a session to import an Exchange mailbox item that was exported using the exportItems API."
 author: "cparker-msft"
 ms.date: 12/06/2024
 ms.localizationpriority: medium
@@ -56,7 +56,7 @@ If successful, this action returns a `200 OK` response code and a [mailboxItemIm
 
 ### Request
 
-The following example shows how to create an import session. The opaque URL, returned in the **importUrl** property of the response, is preauthenticated and contains the appropriate authorization token for subsequent POST queries in the https://outlook.office365.com domain. That token expires by **expirationDateTime**. Don't customize this URL for subsequent POST operations.
+The following example shows how to create an import session. The opaque URL, returned in the **importUrl** property of the response, is preauthenticated and contains the appropriate authorization token for subsequent POST queries in the `https://outlook.office365.com` domain. This token expires at the time specified in **expirationDateTime**. Don't customize this URL for subsequent POST operations.
 
 # [HTTP](#tab/http)
 <!-- {

api-reference/beta/api/mailbox-exportitems.md

@@ -1,6 +1,6 @@
 ---
 title: "mailbox: exportItems"
-description: "Export Exchange mailboxItem objects in full-fidelity FastTransfer format for backup purposes."
+description: "Export Exchange mailboxItem objects in full fidelity."
 author: "cparker-msft"
 ms.date: 12/06/2024
 ms.localizationpriority: medium
@@ -14,7 +14,7 @@ Namespace: microsoft.graph
 
 [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
 
-Export Exchange [mailboxItem](../resources/mailboxitem.md) 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 (preview)](/graph/mailbox-import-export-concept-overview)
+Export Exchange [mailboxItem](../resources/mailboxitem.md) 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](/graph/mailbox-import-export-concept-overview).
 
 You can export up to 20 items in a single export request.
 
@@ -52,7 +52,7 @@ The following table lists the parameters that are required when you call this ac
 
 |Parameter|Type|Description|
 |:---|:---|:---|
-|itemIds|String collection|A collection of identifiers of [mailboxItem](../resources/mailboxitem.md) objects to export. All identifiers in the collection _must_ be for items in the same mailbox. Maximum size of this collection is 20 strings.|
+|itemIds|String collection|A collection of identifiers of [mailboxItem](../resources/mailboxitem.md) objects to export. All identifiers in the collection _must_ be for items in the same mailbox. The maximum size of this collection is 20 strings.|
 
 ## Response
 

api-reference/beta/api/mailbox-list-folders.md

@@ -37,7 +37,7 @@ GET /admin/exchange/mailboxes/{mailboxId}/folders
 
 ## Optional query parameters
 
-This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+This method supports the `$select`, `$filter`, `$top`, `$skip`, `$orderby`, `$count`, and `$expand` OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
 
 ## Request headers
 

api-reference/beta/api/mailboxfolder-delta.md

@@ -1,6 +1,6 @@
 ---
 title: "mailboxFolder: delta"
-description: "Get a set of mailboxFolder objects that have been added, deleted, or removed from the user's mailbox."
+description: "Get a set of mailboxFolder objects that were added, deleted, or removed from the user's mailbox."
 author: "cparker-msft"
 ms.date: 12/06/2024
 ms.localizationpriority: medium
@@ -14,7 +14,7 @@ Namespace: microsoft.graph
 
 [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
 
-Get a set of [mailboxFolder](../resources/mailboxfolder.md) objects that have been added, deleted, or removed from the user's mailbox.
+Get a set of [mailboxFolder](../resources/mailboxfolder.md) 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](/graph/delta-query-overview) 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.
 
@@ -56,7 +56,7 @@ You can use the `$select` query parameter to specify only the properties you nee
 |Name|Description|
 |:---|:---|
 |Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
-|Prefer|odata.maxpagesize={x}. Optional.|
+|Prefer|odata.maxpagesize={x}. Optional. Controls page size.|
 
 ## Request body
 

api-reference/beta/api/mailboxfolder-get.md

@@ -38,7 +38,7 @@ GET /admin/exchange/mailboxes/{mailboxId}/folders/{mailboxFolderId}/childFolders
 
 ## Optional query parameters
 
-This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+This method supports the `$select` and `$expand` OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
 
 ## Request headers
 

api-reference/beta/api/mailboxfolder-list-childfolders.md

@@ -41,7 +41,7 @@ GET /admin/exchange/mailboxes/{mailboxId}/folders/{mailboxFolderId}/childFolders
 
 ## Optional query parameters
 
-This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+This method supports the `$select`, `$filter`, `$top`, `$skip`, `$orderby`, `$count`, and `$expand` OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
 
 ## Request headers
 

api-reference/beta/api/mailboxfolder-list-items.md

@@ -37,7 +37,7 @@ GET /admin/exchange/mailboxes/{mailboxId}/folders/{mailboxFolderId}/items
 
 ## Optional query parameters
 
-This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+This method supports the `$select`, `$filter`, `$top`, `$skip`, `$orderby`, `$count`, and `$expand` OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
 
 ## Request headers
 
@@ -149,7 +149,7 @@ Content-length: 232
 
 ### Example 2: List items using query parameter
 
-The following example uses the `$filter`, `$select`, and `$top` query parameters. The `$filter` parameter refines the results and returns only items with **createdDateTime** between `2021-08-21` and `2021-09-16`.  The `$select` parameter specifies to return only a subset of the properties of each item in the response, and the `$top` parameter sets the page size of the result set to return only the top item in the mailbox under the specified folder.
+The following example uses the `$filter`, `$select`, and `$top` query parameters. The `$filter` parameter refines the results and returns only items with **createdDateTime** between `2021-08-21` and `2021-09-16`. The `$select` parameter specifies that only a subset of properties for each item should be returned in the response, and the `$top` parameter sets the page size of the result set to return only the top item in the mailbox under the specified folder.
 
 #### Request
 

api-reference/beta/api/mailboxitem-delta.md

@@ -1,6 +1,6 @@
 ---
 title: "mailboxItem: delta"
-description: "Get a set of mailboxItem objects that have been added, deleted, or updated in a specified folder."
+description: "Get a set of mailboxItem objects that were added, deleted, or updated in a specified folder."
 author: "cparker-msft"
 ms.date: 12/06/2024
 ms.localizationpriority: medium
@@ -14,7 +14,7 @@ Namespace: microsoft.graph
 
 [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
 
-Get a set of [mailboxItem](../resources/mailboxitem.md) objects that have been added, deleted, or updated in a specified [mailboxFolder](../resources/mailboxfolder.md).
+Get a set of [mailboxItem](../resources/mailboxitem.md) objects that were added, deleted, or updated in a specified [mailboxFolder](../resources/mailboxfolder.md).
 
 A **delta** function call for items in a folder is similar to a GET request, except that by appropriately applying [state tokens](/graph/delta-query-overview) in one or more of these calls, you can [query for incremental changes in the items in that folder](/graph/delta-query-messages). 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.
 
@@ -60,7 +60,7 @@ Tracking changes in items incurs a round of one or more **delta** function calls
 |Name|Description|
 |:---|:---|
 |Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
-|Prefer|odata.maxpagesize={x}. Optional.|
+|Prefer|odata.maxpagesize={x}. Optional. Controls page size.|
 
 ## Request body
 

api-reference/beta/api/mailboxitem-get.md

@@ -37,7 +37,7 @@ GET /admin/exchange/mailboxes/{mailboxId}/folders/{mailboxFolderId}/items/{mailb
 
 ## Optional query parameters
 
-This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+This method supports the `$select` and `$expand` OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
 
 ## Request headers
 

api-reference/beta/api/multivaluelegacyextendedproperty-get.md

@@ -28,6 +28,8 @@ The following user resources are supported:
 - [contact](../resources/contact.md)
 - [contactFolder](../resources/contactfolder.md)
 - [event](../resources/event.md)
+- [mailboxFolder](../resources/mailboxfolder.md)
+- [mailboxItem](../resources/mailboxitem.md) 
 - [mailFolder](../resources/mailfolder.md)
 - [message](../resources/message.md)
 - [note](../resources/note.md)
@@ -57,6 +59,8 @@ Depending on the resource you're getting the extended property from and the perm
 | group [calendar](../resources/calendar.md) | Group.Read.All | Not supported | Not supported |
 | group [event](../resources/event.md) | Group.Read.All | Not supported | Not supported |
 | group [post](../resources/post.md) | Group.Read.All | Not supported | Group.Read.All |
+| [mailboxFolder](../resources/mailboxfolder.md) | MailboxFolder.Read | Not supported. | MailboxFolder.Read.All |
+| [mailboxItem](../resources/mailboxitem.md) | MailboxItem.Read | Not supported. | MailboxItem.Read.All |
 | [mailFolder](../resources/mailfolder.md) | Mail.Read | Mail.Read | Mail.Read |
 | [message](../resources/message.md) | Mail.Read | Mail.Read | Mail.Read |
 | [note](../resources/note.md) | ShortNotes.Read | ShortNotes.Read | ShortNotes.Read |
@@ -122,6 +126,24 @@ GET /users/{id|userPrincipalName}/contactFolders/{id}?$expand=multiValueExtended
 
 [!INCLUDE [me-apis-sign-in-note](../includes/me-apis-sign-in-note.md)]
 
+Get a **mailboxItem** instance:
+<!-- { "blockType": "ignored" } -->
+```http
+GET /admin/exchange/mailboxes/{mailboxId}/folders/{mailboxFolderId}/items?$expand=multiValueExtendedProperties($filter=id eq '{id_value}')
+GET /admin/exchange/mailboxes/{mailboxId}/folders/{mailboxFolderId}/items/{mailboxItemId}?$expand=multiValueExtendedProperties($filter=id eq '{id_value}')
+```
+
+[!INCLUDE [me-apis-sign-in-note](../includes/me-apis-sign-in-note.md)]
+
+Get a **mailboxFolder** instance:
+<!-- { "blockType": "ignored" } -->
+```http
+GET /admin/exchange/mailboxes/{mailboxId}/folders?$expand=multiValueExtendedProperties($filter=id eq '{id_value}')
+GET /admin/exchange/mailboxes/{mailboxId}/folders/{mailboxFolderId}?$expand=multiValueExtendedProperties($filter=id eq '{id_value}')
+```
+
+[!INCLUDE [me-apis-sign-in-note](../includes/me-apis-sign-in-note.md)]
+
 Get a **note** instance:
 <!-- { "blockType": "ignored" } -->
 ```http