Merge pull request #28649 from microsoftgraph/main

Danipocket · web-flow · commit ca2079d71a9e · 2026-04-13T17:21:24.000-06:00
Merge to publish
diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md
diff --git a/.github/prompts/author-api-docs/enumerations.md b/.github/prompts/author-api-docs/enumerations.md
@@ -126,7 +126,8 @@ Create a dedicated topic for the enumeration. This option is rarely applicable.
 
 1. **Create enum topic:**
    - Title: "{enum-type} enum type"
-   - Single sentence describing the enum's purpose
+   - doc_type: "enumPageType"
+   - Single sentence describing the enum's purpose, linking to consuming resource(s)
    - **For flagged enums:** Append "This flagged enumeration allows multiple members to be selected simultaneously." to the introductory text.
    - **For evolvable enums:** Mention it's an evolvable enumeration
 
diff --git a/api-reference/beta/api/authentication-list-externalauthenticationmethods.md b/api-reference/beta/api/authentication-list-externalauthenticationmethods.md
@@ -16,7 +16,7 @@ Namespace: microsoft.graph
 
 Get a list of the [externalAuthenticationMethod](../resources/externalauthenticationmethod.md) objects and their properties.
 
-[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
+[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
 
 ## Permissions
 
diff --git a/api-reference/beta/api/authentication-post-externalauthenticationmethods.md b/api-reference/beta/api/authentication-post-externalauthenticationmethods.md
@@ -16,7 +16,7 @@ Namespace: microsoft.graph
 
 Create a new [externalAuthenticationMethod](../resources/externalauthenticationmethod.md) object. This API doesn't support self-service operations.
 
-[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
+[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
 
 ## Permissions
 
diff --git a/api-reference/beta/api/chat-delete-targetedmessages.md b/api-reference/beta/api/chat-delete-targetedmessages.md
@@ -16,6 +16,8 @@ Namespace: microsoft.graph
 
 Delete a specific [targeted message](../resources/targetedchatmessage.md) from a chat context. Teams administrators can use this API to remove targeted messages from group chats.
 
+[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
+
 ## Permissions
 
 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).
diff --git a/api-reference/beta/api/entitlementmanagement-list-externaloriginresourceconnectors.md b/api-reference/beta/api/entitlementmanagement-list-externaloriginresourceconnectors.md
@@ -16,6 +16,8 @@ Namespace: microsoft.graph
 
 Get a list of [externalOriginResourceConnector](../resources/externaloriginresourceconnector.md) objects and their properties.
 
+[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
+
 ## Permissions
 
 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).
diff --git a/api-reference/beta/api/entitlementmanagement-post-externaloriginresourceconnectors.md b/api-reference/beta/api/entitlementmanagement-post-externaloriginresourceconnectors.md
@@ -16,6 +16,8 @@ Namespace: microsoft.graph
 
 Creates a new [externalOriginResourceConnector](../resources/externaloriginresourceconnector.md) object.
 
+[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
+
 ## Permissions
 
 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).
diff --git a/api-reference/beta/api/externalauthenticationmethod-get.md b/api-reference/beta/api/externalauthenticationmethod-get.md
@@ -16,7 +16,7 @@ Namespace: microsoft.graph
 
 Read the properties and relationships of an [externalAuthenticationMethod](../resources/externalauthenticationmethod.md) object.
 
-[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
+[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
 
 ## Permissions
 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).
diff --git a/api-reference/beta/api/externaloriginresourceconnector-delete.md b/api-reference/beta/api/externaloriginresourceconnector-delete.md
@@ -16,6 +16,8 @@ Namespace: microsoft.graph
 
 Delete an [externalOriginResourceConnector](../resources/externaloriginresourceconnector.md) object.
 
+[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
+
 ## Permissions
 
 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).
diff --git a/api-reference/beta/api/externaloriginresourceconnector-get.md b/api-reference/beta/api/externaloriginresourceconnector-get.md
@@ -16,6 +16,8 @@ Namespace: microsoft.graph
 
 Read the properties and relationships of [externalOriginResourceConnector](../resources/externaloriginresourceconnector.md) object.
 
+[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
+
 ## Permissions
 
 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).
diff --git a/api-reference/beta/api/externaloriginresourceconnector-update.md b/api-reference/beta/api/externaloriginresourceconnector-update.md
@@ -16,6 +16,8 @@ Namespace: microsoft.graph
 
 Update the properties of an [externalOriginResourceConnector](../resources/externaloriginresourceconnector.md) object.
 
+[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
+
 ## Permissions
 
 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).
diff --git a/api-reference/beta/api/intune-androidforwork-androidappconfigurationschema-get.md b/api-reference/beta/api/intune-androidforwork-androidappconfigurationschema-get.md
@@ -95,4 +95,4 @@ Content-Length: 813
     ]
   }
 }
-```
+```
diff --git a/api-reference/beta/api/intune-androidforwork-androidappconfigurationschema-retrieveschema.md b/api-reference/beta/api/intune-androidforwork-androidappconfigurationschema-retrieveschema.md
@@ -1,4 +1,4 @@
-﻿---
+---
 title: "retrieveSchema action"
 description: "Retrieves the managed application configurations schema for the specified Android app."
 author: "jaiprakashmb"
@@ -110,4 +110,4 @@ Content-Length: 813
     ]
   }
 }
