Merge branch 'main' of https://github.com/microsoftgraph/microsoft-graph-docs into yizcheng/new-enum-mexico

Author: FaithOmbongi

.github/copilot-instructions.md

@@ -2,6 +2,19 @@
 
 You are a content reviewer for Microsoft Graph REST API reference documentation. Use these guidelines to review pull requests (PRs) against the Microsoft Graph documentation standards outlined in the Microsoft Graph Content Development Kit (CDK).
 
+## Additional Documentation Resources
+
+For comprehensive authoring and review guidance, reference these files located in the `.github/prompts/` folder:
+
+- **[author-api-docs.prompt.md](.github/prompts/author-api-docs.prompt.md)**: Complete authoring guidelines for creating and updating Microsoft Graph API reference documentation, including workflows for fresh APIs, promotions, and deprecations.
+- **[review-api-docs.prompt.md](.github/prompts/review-api-docs.prompt.md)**: Detailed review process guidelines that combine authoring best practices with the content standards outlined below.
+
+These files provide in-depth guidance on:
+- Documentation authoring workflows and scenarios
+- Content structure and organization requirements
+- Quality standards and validation processes
+- Common patterns and best practices specific to Microsoft Graph API documentation
+
 ## File Type Classifications
 
 This repository contains several types of files with different review requirements:

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

@@ -114,5 +114,5 @@ The following example shows the response.
 } -->
 
 ```http
-HTTP/1.1 200 Status OK
+HTTP/1.1 200 OK
 ```

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

@@ -18,7 +18,7 @@ Namespace: microsoft.graph
 
 In the Microsoft Entra [access reviews](../resources/accessreviews-root.md) feature, update an existing [accessReview](../resources/accessreview.md) object to change one or more of its properties.
 
-This API is not intended to change the reviewers or decisions of a review.  To change the reviewers, use the [addReviewer](accessreview-addreviewer.md) or [removeReviewer](accessreview-removereviewer.md) APIs.  To stop an already-started one-time review, or an already-started instance of a recurring review, early, use the [stop](accessreview-stop.md) API. To apply the decisions to the target group or app access rights, use the [apply](accessreview-apply.md) API. 
+This API is not intended to change the reviewers or decisions of a review. To change the reviewers, use the [addReviewer](accessreview-addreviewer.md) or [removeReviewer](accessreview-removereviewer.md) APIs. To stop an already-started one-time review, or an already-started instance of a recurring review, early, use the [stop](accessreview-stop.md) API. To apply the decisions to the target group or app access rights, use the [apply](accessreview-apply.md) API. 
 
 
 [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
@@ -47,14 +47,14 @@ The following table shows the properties that can be supplied when you update an
 | Property      | Type           | Description                                                                                                |
 |:--------------|:---------------|:-----------------------------------------------------------------------------------------------------------|
 | displayName   | String         | The access review name.                                                                                    |
-| startDateTime | DateTimeOffset | The DateTime when the review is scheduled to be start.  This must be a date in the future.                 |
-| endDateTime   | DateTimeOffset | The DateTime when the review is scheduled to end. This must be at least one day later than the start date. |
+| startDateTime | DateTimeOffset | The DateTime when the review is scheduled to be start. This date must be in the future.                 |
+| endDateTime   | DateTimeOffset | The DateTime when the review is scheduled to end. This date must be at least one day after the start date. |
 | description   | String         | The description, to show to the reviewers.                                                                 |
 
 
 
 ## Response
-If successful, this method returns a `204 Accepted` response code and an [accessReview](../resources/accessreview.md) object in the response body.
+If successful, this method returns a `202 Accepted` response code and an [accessReview](../resources/accessreview.md) object in the response body.
 
 ## Example
 
@@ -116,7 +116,7 @@ Content-type: application/json
   "@odata.type": "microsoft.graph.accessReview"
 } -->
 ```http
-HTTP/1.1 204 Accepted
+HTTP/1.1 202 Accepted
 Content-type: application/json
 
 {

api-reference/beta/api/accesspackageassignmentrequest-cancel.md

@@ -124,7 +124,7 @@ Content-Type: application/json
   "blockType": "response"
 } -->
 ```http
-HTTP/1.1 204 Accepted
+HTTP/1.1 202 Accepted
 ```
 
 
@@ -183,7 +183,7 @@ Content-Type: application/json
   "blockType": "response"
 } -->
 ```http
-HTTP/1.1 204 Accepted
+HTTP/1.1 202 Accepted
 ```
 
 ### Example 3: Update a applyResult on an accessReviewInstance
@@ -246,7 +246,7 @@ Content-Type: application/json
   "blockType": "response"
 } -->
 ```http
-HTTP/1.1 204 Accepted
+HTTP/1.1 202 Accepted
 ```
 
 <!--

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

@@ -192,15 +192,16 @@ Content-type: application/json
 ### Example 2: Retrieve an application by its appId and only specific properties
 
 #### Request
-The following example shows a request.
+
+The following example shows a request to retrieve an application and some of its properties.
 
 # [HTTP](#tab/http)
 <!-- {
   "blockType": "request",
   "name": "get_application_by_appId_select"
 }-->
 ```msgraph-interactive
