Edit

Share via

place 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 different space types within a tenant. For more information, see Working with the Places API in Microsoft Graph.

Base type of building, desk, floor, room, roomList, section, and workspace.

Methods

Method Return type Description
List place collection Get a collection of the specified type of place objects defined in a tenant.
Create place Create a new place object.
Get place Read the properties of a place object. Returns the requested, derived type of place.
Update place Update the properties of place object that can be a building, floor, section, desk, room, workspace, or roomList.
Delete None Delete a place object.
descendants place collection Get all the descendants of a specific type under a place.

Properties

Property Type Description
address physicalAddress The physical address of the place, including the street, city, state, country or region, and postal code.
label String User-defined description of the place.
displayName String The name that is associated with the place.
geoCoordinates outlookGeoCoordinates Specifies the place location in latitude, longitude, and (optionally) altitude coordinates.
id String The unique identifier for the place. Read-only. This identifier isn't immutable and can change if the mailbox or tenant configuration changes.
isWheelChairAccessible Boolean Indicates whether the place is wheelchair accessible.
parentId String The ID of a parent place.
phone String The phone number of the place.
placeId String An alternate immutable unique identifier of the place. Read-only.
tags String collection Custom tags that are associated with the place for categorization or filtering.

Relationships

None.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.place",
  "address": {"@odata.type": "microsoft.graph.physicalAddress"},
  "displayName": "String",
  "geoCoordinates": {"@odata.type": "microsoft.graph.outlookGeoCoordinates"},
  "id": "String (identifier)",
  "isWheelChairAccessible": "Boolean",
  "label": "String",
  "parentId": "String",
  "phone": "String",
  "placeId": "String",
  "tags": ["String"]
}

Related content

Working with the Places API in Microsoft Graph