Merge branch 'main' of https://github.com/microsoftgraph/microsoft-graph-docs

Author: OWinfreyATL

.github/prompts/review-api-docs.prompt.md

@@ -143,7 +143,16 @@ Reference the [copilot-instructions.md](.github/copilot-instructions.md) file fo
 - Changelog files validation
 - Version-specific guidelines (v1.0 vs beta)
 
----
+Reference the [author-api-docs.prompt.md](.github/prompts/author-api-docs.prompt.md) file for quality checklist items related to the different scenarios:
+- [Quality checklist](author-api-docs.prompt.md#author-api-docs.prompt.md#quality-checklist-1)
+- [Promotion from beta to v1.0](author-api-docs.prompt.md#quality-checklist-for-promotion-scenarios)
+- [Deprecation scenarios](author-api-docs.prompt.md#quality-checklist)
+- Documentation standards to follow for:
+  - [General guidelines](author-api-docs.prompt.md#general-guidelines)
+  - [API method reference files](author-api-docs.prompt.md#api-method-reference-files)
+  - [Resource reference files](author-api-docs.prompt.md#resource-reference-files)
+  - [Version-specific guidelines](author-api-docs.prompt.md#version-specific-guidelines)
+  - [General rules (applies to both resource and API files)](author-api-docs.prompt.md#general-rules-applies-to-both-resource-and-api-files)
 
 ## File Type-Specific Review Checklist
 

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

@@ -1,19 +1,22 @@
 ---
-title: "Get alert"
+title: "Get alert (deprecated)"
 description: "Retrieve the properties and relationships of an alert object"
 ms.localizationpriority: medium
 author: "preetikr"
 ms.subservice: "security"
 doc_type: apiPageType
 ms.date: 04/05/2024
+ROBOTS: NOINDEX
 ---
 
-# Get alert
+# Get alert (deprecated)
 
 Namespace: microsoft.graph
 
  [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
 
+[!INCLUDE [security-alerts-v1-deprecation](../includes/security-alerts-v1-deprecation.md)]
+
 Retrieve the properties and relationships of an [alert](../resources/alert.md) object.
 
 [!INCLUDE [national-cloud-support](../../includes/global-us.md)]

api-reference/beta/api/alert-list.md

@@ -1,19 +1,22 @@
 ---
-title: "List alerts"
+title: "List alerts (deprecated)"
 description: "Retrieve a list of alert objects."
 ms.localizationpriority: medium
 author: "preetikr"
 ms.subservice: "security"
 doc_type: apiPageType
 ms.date: 04/05/2024
+ROBOTS: NOINDEX
 ---
 
-# List alerts
+# List alerts (deprecated)
 
 Namespace: microsoft.graph
 
  [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
 
+[!INCLUDE [security-alerts-v1-deprecation](../includes/security-alerts-v1-deprecation.md)]
+
 Retrieve a list of [alert](../resources/alert.md) objects.
 
 [!INCLUDE [national-cloud-support](../../includes/global-us.md)]

api-reference/beta/api/alert-update.md

@@ -1,19 +1,22 @@
 ---
-title: "Update alert"
+title: "Update alert (deprecated)"
 description: "Update an editable alert property within any integrated solution to keep alert status and assignments in sync across solutions."
 ms.localizationpriority: medium
 author: "preetikr"
 ms.subservice: "security"
 doc_type: apiPageType
 ms.date: 04/05/2024
+ROBOTS: NOINDEX
 ---
 
-# Update alert
+# Update alert (deprecated)
 
 Namespace: microsoft.graph
 
 [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
 
+[!INCLUDE [security-alerts-v1-deprecation](../includes/security-alerts-v1-deprecation.md)]
+
 Update an editable **alert** property within any integrated solution to keep alert status and assignments in sync across solutions. This method updates any solution that has a record of the referenced alert ID.
 
 [!INCLUDE [national-cloud-support](../../includes/global-us.md)]
@@ -43,7 +46,7 @@ PATCH /security/alerts/{alert_id}
 
 ## Request body
 
-In the request body, supply a JSON representation of the values for relevant fields that should be updated. The body **must** contain the **vendorInformation** property with valid `provider` and `vendor` fields. The following table lists the fields that can be updated for an alert. The values for existing properties that are not included in the request body will not change. For best performance, don't include existing values that haven't changed.
+[!INCLUDE [table-intro](../../includes/update-property-table-intro.md)]
 
 | Property   | Type |Description|
 |:---------------|:--------|:----------|
@@ -128,7 +131,7 @@ Content-type: application/json
 
 #### Response
 
-The following is an example of a successful response.
+The following example shows a successful response.
 <!-- {
   "blockType": "response"
 } -->
@@ -202,7 +205,7 @@ Prefer: return=representation
 
 #### Response
 
-The following is an example of the response when the optional `Prefer: return=representation` request header is used.
+The following example shows a response when the optional `Prefer: return=representation` request header is used.
 
 >**Note:** The response object shown here might be shortened for readability.
 <!-- {

api-reference/beta/api/alert-updatealerts.md

@@ -1,19 +1,22 @@
 ---
-title: "alert: updateAlerts"
+title: "alert: updateAlerts (deprecated)"
 description: "Update multiple alerts in one request instead of multiple requests."
 ms.localizationpriority: medium
 author: "preetikr"
 ms.subservice: "security"
 doc_type: apiPageType
 ms.date: 08/13/2024
+ROBOTS: NOINDEX
 ---
 
-# alert: updateAlerts
+# alert: updateAlerts (deprecated)
 
 Namespace: microsoft.graph
 
 [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
 
+[!INCLUDE [security-alerts-v1-deprecation](../includes/security-alerts-v1-deprecation.md)]
+
 Update multiple alerts in one request instead of multiple requests.
 
 [!INCLUDE [national-cloud-support](../../includes/global-only.md)]

api-reference/beta/api/authentication-delete-externalauthenticationmethods.md

@@ -27,7 +27,7 @@ Choose the permission or permissions marked as least privileged for this API. Us
 
 ## HTTP request
 
-To delete another user's external authentication method:
+To delete another user's external MFA:
 <!-- { "blockType": "ignored" } -->
 ```http
 DELETE /users/{usersId}/authentication/externalAuthenticationMethods/{externalAuthenticationMethodId}/$ref

api-reference/beta/api/authentication-list-externalauthenticationmethods.md

@@ -45,7 +45,7 @@ Choose the permission or permissions marked as least privileged for this API. Us
 
 ## HTTP request
 
-To retrieve details of your own external authentication methods:
+To retrieve details of your own external MFA:
 
 [!INCLUDE [me-apis-sign-in-note](../includes/me-apis-sign-in-note.md)]
 
@@ -54,7 +54,7 @@ To retrieve details of your own external authentication methods:
 GET /me/authentication/externalAuthenticationMethods
 ```
 
-To retrieve details of your own or another user's external authentication methods:
+To retrieve details of your own or another user's external MFA:
 
 [!INCLUDE [authentication-methods-apis-users-selfservice](../includes/authentication-methods-apis-users-selfservice.md)]
 

api-reference/beta/api/authentication-post-externalauthenticationmethods.md

@@ -29,7 +29,7 @@ Choose the permission or permissions marked as least privileged for this API. Us
 
 ## HTTP request
 
-Assign an external authentication method to another user. This API doesn't support self-service operations.
+Assign an external MFA to another user. This API doesn't support self-service operations.
 <!-- { "blockType": "ignored" } -->
 ```http
 POST /users/{usersId}/authentication/externalAuthenticationMethods
@@ -51,7 +51,7 @@ You can specify the following properties when creating an **externalAuthenticati
 |Property|Type|Description|
 |:---|:---|:---|
 |configurationId|String|A unique identifier used to manage and integrate external auth methods within Microsoft Entra ID. Required.|
-|displayName|String|Custom name given to the registered external authentication method. Required.|
+|displayName|String|Custom name given to the registered external MFA. Required.|
 
 
 

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

@@ -26,8 +26,6 @@ Choose the permission or permissions marked as least privileged for this API. Us
 <!-- { "blockType": "permissions", "name": "authorizationpolicy_get" } -->
 [!INCLUDE [permissions-table](../includes/permissions/authorizationpolicy-get-permissions.md)]
 
-[!INCLUDE [rbac-authorization-policy-apis-read](../includes/rbac-for-apis/rbac-authorization-policy-apis-read.md)]
-
 ## HTTP request
 
 <!-- { "blockType": "ignored" } -->

api-reference/beta/api/backuprestoreroot-list-protectionpolicies.md

@@ -144,6 +144,7 @@ Content-Location: https://graph.microsoft.com/beta/solutions/backupRestore/Prote
         }
       },
       "lastModifiedDateTime": "2015-06-19T12:01:03.45Z",
+      "offboardRequestedDateTime": "2015-06-20T09:30:00Z",
       "retentionSettings": [
         {
           "interval": "R/PT10M",
@@ -185,6 +186,7 @@ Content-Location: https://graph.microsoft.com/beta/solutions/backupRestore/Prote
         }
       },
       "lastModifiedDateTime": "2015-06-19T12:01:03.45Z",
+      "offboardRequestedDateTime": "2016-01-01T00:00:00Z",
       "retentionSettings": [
         {
           "interval": "R/PT10M",
@@ -226,6 +228,7 @@ Content-Location: https://graph.microsoft.com/beta/solutions/backupRestore/Prote
         }
       },
       "lastModifiedDateTime": "2015-06-19T12:01:03.45Z",
+      "offboardRequestedDateTime": "2024-01-15T10:00:00Z",
       "retentionSettings": [
         {
           "interval": "R/PT10M",