Merge pull request #27993 from microsoftgraph/main

Auto Publish – main to live - 2025-12-27 00:30 UTC

Author: learn-build-service-prod[bot]

api-reference/beta/resources/desk.md

@@ -34,7 +34,7 @@ For the list of supported methods, see [place](./place.md).
 |isWheelChairAccessible|Boolean|Indicates whether the **desk** is wheelchair accessible. Inherited from [place](./place.md).|
 |label |String |User-defined description of the **desk**. Inherited from [place](../resources/place.md).|
 |mailboxDetails |[mailboxDetails](mailboxdetails.md) |The mailbox object **id** and email address that are associated with the desk. |
-|mode |[placeMode](./placemode.md) |The mode of the desk. The supported modes are:<ul><li>[assignedPlaceMode](./assignedplacemode.md) - Desks that are assigned to a user.</li><li>[reservablePlaceMode](./reservableplacemode.md) - Desks that can be booked in advance using desk reservation tools.</li><li>[dropInPlaceMode](./dropinplacemode.md) - First come, first served desks. When you plug into a peripheral on one of these desks, the desk is booked for you, assuming the peripheral is associated with the desk in the Microsoft Teams Rooms Pro management portal.</li><li>[unavailablePlaceMode](./unavailableplacemode.md) - Desk that is taken down for maintenance or marked as not reservable.</li></ul> |
+|mode |[placeMode](./placemode.md) |The mode of the desk. The supported modes are:<ul><li>[assignedPlaceMode](./assignedplacemode.md) - Desks that are assigned to a user.</li><li>[reservablePlaceMode](./reservableplacemode.md) - Desks that can be booked in advance using desk reservation tools.</li><li>[dropInPlaceMode](./dropinplacemode.md) - First come, first served desks. When you plug into a peripheral on one of these desks, the desk is booked for you, assuming the peripheral is associated with the desk in the Microsoft Teams Rooms pro management portal.</li><li>[unavailablePlaceMode](./unavailableplacemode.md) - Desks that are taken down for maintenance or marked as not reservable.</li></ul> |
 |parentId|String|The ID of a parent [section](./section.md). Inherited from [place](./place.md).|
 |phone|String|The phone number of the **desk**. Inherited from [place](./place.md).|
 |tags|String collection|Custom tags that are associated with the **desk** for categorization or filtering. Inherited from [place](./place.md).|

api-reference/beta/resources/placemode.md

@@ -16,7 +16,7 @@ Namespace: microsoft.graph
 
 Represents an abstract base type for modes of [desk](./desk.md) and [workspace](./workspace.md) objects.
 
-Base type of [assignedPlaceMode](./assignedplacemode.md), [dropInPlaceMode](./dropinplacemode.md), [unavailablePlaceMode](./unavailableplacemode.md), and [reservablePlaceMode](./reservableplacemode.md).
+Base type of [assignedPlaceMode](./assignedplacemode.md), [dropInPlaceMode](./dropinplacemode.md), [reservablePlaceMode](./reservableplacemode.md), and [unavailablePlaceMode](./unavailableplacemode.md).
 
 ## Properties
 

api-reference/beta/resources/room.md

@@ -42,7 +42,7 @@ For the list of supported methods, see [place](./place.md).
 |nickname |String |A short, friendly name for the **room**, often used for easier identification or display in UI. |
 |parentId |String |The ID of a parent [floor](./floor.md) or [section](./section.md). Inherited from [place](../resources/place.md). |
 |phone |String |The phone number of the **room**. Inherited from [place](../resources/place.md).|
-|placeId |String |An alternate immutable unique identifier of the **room**. Read-only.|
+|placeId |String |An alternative immutable unique identifier of the **room**. Read-only.|
 |tags |String collection |Custom tags that are associated with the **room** for categorization or filtering. Inherited from [place](../resources/place.md).|
 |teamsEnabledState |placeFeatureEnablement |A state that indicates whether the room is enabled for Microsoft Teams. The possible values are: `unknown`, `enabled`, `disabled`, `unknownFutureValue`.|
 |videoDeviceName |String |The name of the video device that is available in the **room**. |