-GET https://graph.microsoft.com/beta/applications(appId='46e6adf4-a9cf-4b60-9390-0ba6fb00bf6b')?$select=id,appId,displayName,requiredResourceAccess
+GET https://graph.microsoft.com/beta/applications(appId='46e6adf4-a9cf-4b60-9390-0ba6fb00bf6b')?$select=id,appId,displayName,signInAudience,signInAudienceRestrictions
 ```
 
 # [C#](#tab/csharp)
@@ -247,33 +248,15 @@ HTTP/1.1 200 OK
 Content-type: application/json
 
 {
-    "@odata.context": "https://graph.microsoft.com/beta/$metadata#applications(id,appId,displayName,requiredResourceAccess)/$entity",
+    "@odata.context": "https://graph.microsoft.com/beta/$metadata#applications(id,appId,displayName,signInAudience,signInAudienceRestrictions)/$entity",
     "id": "7bec5fd1-a25f-474c-a6ca-5492082c6a9b",
     "appId": "46e6adf4-a9cf-4b60-9390-0ba6fb00bf6b",
     "displayName": "PostmanWeb",
-    "requiredResourceAccess": [
-        {
-            "resourceAppId": "00000003-0000-0000-c000-000000000000",
-            "resourceAccess": [
-                {
-                    "id": "ad902697-1014-4ef5-81ef-2b4301988e8c",
-                    "type": "Scope"
-                },
-                {
-                    "id": "572fea84-0151-49b2-9301-11cb16974376",
-                    "type": "Scope"
-                },
-                {
-                    "id": "e1fe6dd8-ba31-4d61-89e7-88639da4683d",
-                    "type": "Scope"
-                },
-                {
-                    "id": "7e823077-d88e-468f-a337-e18f1f0e6c7c",
-                    "type": "Scope"
-                }
-            ]
-        }
-    ]
+    "signInAudience": "AzureADMultipleOrgs",
+    "signInAudienceRestrictions": {
+        "@odata.type": "#microsoft.graph.unrestrictedAudience",
+        "kind": "unrestricted"
+    }
 }
 ```
 

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

@@ -38,6 +38,7 @@ POST /applications
 ```
 
 ## Request headers
+
 | Name           | Description                |
 |:---------------|:---------------------------|
 |Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
@@ -55,6 +56,7 @@ If successful, this method returns `201 Created` response code and an [applicati
 ### Example 1: Create an application with the default settings
 
 #### Request
+
 The following example shows a request.
 
 # [HTTP](#tab/http)
@@ -175,6 +177,7 @@ Content-type: application/json
 ### Example 2: Create a new application and add a password secret
 
 #### Request
+
 # [HTTP](#tab/http)
 <!-- {
   "blockType": "request",
@@ -272,6 +275,68 @@ Content-type: application/json
 }
 ```
 
+### Example 3: Create a new multitenant application limited to only some tenants
+
+#### Request
+
+The following example creates a multitenant application that can only be used in two allowed Microsoft Entra tenants (and the tenant where the app is registered).
+
+<!-- {
+  "blockType": "request",
+  "name": "create_application_with_signinaudiencerestrictions"
+}-->
+```http
+POST https://graph.microsoft.com/beta/applications
+Content-type: application/json
+
+{
+  "displayName": "MyAppName",
+  "signInAudience": "AzureADMultipleOrgs",
+  "signInAudienceRestrictions": {
+    "@odata.type": "#microsoft.graph.allowedTenantsAudience",
+    "isHomeTenantAllowed": true,
+    "allowedTenantIds": [
+      "818ce016-78c2-457c-91d7-c02c2faaa5fe",
+      "c62670b0-53a1-4a38-b26c-4093cbaa510a"
+    ]
+  }
+}
+```
+
+#### Response
+
+The following example shows the response.
+
+> **Note**: The response object shown here might be shortened for readability.
+
+<!-- {
+  "blockType": "response",
+  "truncated": true,
+  "@odata.type": "microsoft.graph.application"
+} -->
+
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+    "@odata.context": "https://graph.microsoft.com/beta/$metadata#applications/$entity",
+    "id": "83ab4737-da9d-4084-86f2-f8fbec220647",
+    "appId": "9519e58c-bd06-4120-a7fd-2220d4de8409",
+    "createdDateTime": "2025-11-01T19:10:02.6626202Z",
+    "displayName": "MyAppName",
+    "signInAudience": "AzureADMultipleOrgs",
+    "signInAudienceRestrictions": {
+      "@odata.type": "#microsoft.graph.allowedTenantsAudience",
+      "isHomeTenantAllowed": true,
+      "allowedTenantIds": [
+        "818ce016-78c2-457c-91d7-c02c2faaa5fe",
+        "c62670b0-53a1-4a38-b26c-4093cbaa510a"
+      ]
+    }
+}
+```
+
 <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
 2015-10-25 14:57:30 UTC -->
 <!--
@@ -285,6 +350,3 @@ Content-type: application/json
   ]
 }
 -->
-
-
-