-```
+```
diff --git a/api-reference/beta/api/intune-androidforwork-androidappconfigurationschema-update.md b/api-reference/beta/api/intune-androidforwork-androidappconfigurationschema-update.md
@@ -128,4 +128,4 @@ Content-Length: 748
     }
   ]
 }
-```
+```
diff --git a/api-reference/beta/api/plannertask-post-messages.md b/api-reference/beta/api/plannertask-post-messages.md
@@ -16,6 +16,9 @@ Namespace: microsoft.graph
 
 Create a new [plannerTaskChatMessage](../resources/plannertaskchatmessage.md) on a [plannerTask](../resources/plannertask.md).
 
+> [!IMPORTANT]
+> This method only supports creating a new chat message on a [plannerTask](../resources/plannertask.md) that already has at least one existing message.
+
 [!INCLUDE [national-cloud-support](../../includes/global-only.md)]
 
 ## Permissions
diff --git a/api-reference/beta/api/userteamwork-deletetargetedmessage.md b/api-reference/beta/api/userteamwork-deletetargetedmessage.md
@@ -16,6 +16,8 @@ Namespace: microsoft.graph
 
 Delete a specific [targeted message](../resources/targetedchatmessage.md) from a channel context. Teams administrators can use this API to remove targeted messages by providing the message ID, team ID, and channel ID.
 
+[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
+
 ## Permissions
 
 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).
diff --git a/api-reference/beta/api/userteamwork-getallretainedtargetedmessages.md b/api-reference/beta/api/userteamwork-getallretainedtargetedmessages.md
@@ -16,6 +16,8 @@ Namespace: microsoft.graph
 
 Get all retained [targeted messages](../resources/targetedchatmessage.md) sent to a specific user in group chats and channels.
 
+[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
+
 ## Permissions
 
 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).
diff --git a/api-reference/beta/api/userteamwork-getalltargetedmessages.md b/api-reference/beta/api/userteamwork-getalltargetedmessages.md
@@ -16,6 +16,8 @@ Namespace: microsoft.graph
 
 Get all [targeted messages](../resources/targetedchatmessage.md) sent to a specific user in group chats and channels.
 
+[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
+
 ## Permissions
 
 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).
diff --git a/api-reference/beta/resources/security-sensorcandidate.md b/api-reference/beta/resources/security-sensorcandidate.md
@@ -16,7 +16,7 @@ Namespace: microsoft.graph.security
 
 Represents a Microsoft Defender for Identity sensor that's ready to be activated.
 
-Inherits from [microsoft.graph.entity](../resources/entity.md).
+Inherits from [entity](../resources/entity.md).
 
 ## Methods
 |Method| Return type                                                                                      |Description|
@@ -32,7 +32,7 @@ Inherits from [microsoft.graph.entity](../resources/entity.md).
 |id| String                                                              | The unique identifier for the sensor candidate. Inherited from [microsoft.graph.entity](../resources/entity.md). Inherits from [entity](../resources/entity.md) |
 |lastSeenDateTime| DateTimeOffset                                                      | The date and time when the sensor was last seen.                                                                                                                |
 |senseClientVersion| String                                                              | The version of the Defender for Identity sensor client.  Supports `$filter` (`eq`).                                                                             |
