Edit

Share via

roomList 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 group of room or workspace resources defined in the tenant. A roomList can contain a mix of room and workspace resources.

In Exchange Online, each roomList is associated with a 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 list.
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 room list.
displayName String The name associated with the room list.
emailAddress String The email address of the room list.
geoCoordinates outlookGeoCoordinates Specifies the roomlist location in latitude, longitude, and (optionally) altitude coordinates.
id String Unique identifier for the room list. Read-only. This identifier isn't immutable and can change if there are changes to the mailbox or to the tenant configuration.
phone String The phone number of the room list.
placeId String Unique, immutable identifier for the room list. Read-only. The value of this identifier is equal to the ExternalDirectoryObjectId returned from the Get-Mailbox cmdlet.

Relationships

Relationship Type Description
rooms place collection Read-only. Nullable.
workspaces place collection Read-only. Nullable.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.roomList",
  "id": "String (identifier)",
  "displayName": "String",
  "geoCoordinates": {
    "@odata.type": "microsoft.graph.outlookGeoCoordinates"
  },
  "phone": "String",
  "address": {
    "@odata.type": "microsoft.graph.physicalAddress"
  },
  "emailAddress": "String",
  "placeId": "String (alternate identifier)"
}