workspace resource type

Article
03/23/2024

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 workspace in a tenant.

In Exchange Online, each workspace is associated with a workspace mailbox. Derived from place.

Methods

Method	Return Type	Description
List places	A collection of the requested, derived type of place	Get a collection of the specified type of place object defined in the tenant. For example, you can get all the rooms all the workspaces, all the room lists, the workspaces in a specific room list, or the rooms in a specific room list in the tenant.
Get place	The requested, derived type of place	Get the properties and relationships of the specified place object, such as a room.
Update place	The requested, derived type of place	Update the properties and relationships of a specified place object.

Properties

Property	Type	Description
address	physicalAddress	The street address of the workspace.
building	String	Specifies the building name or building number that the workspace is in.
capacity	Int32	Specifies the capacity of the workspace.
displayName	String	The name associated with the workspace.
emailAddress	String	Email address of the workspace.
floorLabel	String	Specifies a descriptive label for the floor, for example, P.
floorNumber	Int32	Specifies the floor number that the workspace is on.
geoCoordinates	outlookGeoCoordinates	Specifies the workspace location in latitude, longitude, and optionally, altitude coordinates.
id	String	Unique identifier for the workspace. Read-only. This identifier isn't immutable and can change if there are changes to the mailbox or to the tenant configuration.
isWheelChairAccessible	Boolean	Specifies whether the workspace is wheelchair accessible.
label	String	Specifies a descriptive label for the workspace, for example, a number or name.
nickname	String	Specifies a nickname for the workspace, for example, "quiet workspace".
phone	String	The phone number of the workspace.
placeId	String	A unique, immutable identifier for the workspace. Read-only. The value of this identifier is equal to the ExternalDirectoryObjectId returned from the `Get-Mailbox` cmdlet.
tags	String collection	Specifies other features of the workspace; for example, the type of view or furniture type.

bookingType values

Value	Description
standard	The workspace can be reserved based on the other settings in this cmdlet. This value is the default.
reserved	The workspace is available only on a first-come, first-served basis. It can't be reserved.

Relationships

None.

JSON representation

The following JSON representation shows the resource type.

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

Share via