-|sensorTypes| microsoft.graph.security.deviceType | The list of device type of the sensor. The possible values are: `domainController`, `adfs`,, `adcs`, `entraConnect` `unknownFutureValue`. This flagged enumeration allows multiple members to be returned simultaneously.                       |
+|sensorTypes| microsoft.graph.security.deviceType | The list of device types for the sensor. The possible values are: `domainController`, `adfs`, `adcs`, `entraConnect` `unknownFutureValue`. This flagged enumeration allows multiple members to be returned simultaneously.                       |
 
 
 ## Relationships
diff --git a/api-reference/beta/toc/tenants/toc.yml b/api-reference/beta/toc/tenants/toc.yml
@@ -70,7 +70,7 @@ items:
       href: ../../api/tenantgovernanceservices-tenantgovernancesetting-get.md
     - name: Update
       href: ../../api/tenantgovernanceservices-tenantgovernancesetting-update.md
-    - name: enableRelatedTenants
+    - name: Enable related tenants
       href: ../../api/tenantgovernanceservices-tenantgovernancesetting-enablerelatedtenants.md
   - name: Related tenant
     items:
diff --git a/api-reference/v1.0/api/bookingappointment-update.md b/api-reference/v1.0/api/bookingappointment-update.md
@@ -83,12 +83,15 @@ If successful, this method returns a `204 No Content` response code. It doesn't
 
 ## Examples
 
-### Request
+### Example 1: Change the date of service
+
+#### Request
 
 The following example changes the date of service by a day.
 
 <!-- {
   "blockType": "request",
+  "name": "update_bookingappointment_date",
   "sampleKeys": ["AAMkADKnAAA=", "Contosolunchdelivery@contoso.com"]
 }-->
 ```http
@@ -110,7 +113,59 @@ Content-type: application/json
 }
 ```
 