@@ -91,7 +91,7 @@ The following JSON representation shows the resource type.
   "nickname": "String",
   "parentId": "String",
   "phone": "String",
-  "placeId": "String (alternate identifier)",
+  "placeId": "String (alternative identifier)",
   "tags": ["String"],
   "teamsEnabledState": "String",
   "videoDeviceName": "String"

api-reference/beta/resources/unavailableplacemode.md

@@ -1,6 +1,6 @@
 ---
 title: "unavailablePlaceMode resource type"
-description: "Describes why a desk or a workspace has been marked as unavailable for booking."
+description: "Describes why a desk or a workspace is marked as unavailable for booking."
 author: tiwarisakshi02
 ms.date: 06/11/2025
 ms.localizationpriority: medium
@@ -14,16 +14,16 @@ Namespace: microsoft.graph
 
 [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
 
-Describes why a desk or a workspace has been marked as unavailable for booking.
+Describes why a desk or a workspace is marked as unavailable for booking.
 
-This mode is supported for [desk](./desk.md), [workspace](./workspace.md) objects.
+This mode is supported for [desk](./desk.md) and [workspace](./workspace.md) objects.
 
 Inherits from [placeMode](../resources/placemode.md).
 
 ## Properties
 |Property|Type|Description|
 |:---|:---|:---|
-|reason|String|Reason for marking a [place](../resources/place.md) unavailable.|
+|reason|String|The reason a [place](../resources/place.md) is marked unavailable.|
 
 ## Relationships
 None.

api-reference/beta/resources/workspace.md

@@ -36,11 +36,11 @@ For the list of supported methods, see [place](./place.md).
 |id|String|The unique identifier for the **workspace**. Read-only. This identifier isn't immutable and can change if the mailbox or tenant configuration changes. Inherited from [place](./place.md). |
 |isWheelChairAccessible|Boolean|Indicates whether the **workspace** is wheelchair accessible. Inherited from [place](./place.md).|
 |label |String |User-defined description of the **workspace**. Inherited from [place](../resources/place.md).|
-|mode|[placeMode](./placemode.md) |The mode for a **workspace**. The supported modes are:<ul><li>[reservablePlaceMode](./reservableplacemode.md) - Workspaces that can be booked in advance using desk pool reservation tools.</li><li>[dropInPlaceMode](./dropinplacemode.md) - First come, first served desks. When you plug into a peripheral on one of these desks in the workspace, the desk is booked for you, assuming that the peripheral has been associated with the desk in the Microsoft Teams Rooms Pro management portal.</li><li>[unavailablePlaceMode](./unavailableplacemode.md) - Workspaces that are taken down for maintenance or marked as not reservable.</li></ul> |
+|mode|[placeMode](./placemode.md) |The mode for a **workspace**. The supported modes are:<ul><li>[reservablePlaceMode](./reservableplacemode.md) - Workspaces that can be booked in advance using desk pool reservation tools.</li><li>[dropInPlaceMode](./dropinplacemode.md) - First come, first served desks. When you plug into a peripheral on one of these desks in the workspace, the desk is booked for you, assuming that the peripheral has been associated with the desk in the Microsoft Teams Rooms pro management portal.</li><li>[unavailablePlaceMode](./unavailableplacemode.md) - Workspaces that are taken down for maintenance or marked as not reservable.</li></ul> |
 |nickname|String|A short, friendly name for the **workspace**, often used for easier identification or display in the UI. |
 |parentId|String|The ID of a parent [section](./section.md). Inherited from [place](./place.md). |
 |phone|String|The phone number of the **workspace**. Inherited from [place](./place.md). |
-|placeId|String|An alternate immutable unique identifier of the **workspace**. Read-only.|
+|placeId|String|An alternative immutable unique identifier of the **workspace**. Read-only.|
 |tags|String collection|Custom tags that are associated with the **workspace** for categorization or filtering. Inherited from [place](./place.md). |
 
 ## Relationships
@@ -77,7 +77,7 @@ The following JSON representation shows the resource type.
   "nickname": "String",
   "parentId": "String",
   "phone": "String",
-  "placeId": "String",
+  "placeId": "String (alternative identifier)",
   "tags": ["String"]
 }
 ```

api-reference/v1.0/resources/building.md

@@ -36,6 +36,7 @@ For more supported methods, see [place](./place.md).
 |phone|String|The phone number of the **building**. Inherited from [place](./place.md). |
 |resourceLinks|[resourceLink](../resources/resourcelink.md) collection|A set of links to external resources that are associated with the **building**. Inherited from [place](./place.md). |
 |tags|String collection|Custom tags that are associated with the building for categorization or filtering. Inherited from [place](./place.md).|
+|wifiState |placeFeatureEnablement |A state that indicates whether the **building** has Wi-Fi. The possible values are: `unknown`, `enabled`, `disabled`, `unknownFutureValue`.|
 
 ## Relationships
 |Relationship|Type|Description|
@@ -64,7 +65,8 @@ The following JSON representation shows the resource type.
   "parentId": "String",
   "phone": "String",
   "resourceLinks": [{"@odata.type": "microsoft.graph.resourceLink"}],
-  "tags": ["String"]
+  "tags": ["String"],
+  "wifiState": "String"
 }
 ```
 

