Edit

workspace resource type

  • Article

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)"
}