Update Places example and format (#28475)

Dongjing-MSIT · web-flow · commit abf08b0e6cec · 2026-03-24T10:57:40.000Z
diff --git a/api-reference/beta/api/place-delete.md b/api-reference/beta/api/place-delete.md
@@ -30,7 +30,7 @@ Choose the permission or permissions marked as least privileged for this API. Us
 <!-- { "blockType": "permissions", "name": "place_delete" } -->
 [!INCLUDE [permissions-table](../includes/permissions/place-delete-permissions.md)]
 
->**Note**: Exchange Admin role is requied to delete places.
+[!INCLUDE [rbac-places-apis-write](../includes/rbac-for-apis/rbac-places-apis-write.md)]
 
 ## HTTP request
 
diff --git a/api-reference/beta/api/place-get.md b/api-reference/beta/api/place-get.md
@@ -362,7 +362,7 @@ The following example shows a request.
 }
 -->
 ```msgraph-interactive
-GET https://graph.microsoft.com/beta/places/bldg1@contoso.com
+GET https://graph.microsoft.com/beta/places/dc404124-302a-92aa-f98d-7b4deb0c1705/microsoft.graph.roomList
 ```
 
 # [JavaScript](#tab/javascript)
@@ -385,7 +385,6 @@ HTTP/1.1 200 OK
 Content-Type: application/json
 
 {
-  "@odata.type": "#microsoft.graph.roomList",
   "id": "dc404124-302a-92aa-f98d-7b4deb0c1705",
   "displayName": "Building 1",
   "address": {
diff --git a/api-reference/beta/api/place-patch-places.md b/api-reference/beta/api/place-patch-places.md
@@ -32,6 +32,8 @@ Choose the permission or permissions marked as least privileged for this API. Us
 <!-- { "blockType": "permissions", "name": "place_patch_places" } -->
 [!INCLUDE [permissions-table](../includes/permissions/place-patch-places-permissions.md)]
 
+[!INCLUDE [rbac-places-apis-write](../includes/rbac-for-apis/rbac-places-apis-write.md)]
+
 ## HTTP request
 
 <!-- {
diff --git a/api-reference/beta/api/place-post.md b/api-reference/beta/api/place-post.md
@@ -27,7 +27,7 @@ Choose the permission or permissions marked as least privileged for this API. Us
 <!-- { "blockType": "permissions", "name": "place_post" } -->
 [!INCLUDE [permissions-table](../includes/permissions/place-post-permissions.md)]
 
->**Note**: Exchange Admin role is requied to create places.
+[!INCLUDE [rbac-places-apis-write](../includes/rbac-for-apis/rbac-places-apis-write.md)]
 
 ## HTTP request
 
diff --git a/api-reference/beta/api/place-update.md b/api-reference/beta/api/place-update.md
@@ -25,7 +25,7 @@ Choose the permission or permissions marked as least privileged for this API. Us
 <!-- { "blockType": "permissions", "name": "place_update" } -->
 [!INCLUDE [permissions-table](../includes/permissions/place-update-permissions.md)]
 
->**Note**: Exchange Admin role is requied to update places.
+[!INCLUDE [rbac-places-apis-update-known-issue](../includes/rbac-for-apis/rbac-places-apis-update-known-issue.md)]
 
 ## HTTP request
 
@@ -495,7 +495,7 @@ Content-Type: application/json
     "city": "Buffalo",
     "state": "NY",
     "postalCode": "98052",
-    "countryOrRegion": "USA"
+    "countryOrRegion": "US"
   },
   "geoCoordinates": {
     "latitude": 47.0,
@@ -604,7 +604,7 @@ Content-Type: application/json
     "city": "Buffalo",
     "state": "NY",
     "postalCode": "98052",
-    "countryOrRegion": "USA"
+    "countryOrRegion": "US"
   },
   "geoCoordinates": {
     "latitude": 47.0,
@@ -652,7 +652,7 @@ Content-Type: application/json
     "city": "Buffalo",
     "state": "NY",
     "postalCode": "98052",
-    "countryOrRegion": "USA"
+    "countryOrRegion": "US"
   },
   "geoCoordinates": {
     "altitude": null,
@@ -720,7 +720,7 @@ Content-Type: application/json
     "city": "Buffalo",
     "state": "NY",
     "postalCode": "98052",
-    "countryOrRegion": "USA"
+    "countryOrRegion": "US"
   },
   "geoCoordinates": {
     "altitude": null,
diff --git a/api-reference/beta/includes/rbac-for-apis/rbac-places-apis-update-known-issue.md b/api-reference/beta/includes/rbac-for-apis/rbac-places-apis-update-known-issue.md
@@ -0,0 +1,9 @@
+---
+author: Dongjing-MSIT
+ms.topic: include
+---
+
+> [!IMPORTANT]
+> In delegated scenarios with work or school accounts, the signed-in user must be assigned a supported [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json) or a custom role with a supported role permission. *Exchange Administrator* is the least privileged role supported for this operation.
+
+> **Known issue:** Update requests may still succeed without the role assignment but result in unexpected behaviors.
diff --git a/api-reference/beta/includes/rbac-for-apis/rbac-places-apis-write.md b/api-reference/beta/includes/rbac-for-apis/rbac-places-apis-write.md
@@ -0,0 +1,7 @@
+---
+author: Dongjing-MSIT
+ms.topic: include
+---
+
+> [!IMPORTANT]
+> In delegated scenarios with work or school accounts, the signed-in user must be assigned a supported [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json) or a custom role with a supported role permission. *Exchange Administrator* is the least privileged role supported for this operation.
diff --git a/api-reference/v1.0/api/place-delete.md b/api-reference/v1.0/api/place-delete.md
@@ -28,7 +28,7 @@ Choose the permission or permissions marked as least privileged for this API. Us
 <!-- { "blockType": "permissions", "name": "place_delete" } -->
 [!INCLUDE [permissions-table](../includes/permissions/place-delete-permissions.md)]
 
->**Note**: Exchange Admin role is requied to delete places.
+[!INCLUDE [rbac-places-apis-write](../includes/rbac-for-apis/rbac-places-apis-write.md)]
 
 ## HTTP request
 
diff --git a/api-reference/v1.0/api/place-get.md b/api-reference/v1.0/api/place-get.md
@@ -357,7 +357,7 @@ The following example shows a request.
 }
 -->
 ``` http
-GET https://graph.microsoft.com/v1.0/places/bldg1@contoso.com
+GET https://graph.microsoft.com/v1.0/places/dc404124-302a-92aa-f98d-7b4deb0c1705/microsoft.graph.roomList
 ```
 
 # [JavaScript](#tab/javascript)
@@ -381,7 +381,6 @@ HTTP/1.1 200 OK
 Content-Type: application/json
 
 {
-  "@odata.type": "#microsoft.graph.roomList",
   "id": "dc404124-302a-92aa-f98d-7b4deb0c1705",
   "displayName": "Building 1",
   "address": {
diff --git a/api-reference/v1.0/api/place-post.md b/api-reference/v1.0/api/place-post.md
@@ -25,7 +25,7 @@ Choose the permission or permissions marked as least privileged for this API. Us
 <!-- { "blockType": "permissions", "name": "place_post" } -->
 [!INCLUDE [permissions-table](../includes/permissions/place-post-permissions.md)]
 
->**Note**: Exchange Admin role is requied to create places.
+[!INCLUDE [rbac-places-apis-write](../includes/rbac-for-apis/rbac-places-apis-write.md)]
 
 ## HTTP request
 
diff --git a/api-reference/v1.0/api/place-update.md b/api-reference/v1.0/api/place-update.md
@@ -23,7 +23,7 @@ Choose the permission or permissions marked as least privileged for this API. Us
 <!-- { "blockType": "permissions", "name": "place_update" } -->
 [!INCLUDE [permissions-table](../includes/permissions/place-update-permissions.md)]
 
->**Note**: Exchange Admin role is requied to update places.
+[!INCLUDE [rbac-places-apis-update-known-issue](../includes/rbac-for-apis/rbac-places-apis-update-known-issue.md)]
 
 ## HTTP request
 
@@ -503,7 +503,7 @@ Content-Type: application/json
     "city": "Buffalo",
     "state": "NY",
     "postalCode": "98052",
-    "countryOrRegion": "USA"
+    "countryOrRegion": "US"
   },
   "geoCoordinates": {
     "latitude": 47.0,
@@ -614,7 +614,7 @@ Content-Type: application/json
     "city": "Buffalo",
     "state": "NY",
     "postalCode": "98052",
-    "countryOrRegion": "USA"
+    "countryOrRegion": "US"
   },
   "geoCoordinates": {
     "latitude": 47.0,
@@ -662,7 +662,7 @@ Content-Type: application/json
     "city": "Buffalo",
     "state": "NY",
     "postalCode": "98052",
-    "countryOrRegion": "USA"
+    "countryOrRegion": "US"
   },
   "geoCoordinates": {
     "altitude": null,
@@ -732,7 +732,7 @@ Content-Type: application/json
     "city": "Buffalo",
     "state": "NY",
     "postalCode": "98052",
-    "countryOrRegion": "USA"
+    "countryOrRegion": "US"
   },
   "geoCoordinates": {
     "altitude": null,
diff --git a/api-reference/v1.0/includes/rbac-for-apis/rbac-places-apis-update-known-issue.md b/api-reference/v1.0/includes/rbac-for-apis/rbac-places-apis-update-known-issue.md
@@ -0,0 +1,9 @@
+---
+author: Dongjing-MSIT
+ms.topic: include
+---
+
+> [!IMPORTANT]
+> In delegated scenarios with work or school accounts, the signed-in user must be assigned a supported [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json) or a custom role with a supported role permission. *Exchange Administrator* is the least privileged role supported for this operation.
+
+> **Known issue:** Update requests may still succeed without the role assignment but result in unexpected behaviors.
diff --git a/api-reference/v1.0/includes/rbac-for-apis/rbac-places-apis-write.md b/api-reference/v1.0/includes/rbac-for-apis/rbac-places-apis-write.md
@@ -0,0 +1,7 @@
+---
+author: Dongjing-MSIT
+ms.topic: include
+---
+
+> [!IMPORTANT]
+> In delegated scenarios with work or school accounts, the signed-in user must be assigned a supported [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json) or a custom role with a supported role permission. *Exchange Administrator* is the least privileged role supported for this operation.
diff --git a/concepts/whats-new-overview.md b/concepts/whats-new-overview.md
@@ -78,6 +78,10 @@ For more information, see [Get change notifications for transcripts and recordin
 
 The new Tenant Configuration Management APIs in Microsoft Graph allow administrators to control and manage configuration settings across a single workload or multiple workloads within an organization. To learn more about supported use cases, see [Use the Tenant Configuration Management APIs in Microsoft Graph](/graph/api/resources/unified-tenant-configuration-management-api-overview).
 
+### Calendars | Places
+
+Added a known issue of RBAC in [Places update API](/graph/api/place-update): update requests may still succeed without *Exchange Administrator* role but result in unexpected behaviors.
+
 ## March 2026: New in preview only
 
 ### Applications
@@ -149,6 +153,10 @@ Introduced the tenant governance API set to enable organizations to manage and g
 
 For more information, see [Overview of Tenant Governance APIs](/graph/api/resources/tenantgovernanceservices-tenantgovernance-overview).
 
+### Calendars | Places
+
+Added a known issue of RBAC in [Places update API](/graph/api/place-update?view=graph-rest-beta&preserve-view=true): update requests may still succeed without *Exchange Administrator* role but result in unexpected behaviors.
+
 ## February 2026: New and generally available
 
 ### External data connections

Original file line number	Diff line number	Diff line change
`@@ -362,7 +362,7 @@ The following example shows a request.`
`362`	`362`	`}`
`363`	`363`	`-->`
`364`	`364`	```msgraph-interactive
`365`		`-GET https://graph.microsoft.com/beta/places/bldg1@contoso.com`
	`365`	`+GET https://graph.microsoft.com/beta/places/dc404124-302a-92aa-f98d-7b4deb0c1705/microsoft.graph.roomList`
`366`	`366`	```
`367`	`367`
`368`	`368`	`# [JavaScript](#tab/javascript)`
`@@ -385,7 +385,6 @@ HTTP/1.1 200 OK`
`385`	`385`	`Content-Type: application/json`
`386`	`386`
`387`	`387`	`{`
`388`		`- "@odata.type": "#microsoft.graph.roomList",`
`389`	`388`	`"id": "dc404124-302a-92aa-f98d-7b4deb0c1705",`
`390`	`389`	`"displayName": "Building 1",`
`391`	`390`	`"address": {`
Original file line number	Diff line number	Diff line change
`@@ -357,7 +357,7 @@ The following example shows a request.`
`357`	`357`	`}`
`358`	`358`	`-->`
`359`	`359`	``` http
`360`		`-GET https://graph.microsoft.com/v1.0/places/bldg1@contoso.com`
	`360`	`+GET https://graph.microsoft.com/v1.0/places/dc404124-302a-92aa-f98d-7b4deb0c1705/microsoft.graph.roomList`
`361`	`361`	```
`362`	`362`
`363`	`363`	`# [JavaScript](#tab/javascript)`
`@@ -381,7 +381,6 @@ HTTP/1.1 200 OK`
`381`	`381`	`Content-Type: application/json`
`382`	`382`
`383`	`383`	`{`
`384`		`- "@odata.type": "#microsoft.graph.roomList",`
`385`	`384`	`"id": "dc404124-302a-92aa-f98d-7b4deb0c1705",`
`386`	`385`	`"displayName": "Building 1",`
`387`	`386`	`"address": {`