api-reference/v1.0/resources/desk.md

@@ -26,11 +26,12 @@ For the list of supported methods, see [place](./place.md).
 |displayDeviceName |String |The name of the display device (for example, `monitor` or `projector`) that is available at the **desk**. |
 |displayName|String|The name that is associated with the **desk**. Inherited from [place](./place.md).|
 |geoCoordinates|[outlookGeoCoordinates](./outlookgeocoordinates.md)|Specifies the **desk** location in latitude, longitude, and (optionally) altitude coordinates. Inherited from [place](./place.md).|
+|heightAdjustableState |placeFeatureEnablement|A state that indicates whether the **desk** is height adjustable. The possible values are: `unknown`, `enabled`, `disabled`, `unknownFutureValue`.|
 |id|String|The unique identifier for the **desk**. Read-only. This identifier isn't immutable and can change if the mailbox or tenant configuration changes. Inherited from [place](./place.md). |
 |isWheelChairAccessible|Boolean|Indicates whether the **desk** is wheelchair accessible. Inherited from [place](./place.md).|
 |label |String |User-defined description of the **desk**. Inherited from [place](../resources/place.md).|
 |mailboxDetails |[mailboxDetails](mailboxdetails.md) |The mailbox object **id** and email address that are associated with the desk. |
-|mode |[placeMode](./placemode.md) |The mode of the desk. The supported modes are:<ul><li>[assignedPlaceMode](./assignedplacemode.md) - Desks that are assigned to a user.</li><li>[reservablePlaceMode](./reservableplacemode.md) - Desks that can be booked in advance using desk reservation tools.</li><li>[dropInPlaceMode](./dropinplacemode.md) - First come, first served desks. When you plug into a peripheral on one of these desks, the desk is booked for you, assuming the peripheral is associated with the desk in the Microsoft Teams Rooms Pro management portal.</li></ul> |
+|mode |[placeMode](./placemode.md) |The mode of the desk. The supported modes are:<ul><li>[assignedPlaceMode](./assignedplacemode.md) - Desks that are assigned to a user.</li><li>[reservablePlaceMode](./reservableplacemode.md) - Desks that can be booked in advance using desk reservation tools.</li><li>[dropInPlaceMode](./dropinplacemode.md) - First come, first served desks. When you plug into a peripheral on one of these desks, the desk is booked for you, assuming the peripheral is associated with the desk in the Microsoft Teams Rooms pro management portal.</li><li>[unavailablePlaceMode](./unavailableplacemode.md) - Desks that are taken down for maintenance or marked as not reservable.</li></ul> |
 |parentId|String|The ID of a parent [section](./section.md). Inherited from [place](./place.md).|
 |phone|String|The phone number of the **desk**. Inherited from [place](./place.md).|
 |tags|String collection|Custom tags that are associated with the **desk** for categorization or filtering. Inherited from [place](./place.md).|
@@ -55,6 +56,7 @@ The following JSON representation shows the resource type.
   "displayDeviceName": "String",
   "displayName": "String",
   "geoCoordinates": {"@odata.type": "microsoft.graph.outlookGeoCoordinates"},