-### Response
+#### Response
+
+The following example shows the response.
+<!-- {
+  "blockType": "response"
+} -->
+```http
+HTTP/1.1 204 No Content
+```
+
+### Example 2: Update the customers for an appointment
+
+The following example updates the customers array for a multi-customer appointment. The **customers** property is a full replacement array — include all customers that should be part of the appointment, not just the new ones.
+
+> [!NOTE]
+> - Each object in the **customers** array must include `@odata.type` set to `#microsoft.graph.bookingCustomerInformation`. Omitting this property causes the request to fail.
+> - Include customer details such as **name**, **emailAddress**, and **phone** for each entry. The API does not automatically populate these fields from the **customerId** — if omitted, they will be blank on the appointment.
+> - The **customerId** must reference a valid [bookingCustomer](../resources/bookingcustomer.md) that exists in the Booking Calendar. If it doesn't exist, create one using the [Create bookingCustomer](bookingbusiness-post-customers.md) operation.
+> - The associated [bookingService](../resources/bookingservice.md) must have **maximumAttendeesCount** greater than 1 to support multiple customers.
+
+#### Request
+
+<!-- {
+  "blockType": "request",
+  "name": "update_bookingappointment_customers",
+  "sampleKeys": ["AAMkADKoAAA=", "Contosolunchdelivery@contoso.com"]
+}-->
+```http
+PATCH https://graph.microsoft.com/v1.0/solutions/bookingBusinesses/Contosolunchdelivery@contoso.com/appointments/AAMkADKoAAA=
+Content-type: application/json
+
+{
+    "@odata.type":"#microsoft.graph.bookingAppointment",
+    "customers": [
+        {
+            "@odata.type": "#microsoft.graph.bookingCustomerInformation",
+            "customerId": "cd56bb19-c348-42c6-af5c-09818c87fb8c",
+            "name": "John Doe",
+            "emailAddress": "john.doe@example.com",
+            "phone": "313-555-5555"
+        },
+        {
+            "@odata.type": "#microsoft.graph.bookingCustomerInformation",
+            "customerId": "72f148fa-9a86-4c59-b277-f5089d9ea0e7",
+            "name": "Jane Smith",
+            "emailAddress": "jane.smith@example.com",
+            "phone": "248-555-5678"
+        }
+    ]
+}
+```
+
+#### Response
 
 The following example shows the response.
 <!-- {
diff --git a/api-reference/v1.0/api/channel-list-enabledapps.md b/api-reference/v1.0/api/channel-list-enabledapps.md
@@ -14,7 +14,7 @@ Namespace: microsoft.graph
 
 Get a list of the [enabled apps](../resources/teamsapp.md) in the specified [channel](../resources/channel.md) within a [team](../resources/team.md).
 
-[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
+[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
 
 ## Permissions
 
diff --git a/api-reference/v1.0/api/chat-list.md b/api-reference/v1.0/api/chat-list.md
@@ -17,7 +17,7 @@ Retrieve the list of [chats](../resources/chat.md) that the user is part of.
 This method supports federation. When a user ID is provided, the calling application must belong to the same tenant that the user belongs to.
 
 > [!NOTE]
-> This API has a [known issue](https://microsoftgraph.visualstudio.com/Known%20Issues/_workitems/edit/40947). When this API is called with the `$expand=members` query parameter, the response returns a maximum of **25 member items**, even if a larger `$top` value is specified. This behavior differs from the expected behavior where the `$top` parameter controls the maximum number of items returned. As a result, applications that rely on `$expand=members` might not retrieve the full list of members in a single request.
+> This API currently has the following limitation: when the API is called with the `$expand=members` query parameter, the response returns a maximum of **25 member items**, even if a larger `$top` value is specified. This behavior differs from the expected behavior where the `$top` parameter controls the maximum number of items returned. As a result, applications that rely on `$expand=members` might not retrieve the full list of members in a single request.
 > The API also behaves differently in one or more national clouds. For more information, see [Implementation differences in national clouds](/graph/teamwork-national-cloud-differences).
 
 [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
diff --git a/api-reference/v1.0/api/peopleadminsettings-list-profilepropertysettings.md b/api-reference/v1.0/api/peopleadminsettings-list-profilepropertysettings.md
@@ -14,6 +14,8 @@ Namespace: microsoft.graph
 
 Get a collection of [profilePropertySetting](../resources/profilepropertysetting.md) objects that define the configuration for user profile properties in an organization. The **id** property identifies each resource object uniquely.
 
+[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
+
 ## Permissions
 
 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).
diff --git a/api-reference/v1.0/api/peopleadminsettings-post-profilepropertysettings.md b/api-reference/v1.0/api/peopleadminsettings-post-profilepropertysettings.md
@@ -14,6 +14,8 @@ Namespace: microsoft.graph
 
 Create a new [profilePropertySetting](../resources/profilepropertysetting.md) object.
 
+[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
+
 ## Permissions
 
 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).
diff --git a/api-reference/v1.0/api/profilepropertysetting-get.md b/api-reference/v1.0/api/profilepropertysetting-get.md
@@ -14,6 +14,8 @@ Namespace: microsoft.graph
 
 Read the properties and relationships of [profilePropertySetting](../resources/profilepropertysetting.md) object.
 
+[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
+
 ## Permissions
 
 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).
diff --git a/api-reference/v1.0/api/profilepropertysetting-update.md b/api-reference/v1.0/api/profilepropertysetting-update.md
@@ -16,6 +16,8 @@ Namespace: microsoft.graph
 
 Update the properties of a [profilePropertySetting](../resources/profilepropertysetting.md) object.
 
+[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
+
 ## Permissions
 
 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).
diff --git a/api-reference/v1.0/api/security-autoauditingconfiguration-get.md b/api-reference/v1.0/api/security-autoauditingconfiguration-get.md
diff --git a/api-reference/v1.0/api/security-autoauditingconfiguration-update.md b/api-reference/v1.0/api/security-autoauditingconfiguration-update.md
diff --git a/api-reference/v1.0/api/sensitivitylabel-computerightsandinheritance.md b/api-reference/v1.0/api/sensitivitylabel-computerightsandinheritance.md
diff --git a/api-reference/v1.0/api/sensitivitylabel-get.md b/api-reference/v1.0/api/sensitivitylabel-get.md
diff --git a/api-reference/v1.0/api/teamsapp-get.md b/api-reference/v1.0/api/teamsapp-get.md
diff --git a/api-reference/v1.0/api/tenantdatasecurityandgovernance-list-sensitivitylabels.md b/api-reference/v1.0/api/tenantdatasecurityandgovernance-list-sensitivitylabels.md
diff --git a/api-reference/v1.0/api/usagerightsincluded-get.md b/api-reference/v1.0/api/usagerightsincluded-get.md
diff --git a/api-reference/v1.0/includes/permissions/security-autoauditingconfiguration-get-permissions.md b/api-reference/v1.0/includes/permissions/security-autoauditingconfiguration-get-permissions.md
diff --git a/concepts/whats-new-overview.md b/concepts/whats-new-overview.md
