Edit

Share via

workspace resource type

Namespace: microsoft.graph

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Represents a collection of desks. A workspace can be added to a floor or a section.

Inherits from place.

Methods

For the list of supported methods, see place.

Properties

Property Type Description
address physicalAddress The physical address of the workspace, including the street, city, state, country or region, and postal code. Inherited from place.
building String The name or identifier of the building where the workspace is located.
capacity Int32 The maximum number of individual desks within a workspace.
displayDeviceName String The name of the display device (for example, monitor or projector) that is available in the workspace.
displayName String The name that is associated with the workspace. Inherited from place.
emailAddress String The email address that is associated with the workspace. This email address is used for booking.
floorLabel String A human-readable label for the floor; for example, Ground Floor.
floorNumber Int32 The numeric floor level within the building. For example, 1 for first floor, 2 for second floor, and so on.
geoCoordinates outlookGeoCoordinates Specifies the workspace location in latitude, longitude, and (optionally) altitude coordinates. Inherited from place.
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.
isWheelChairAccessible Boolean Indicates whether the workspace is wheelchair accessible. Inherited from place.
label String User-defined description of the workspace. Inherited from place.
mode placeMode The mode for a workspace. The supported modes are:
  • reservablePlaceMode - Workspaces that can be booked in advance using desk pool reservation tools.
  • dropInPlaceMode - 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.
  • offlinePlaceMode - Workspaces that are taken down for maintenance or marked as not reservable.
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 or floor. Inherited from place.
phone String The phone number of the workspace. Inherited from place.
placeId String An alternate immutable unique identifier of the workspace. Read-only. Inherited from place.
tags String collection Custom tags that are associated with the workspace for categorization or filtering. Inherited from place.

Relationships

None.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.workspace",
  "address": {"@odata.type": "microsoft.graph.physicalAddress"},
  "building": "String",
  "capacity": "Int32",
  "displayDeviceName": "String",
  "displayName": "String",
  "emailAddress": "String",
  "floorLabel": "String",
  "floorNumber": "Int32",
  "geoCoordinates": {"@odata.type": "microsoft.graph.outlookGeoCoordinates"},
  "id": "String (identifier)",
  "isWheelChairAccessible": "Boolean",
  "label": "String",
  "mode": {"@odata.type": "microsoft.graph.placeMode"},
  "nickname": "String",
  "parentId": "String",
  "phone": "String",
  "placeId": "String",
  "tags": ["String"]
}