+  "heightAdjustableState": "String",
   "id": "String (identifier)",
   "isWheelChairAccessible": "Boolean",
   "label": "String",

api-reference/v1.0/resources/enums.md

@@ -1568,6 +1568,15 @@ Possible types of Windows settings.
 | pager |
 | radio |
 
+### placeFeatureEnablement values 
+
+|Member|
+|:---|
+|unknown|
+|enabled|
+|disabled|
+|unknownFutureValue|
+
 ### plannerContainerType values
 
 | Member |

api-reference/v1.0/resources/placemode.md

@@ -14,7 +14,7 @@ Namespace: microsoft.graph
 
 Represents an abstract base type for modes of [desk](./desk.md) and [workspace](./workspace.md) objects.
 
-Base type of [assignedPlaceMode](./assignedplacemode.md), [dropInPlaceMode](./dropinplacemode.md), and [reservablePlaceMode](./reservableplacemode.md).
+Base type of [assignedPlaceMode](./assignedplacemode.md), [dropInPlaceMode](./dropinplacemode.md), [reservablePlaceMode](./reservableplacemode.md), and [unavailablePlaceMode](./unavailableplacemode.md).
 
 ## Properties
 None.

api-reference/v1.0/resources/room.md

@@ -12,9 +12,9 @@ ms.date: 03/22/2024
 
 Namespace: microsoft.graph
 
-Represents a room in a tenant. 
+Represents a room within a tenant. A room can be added to a [floor](./floor.md) or to a [section](./section.md).
 
-In Exchange Online, each room is associated with a room mailbox. Derived from [place](place.md).
+Inherits from [place](./place.md).
 
 ## Methods
 For the list of supported methods, see [place](./place.md).
@@ -34,13 +34,15 @@ For the list of supported methods, see [place](./place.md).
 | floorLabel             | String                                            | Specifies a descriptive label for the floor, for example, P. |
 | floorNumber            | Int32                                             | Specifies the floor number that the room is on. |
 | geoCoordinates         | [outlookGeoCoordinates](outlookgeocoordinates.md) | Specifies the room location in latitude, longitude, and optionally, altitude coordinates. |
-| id                     | String                                            | Unique identifier for the room. Read-only. This identifier isn't immutable and can change if there are changes to the mailbox or the tenant configuration. The beta version of this API has a new property added called **placeId**, which provides an immutable ID. |
+|id |String |The unique identifier for the **room**. Read-only. This identifier isn't immutable and can change if the mailbox or tenant configuration changes. Inherited from [place](./place.md).|
 | isWheelChairAccessible | Boolean                                           | Specifies whether the room is wheelchair accessible. Inherited from [place](./place.md). |
 | label                  | String                                            | Specifies a descriptive label for the room, for example, a number or name. Inherited from [place](./place.md). |
 | nickname               | String                                            | Specifies a nickname for the room, for example, "conf room". |
-| parentId |String | The ID of a parent [floor](./floor.md) or [section](./section.md). Inherited from [place](../resources/place.md). |
+| parentId |String | The ID of a parent [floor](./floor.md) or [section](./section.md). Inherited from [place](./place.md). |
 | phone                  | String                                            | The phone number of the room. |
+| placeId |String | An alternative immutable unique identifier of the **room**. Read-only. |
 | tags | String collection | Specifies other features of the room, for example, details like the type of view or furniture type. Inherited from [place](./place.md). |
+|teamsEnabledState |placeFeatureEnablement |A state that indicates whether the **room** is enabled for Microsoft Teams. The possible values are: `unknown`, `enabled`, `disabled`, `unknownFutureValue`.|
 | videoDeviceName        | String                                            | Specifies the name of the video device in the room. |
 
 ### bookingType values
@@ -86,7 +88,9 @@ The following JSON representation shows the resource type.
   "nickname": "String",
   "parentId": "String",
   "phone": "String",
+  "placeId": "String (alternative identifier)",
   "tags": ["String"],
+  "teamsEnabledState": "String",
   "videoDeviceName": "String"
 }
 ```