Merge branch 'main' into remove-delve-mentions

FaithOmbongi · web-flow · commit 116821381c4f · 2025-01-30T14:51:40.000+03:00
diff --git a/.vscode/settings.json b/.vscode/settings.json
@@ -3,6 +3,7 @@
         "main",
         "main",
         "main",
+        "main",
         "main"
     ],
     "json.schemas": [
diff --git a/README.md b/README.md
@@ -4,8 +4,6 @@ Thank you for your interest in Microsoft Graph documentation! For the best exper
 
 ## Give us your feedback
 
-**Coming soon:** In March 2024, we will be phasing out the current feedback mechanism for content (GitHub issues) described below and replacing it with a new feedback system. For more information, see https://aka.ms/ContentUserFeedback.
-
 Your feedback is important to us.
 
 - To let us know about any questions or issues you find in the documentation, [leave feedback using the standard experience](https://learn.microsoft.com/en-us/contribute/content/provide-feedback#use-the-standard-experience).
diff --git a/api-reference/beta/api/mailbox-createimportsession.md b/api-reference/beta/api/mailbox-createimportsession.md
@@ -20,11 +20,7 @@ Create a session to [import an Exchange mailbox item](/graph/import-exchange-mai
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
 
-<!-- {
-  "blockType": "permissions",
-  "name": "mailbox-createimportsession-permissions"
-}
--->
+<!-- { "blockType": "permissions", "name": "mailbox_createimportsession" } -->
 [!INCLUDE [permissions-table](../includes/permissions/mailbox-createimportsession-permissions.md)]
 
 ## HTTP request
diff --git a/api-reference/beta/api/mailbox-delete-folders.md b/api-reference/beta/api/mailbox-delete-folders.md
@@ -20,11 +20,7 @@ Delete a [mailboxFolder](../resources/mailboxfolder.md) or a child **mailboxFold
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
 
-<!-- {
-  "blockType": "permissions",
-  "name": "mailbox-delete-folders-permissions"
-}
--->
+<!-- { "blockType": "permissions", "name": "mailbox_delete_folders" } -->
 [!INCLUDE [permissions-table](../includes/permissions/mailbox-delete-folders-permissions.md)]
 
 ## HTTP request
diff --git a/api-reference/beta/api/mailbox-exportitems.md b/api-reference/beta/api/mailbox-exportitems.md
@@ -22,11 +22,7 @@ You can export up to 20 items in a single export request.
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
 
-<!-- {
-  "blockType": "permissions",
-  "name": "mailbox-exportitems-permissions"
-}
--->
+<!-- { "blockType": "permissions", "name": "mailbox_exportitems" } -->
 [!INCLUDE [permissions-table](../includes/permissions/mailbox-exportitems-permissions.md)]
 
 ## HTTP request
diff --git a/api-reference/beta/api/mailbox-list-folders.md b/api-reference/beta/api/mailbox-list-folders.md
@@ -20,11 +20,7 @@ Get all the [mailboxFolder](../resources/mailboxfolder.md) objects in the specif
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
 
-<!-- {
-  "blockType": "permissions",
-  "name": "mailbox-list-folders-permissions"
-}
--->
+<!-- { "blockType": "permissions", "name": "mailbox_list_folders" } -->
 [!INCLUDE [permissions-table](../includes/permissions/mailbox-list-folders-permissions.md)]
 
 ## HTTP request
diff --git a/api-reference/beta/api/mailbox-post-folders.md b/api-reference/beta/api/mailbox-post-folders.md
@@ -20,11 +20,7 @@ Create a new [mailboxFolder](../resources/mailboxfolder.md) or child **mailboxFo
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
 
-<!-- {
-  "blockType": "permissions",
-  "name": "mailbox-post-folders-permissions"
-}
--->
+<!-- { "blockType": "permissions", "name": "mailbox_post_folders" } -->
 [!INCLUDE [permissions-table](../includes/permissions/mailbox-post-folders-permissions.md)]
 
 ## HTTP request
diff --git a/api-reference/beta/api/mailboxfolder-delta.md b/api-reference/beta/api/mailboxfolder-delta.md
@@ -22,11 +22,7 @@ A **delta** function call for folders in a mailbox is similar to a GET request,
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
 
-<!-- {
-  "blockType": "permissions",
-  "name": "mailboxfolder-delta-permissions"
-}
--->
+<!-- { "blockType": "permissions", "name": "mailboxfolder_delta" } -->
 [!INCLUDE [permissions-table](../includes/permissions/mailboxfolder-delta-permissions.md)]
 
 ## HTTP request
diff --git a/api-reference/beta/api/mailboxfolder-get.md b/api-reference/beta/api/mailboxfolder-get.md
@@ -20,11 +20,7 @@ Read the properties and relationships of a [mailboxFolder](../resources/mailboxf
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
 
-<!-- {
-  "blockType": "permissions",
-  "name": "mailboxfolder-get-permissions"
-}
--->
+<!-- { "blockType": "permissions", "name": "mailboxfolder_get" } -->
 [!INCLUDE [permissions-table](../includes/permissions/mailboxfolder-get-permissions.md)]
 
 ## HTTP request
diff --git a/api-reference/beta/api/mailboxfolder-list-items.md b/api-reference/beta/api/mailboxfolder-list-items.md
@@ -20,11 +20,7 @@ Get the [mailboxItem](../resources/mailboxitem.md) collection within a specified
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
 
-<!-- {
-  "blockType": "permissions",
-  "name": "mailboxfolder-list-items-permissions"
-}
--->
+<!-- { "blockType": "permissions", "name": "mailboxfolder_list_items" } -->
 [!INCLUDE [permissions-table](../includes/permissions/mailboxfolder-list-items-permissions.md)]
 
 ## HTTP request
diff --git a/api-reference/beta/api/mailboxfolder-update.md b/api-reference/beta/api/mailboxfolder-update.md
@@ -23,11 +23,7 @@ Update [mailboxFolder](../resources/mailboxfolder.md) properties such as the **d
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
 
-<!-- {
-  "blockType": "permissions",
-  "name": "mailboxfolder-update-permissions"
-}
--->
+<!-- { "blockType": "permissions", "name": "mailboxfolder_update" } -->
 [!INCLUDE [permissions-table](../includes/permissions/mailboxfolder-update-permissions.md)]
 
 ## HTTP request
diff --git a/api-reference/beta/api/mailboxitem-delta.md b/api-reference/beta/api/mailboxitem-delta.md
@@ -22,11 +22,7 @@ A **delta** function call for items in a folder is similar to a GET request, exc
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
 
-<!-- {
-  "blockType": "permissions",
-  "name": "mailboxitem-delta-permissions"
-}
--->
+<!-- { "blockType": "permissions", "name": "mailboxitem_delta" } -->
 [!INCLUDE [permissions-table](../includes/permissions/mailboxitem-delta-permissions.md)]
 
 ## HTTP request
diff --git a/api-reference/beta/api/mailboxitem-get.md b/api-reference/beta/api/mailboxitem-get.md
@@ -20,11 +20,7 @@ Read the properties and relationships of a [mailboxItem](../resources/mailboxite
 
 Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
 
-<!-- {
-  "blockType": "permissions",
-  "name": "mailboxitem-get-permissions"
-}
--->
+<!-- { "blockType": "permissions", "name": "mailboxitem_get" } -->
 [!INCLUDE [permissions-table](../includes/permissions/mailboxitem-get-permissions.md)]
 
 ## HTTP request
diff --git a/api-reference/beta/api/user-update.md b/api-reference/beta/api/user-update.md
@@ -89,7 +89,7 @@ PATCH /users/{id | userPrincipalName}
 |officeLocation|String|The office location in the user's place of business.|
 | onPremisesExtensionAttributes | [onPremisesExtensionAttributes](../resources/onpremisesextensionattributes.md) | Contains extensionAttributes 1-15 for the user. The individual extension attributes aren't selectable or filterable. For an `onPremisesSyncEnabled` user, the source of authority for this set of properties is the on-premises and is read-only. These extension attributes are also known as Exchange custom attributes 1-15.|
 |onPremisesImmutableId|String|This property is used to associate an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you're using a federated domain for the user's **userPrincipalName** (UPN) property. **Important:** The **$** and **_** characters can't be used when specifying this property.                            |
-|otherMails|String collection|A list of additional email addresses for the user; for example: `["bob@contoso.com", "Robert@fabrikam.com"]`. To update this property, pass in all the email addresses that you want the user to have; otherwise, existing values get overwritten by the values you specify. <br/><br/><li> *User-Mail.ReadWrite.All* is the least privileged permission to update this property. <li> In delegated scenarios, *Privileged Authentication Administrator* is the least privileged role that's allowed to update this property for *all* administrators in the tenant. In general, the signed-in user must have a higher privileged administrator role as indicated in [Who can perform sensitive actions](../resources/users.md#who-can-perform-sensitive-actions). <li> In app-only scenarios in addition to Microsoft Graph permissions, the app must be assigned a higher privileged administrator role as indicated in [Who can perform sensitive actions](../resources/users.md#who-can-perform-sensitive-actions).|
+|otherMails|String collection|A list of additional email addresses for the user; for example: `["bob@contoso.com", "Robert@fabrikam.com"]`. To update this property, pass in all the email addresses that you want the user to have; otherwise, existing values get overwritten by the values you specify. Can store up to 250 values, each with a limit of 250 characters. <br/><br/><li> *User-Mail.ReadWrite.All* is the least privileged permission to update this property. <li> In delegated scenarios, *Privileged Authentication Administrator* is the least privileged role that's allowed to update this property for *all* administrators in the tenant. In general, the signed-in user must have a higher privileged administrator role as indicated in [Who can perform sensitive actions](../resources/users.md#who-can-perform-sensitive-actions). <li> In app-only scenarios in addition to Microsoft Graph permissions, the app must be assigned a higher privileged administrator role as indicated in [Who can perform sensitive actions](../resources/users.md#who-can-perform-sensitive-actions).|
 |passwordPolicies|String|Specifies password policies for the user. This value is an enumeration with one possible value being `DisableStrongPassword`, which allows weaker passwords than the default policy to be specified. `DisablePasswordExpiration` can also be specified. The two can be specified together; for example: `DisablePasswordExpiration, DisableStrongPassword`.|
 |passwordProfile|[passwordProfile](../resources/passwordprofile.md)|Specifies the password profile for the user. The profile contains the user's password. The password in the profile must satisfy minimum requirements as specified by the **passwordPolicies** property. By default, a strong password is required. As a best practice, always set the **forceChangePasswordNextSignIn** to `true`. This can't be used for federated users. <br><li> *User-PasswordProfile.ReadWrite.All* is the least privileged permission to update this property. <li> In delegated scenarios, the *User Administrator* [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json) is the least privileged admin role supported to update this property for nonadmin users. *Privileged Authentication Administrator* is the least privileged role that's allowed to update this property for *all* administrators in the tenant. In general, the signed-in user must have a higher privileged administrator role as indicated in [Who can reset passwords](../resources/users.md#who-can-reset-passwords). <li> In app-only scenarios, the calling app must be assigned a supported permission *and* at least the *User Administrator* [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json).|
 |pastProjects|String collection|A list for the user to enumerate their past projects.|
diff --git a/api-reference/beta/includes/permissions/mailbox-createimportsession-permissions.md b/api-reference/beta/includes/permissions/mailbox-createimportsession-permissions.md
@@ -1,11 +1,12 @@
 ---
-description: Automatically generated file. DO NOT MODIFY
+description: "Automatically generated file. DO NOT MODIFY"
 ms.topic: include
 ms.localizationpriority: medium
 ---
 
-|Permission type|Least privileged permission|Higher privileged permissions|
+|Permission type|Least privileged permissions|Higher privileged permissions|
 |:---|:---|:---|
-|Delegated (work or school account)|MailboxItem.ImportExport|Not supported.|
+|Delegated (work or school account)|MailboxItem.ImportExport|Not available.|
 |Delegated (personal Microsoft account)|Not supported.|Not supported.|
-|Application|MailboxItem.ImportExport.All|Not supported.|
+|Application|MailboxItem.ImportExport.All|Not available.|
+
diff --git a/api-reference/beta/includes/permissions/mailbox-delete-folders-permissions.md b/api-reference/beta/includes/permissions/mailbox-delete-folders-permissions.md
@@ -1,11 +1,12 @@
 ---
-description: Automatically generated file. DO NOT MODIFY
+description: "Automatically generated file. DO NOT MODIFY"
 ms.topic: include
 ms.localizationpriority: medium
 ---
 
-|Permission type|Least privileged permission|Higher privileged permissions|
+|Permission type|Least privileged permissions|Higher privileged permissions|
 |:---|:---|:---|
-|Delegated (work or school account)|MailboxFolder.Read|MailboxFolder.ReadWrite|
+|Delegated (work or school account)|MailboxFolder.ReadWrite|Not available.|
 |Delegated (personal Microsoft account)|Not supported.|Not supported.|
-|Application|MailboxFolder.Read.All|MailboxFolder.ReadWrite.All|
+|Application|MailboxFolder.ReadWrite.All|Not available.|
+
diff --git a/api-reference/beta/includes/permissions/mailbox-exportitems-permissions.md b/api-reference/beta/includes/permissions/mailbox-exportitems-permissions.md
@@ -1,11 +1,12 @@
 ---
-description: Automatically generated file. DO NOT MODIFY
+description: "Automatically generated file. DO NOT MODIFY"
 ms.topic: include
 ms.localizationpriority: medium
 ---
 
-|Permission type|Least privileged permission|Higher privileged permissions|
+|Permission type|Least privileged permissions|Higher privileged permissions|
 |:---|:---|:---|
-|Delegated (work or school account)|MailboxItem.ImportExport|Not supported.|
+|Delegated (work or school account)|MailboxItem.ImportExport|Not available.|
 |Delegated (personal Microsoft account)|Not supported.|Not supported.|
-|Application|MailboxItem.ImportExport.All|Not supported.|
+|Application|MailboxItem.ImportExport.All|Not available.|
+
diff --git a/api-reference/beta/includes/permissions/mailbox-list-folders-permissions.md b/api-reference/beta/includes/permissions/mailbox-list-folders-permissions.md
@@ -1,11 +1,12 @@
 ---
-description: Automatically generated file. DO NOT MODIFY
+description: "Automatically generated file. DO NOT MODIFY"
 ms.topic: include
 ms.localizationpriority: medium
 ---
 
-|Permission type|Least privileged permission|Higher privileged permissions|
+|Permission type|Least privileged permissions|Higher privileged permissions|
 |:---|:---|:---|
 |Delegated (work or school account)|MailboxFolder.Read|MailboxFolder.ReadWrite|
 |Delegated (personal Microsoft account)|Not supported.|Not supported.|
 |Application|MailboxFolder.Read.All|MailboxFolder.ReadWrite.All|
+
diff --git a/api-reference/beta/includes/permissions/mailbox-post-folders-permissions.md b/api-reference/beta/includes/permissions/mailbox-post-folders-permissions.md
@@ -1,11 +1,12 @@
 ---
-description: Automatically generated file. DO NOT MODIFY
+description: "Automatically generated file. DO NOT MODIFY"
 ms.topic: include
 ms.localizationpriority: medium
 ---
 
-|Permission type|Least privileged permission|Higher privileged permissions|
+|Permission type|Least privileged permissions|Higher privileged permissions|
 |:---|:---|:---|
-|Delegated (work or school account)|MailboxFolder.Read|MailboxFolder.ReadWrite|
+|Delegated (work or school account)|MailboxFolder.ReadWrite|Not available.|
 |Delegated (personal Microsoft account)|Not supported.|Not supported.|
-|Application|MailboxFolder.Read.All|MailboxFolder.ReadWrite.All|
+|Application|MailboxFolder.ReadWrite.All|Not available.|
+
diff --git a/api-reference/beta/includes/permissions/mailboxfolder-delta-permissions.md b/api-reference/beta/includes/permissions/mailboxfolder-delta-permissions.md
@@ -1,11 +1,12 @@
 ---
-description: Automatically generated file. DO NOT MODIFY
+description: "Automatically generated file. DO NOT MODIFY"
 ms.topic: include
 ms.localizationpriority: medium
 ---
 
-|Permission type|Least privileged permission|Higher privileged permissions|
+|Permission type|Least privileged permissions|Higher privileged permissions|
 |:---|:---|:---|
 |Delegated (work or school account)|MailboxFolder.Read|MailboxFolder.ReadWrite|
 |Delegated (personal Microsoft account)|Not supported.|Not supported.|
 |Application|MailboxFolder.Read.All|MailboxFolder.ReadWrite.All|
+
diff --git a/api-reference/beta/includes/permissions/mailboxfolder-get-permissions.md b/api-reference/beta/includes/permissions/mailboxfolder-get-permissions.md
@@ -1,11 +1,12 @@
 ---
-description: Automatically generated file. DO NOT MODIFY
+description: "Automatically generated file. DO NOT MODIFY"
 ms.topic: include
 ms.localizationpriority: medium
 ---
 
-|Permission type|Least privileged permission|Higher privileged permissions|
+|Permission type|Least privileged permissions|Higher privileged permissions|
 |:---|:---|:---|
 |Delegated (work or school account)|MailboxFolder.Read|MailboxFolder.ReadWrite|
 |Delegated (personal Microsoft account)|Not supported.|Not supported.|
 |Application|MailboxFolder.Read.All|MailboxFolder.ReadWrite.All|
+
diff --git a/api-reference/beta/includes/permissions/mailboxfolder-list-items-permissions.md b/api-reference/beta/includes/permissions/mailboxfolder-list-items-permissions.md
@@ -1,11 +1,12 @@
 ---
-description: Automatically generated file. DO NOT MODIFY
+description: "Automatically generated file. DO NOT MODIFY"
 ms.topic: include
 ms.localizationpriority: medium
 ---
 
-|Permission type|Least privileged permission|Higher privileged permissions|
+|Permission type|Least privileged permissions|Higher privileged permissions|
 |:---|:---|:---|
-|Delegated (work or school account)|MailboxItem.Read|Not supported.|
+|Delegated (work or school account)|MailboxItem.Read|Not available.|
 |Delegated (personal Microsoft account)|Not supported.|Not supported.|
-|Application|MailboxItem.Read.All|Not supported.|
+|Application|MailboxItem.Read.All|Not available.|
+
diff --git a/api-reference/beta/includes/permissions/mailboxfolder-update-permissions.md b/api-reference/beta/includes/permissions/mailboxfolder-update-permissions.md
diff --git a/api-reference/beta/includes/permissions/mailboxitem-delta-permissions.md b/api-reference/beta/includes/permissions/mailboxitem-delta-permissions.md
diff --git a/api-reference/beta/includes/permissions/mailboxitem-get-permissions.md b/api-reference/beta/includes/permissions/mailboxitem-get-permissions.md
diff --git a/api-reference/beta/resources/user.md b/api-reference/beta/resources/user.md
diff --git a/api-reference/v1.0/api/user-update.md b/api-reference/v1.0/api/user-update.md
diff --git a/api-reference/v1.0/resources/user.md b/api-reference/v1.0/resources/user.md
diff --git a/changelog/Manual.NonWorkloadChanges.json b/changelog/Manual.NonWorkloadChanges.json
diff --git a/concepts/whats-new-overview.md b/concepts/whats-new-overview.md

-Original file line number
+Diff line change
         "main",
         "main",
         "main",
 +        "main",
         "main"
     ],
     "json.schemas": [