Microsoft Graph: Places, rooms and workspaces
Rooms, room lists, buildings, floors, desks and workspaces for booking and hybrid work. This listing is one area of Microsoft Graph, the single REST API for…
Productivity & workspace#openapi
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Rooms, room lists, buildings, floors, desks and workspaces for booking and hybrid work.
This listing is one area of Microsoft Graph, the single REST API for Microsoft 365, Outlook, OneDrive, Teams and Microsoft Entra ID. It holds 97 of the area's requests, the most direct ones first, generated from Microsoft's own OpenAPI description of Graph v1.0. The other areas (mail, calendar, files, Teams, users and more) are listed separately on the Microsoft page.
Get an access token
- Sign in to the Microsoft Entra admin center and open App registrations > New registration. For a quick test, the Graph Explorer signs you in and shows a token without registering anything.
- Under API permissions, add the Microsoft Graph permissions this area needs, for example:
Place.Read.All. Delegated permissions act as the signed-in user; application permissions act as the app itself and need an administrator's consent. - Under Certificates & secrets, create a client secret (keep it out of shared collections).
- Get a token from
https://login.microsoftonline.com/ /oauth2/v2.0/token: the authorization-code flow for a user, orgrant_type=client_credentialswithscope=https://graph.microsoft.com/.defaultfor an app. Send it asAuthorization: Bearer.
Using these requests
- Base URL:
https://graph.microsoft.com/v1.0./me/...paths act on the signed-in user; with an application token use/users/{id or userPrincipalName}/...instead. - Shape responses with OData query parameters:
$select(fields),$filter,$orderby,$top,$expandand$search(some need theConsistencyLevel: eventualheader). Long lists are paged: follow@odata.nextLink. - Combine up to 20 requests in one call with
POST /$batch.
Common errors
| Status | Code | What to do |
|---|---|---|
| 401 | InvalidAuthenticationToken | The token is missing, expired or for another resource: get a new one for https://graph.microsoft.com. |
| 403 | Authorization_RequestDenied / ErrorAccessDenied | Add the permission listed in the request's docs and grant consent. |
| 404 | ResourceNotFound / itemNotFound | Check the id; ids from another user or tenant are not found. |
| 429 | TooManyRequests | Throttled: wait the Retry-After seconds, then retry. |
Docs: Places, rooms and workspaces overview · Permissions reference · Throttling
Endpoints 97
Places
- POSTCreate place
/placesCreate a new place object. You can also use this method to create the following child object types: building, floor, section, room, workspace, or desk. - DELETEDelete place
/places/:place-idDelete a place object. You can also use this method to delete the following child object types: building, floor, section, or desk. - PATCHUpdate place
/places/:place-idUpdate the properties of place object that can be a building, floor, section, desk, room, workspace, or roomList. You can identify the place by specifying the… - GETDescendants place
/places/:place-id/descendants()
Places: desk
- GETGet desk
/places/graph.deskGet a collection of the specified type of place objects defined in a tenant. You can do the following for a given tenant: List all buildings. List all floors.… - GETGet desk
/places/:place-id/graph.deskGet a collection of the specified type of place objects defined in a tenant. You can do the following for a given tenant: List all buildings. List all floors.… - GETCheck ins (desk)
/places/:place-id/graph.desk/checkInsA subresource of a place object that indicates the check-in status of an Outlook calendar event booked at the place. - POSTCheck ins (desk)
/places/:place-id/graph.desk/checkIns - GETGet check in
/places/:place-id/graph.desk/checkIns/:checkInClaim-calendarEventIdA subresource of a place object that indicates the check-in status of an Outlook calendar event booked at the place. - DELETEDelete check in
/places/:place-id/graph.desk/checkIns/:checkInClaim-calendarEventId - PATCHUpdate check in
/places/:place-id/graph.desk/checkIns/:checkInClaim-calendarEventId
Places: room
- GETGet room
/places/graph.roomGet a collection of the specified type of place objects defined in a tenant. You can do the following for a given tenant: List all buildings. List all floors.… - GETGet room
/places/:place-id/graph.roomGet a collection of the specified type of place objects defined in a tenant. You can do the following for a given tenant: List all buildings. List all floors.… - GETCheck ins (room)
/places/:place-id/graph.room/checkInsA subresource of a place object that indicates the check-in status of an Outlook calendar event booked at the place. - POSTCheck ins (room)
/places/:place-id/graph.room/checkIns - GETGet check in
/places/:place-id/graph.room/checkIns/:checkInClaim-calendarEventIdA subresource of a place object that indicates the check-in status of an Outlook calendar event booked at the place. - DELETEDelete check in
/places/:place-id/graph.room/checkIns/:checkInClaim-calendarEventId - PATCHUpdate check in
/places/:place-id/graph.room/checkIns/:checkInClaim-calendarEventId
Places: floor
- GETGet floor
/places/graph.floorGet a collection of the specified type of place objects defined in a tenant. You can do the following for a given tenant: List all buildings. List all floors.… - GETGet floor
/places/:place-id/graph.floorGet a collection of the specified type of place objects defined in a tenant. You can do the following for a given tenant: List all buildings. List all floors.… - GETCheck ins (floor)
/places/:place-id/graph.floor/checkInsA subresource of a place object that indicates the check-in status of an Outlook calendar event booked at the place. - POSTCheck ins (floor)
/places/:place-id/graph.floor/checkIns - GETGet check in
/places/:place-id/graph.floor/checkIns/:checkInClaim-calendarEventIdA subresource of a place object that indicates the check-in status of an Outlook calendar event booked at the place. - DELETEDelete check in
/places/:place-id/graph.floor/checkIns/:checkInClaim-calendarEventId - PATCHUpdate check in
/places/:place-id/graph.floor/checkIns/:checkInClaim-calendarEventId
Places: section
- GETGet section
/places/graph.sectionGet a collection of the specified type of place objects defined in a tenant. You can do the following for a given tenant: List all buildings. List all floors.… - GETGet section
/places/:place-id/graph.sectionGet a collection of the specified type of place objects defined in a tenant. You can do the following for a given tenant: List all buildings. List all floors.… - GETCheck ins (section)
/places/:place-id/graph.section/checkInsA subresource of a place object that indicates the check-in status of an Outlook calendar event booked at the place. - POSTCheck ins (section)
/places/:place-id/graph.section/checkIns - GETGet check in
/places/:place-id/graph.section/checkIns/:checkInClaim-calendarEventIdA subresource of a place object that indicates the check-in status of an Outlook calendar event booked at the place. - DELETEDelete check in
/places/:place-id/graph.section/checkIns/:checkInClaim-calendarEventId - PATCHUpdate check in
/places/:place-id/graph.section/checkIns/:checkInClaim-calendarEventId
Places: building
- GETGet building
/places/graph.buildingGet a collection of the specified type of place objects defined in a tenant. You can do the following for a given tenant: List all buildings. List all floors.… - GETGet building
/places/:place-id/graph.buildingGet a collection of the specified type of place objects defined in a tenant. You can do the following for a given tenant: List all buildings. List all floors.… - GETGet map
/places/:place-id/graph.building/mapGet the map of a building in IMDF format. - DELETEDelete map
/places/:place-id/graph.building/mapDelete the map of a specific building. - PATCHUpdate map
/places/:place-id/graph.building/map - GETCheck ins (building)
/places/:place-id/graph.building/checkInsA subresource of a place object that indicates the check-in status of an Outlook calendar event booked at the place. - POSTCheck ins (building)
/places/:place-id/graph.building/checkIns - GETList levels
/places/:place-id/graph.building/map/levelsGet a list of the levelMap objects and their properties. - POSTCreate level
/places/:place-id/graph.building/map/levels - GETList footprints
/places/:place-id/graph.building/map/footprintsGet a list of footprintMap objects for building footprints and their properties. - POSTCreate footprint
/places/:place-id/graph.building/map/footprints - GETGet check in
/places/:place-id/graph.building/checkIns/:checkInClaim-calendarEventIdA subresource of a place object that indicates the check-in status of an Outlook calendar event booked at the place. - DELETEDelete check in
/places/:place-id/graph.building/checkIns/:checkInClaim-calendarEventId - PATCHUpdate check in
/places/:place-id/graph.building/checkIns/:checkInClaim-calendarEventId - GETGet level
/places/:place-id/graph.building/map/levels/:levelMap-idRepresents a physical floor structure within a building. It corresponds to level.geojson in IMDF format. - DELETEDelete level
/places/:place-id/graph.building/map/levels/:levelMap-id - PATCHUpdate level
/places/:place-id/graph.building/map/levels/:levelMap-id - GETGet footprint
/places/:place-id/graph.building/map/footprints/:footprintMap-idRepresents the approximate physical extent of a referenced building. It corresponds to footprint.geojson in IMDF format. - DELETEDelete footprint
/places/:place-id/graph.building/map/footprints/:footprintMap-id - PATCHUpdate footprint
/places/:place-id/graph.building/map/footprints/:footprintMap-id - GETList units
/places/:place-id/graph.building/map/levels/:levelMap-id/unitsGet a list of the unitMap objects and their properties. - POSTCreate unit
/places/:place-id/graph.building/map/levels/:levelMap-id/units - GETList fixtures
/places/:place-id/graph.building/map/levels/:levelMap-id/fixturesGet a list of the fixtureMap objects and their properties. - POSTCreate fixture
/places/:place-id/graph.building/map/levels/:levelMap-id/fixtures - GETList sections
/places/:place-id/graph.building/map/levels/:levelMap-id/sectionsGet a list of the sectionMap objects and their properties. - POSTCreate section
/places/:place-id/graph.building/map/levels/:levelMap-id/sections
Places: room list
- GETGet room list
/places/graph.roomListRead the properties of a place object specified by its ID. The place object can be one of the following types: The listed resources are derived from the place… - GETGet room list
/places/:place-id/graph.roomListRead the properties of a place object specified by its ID. The place object can be one of the following types: The listed resources are derived from the place… - GETList rooms
/places/:place-id/graph.roomList/rooms - POSTCreate room
/places/:place-id/graph.roomList/rooms - GETCheck ins (room list)
/places/:place-id/graph.roomList/checkInsA subresource of a place object that indicates the check-in status of an Outlook calendar event booked at the place. - POSTCheck ins (room list)
/places/:place-id/graph.roomList/checkIns - GETList workspaces
/places/:place-id/graph.roomList/workspaces - POSTCreate workspace
/places/:place-id/graph.roomList/workspaces - GETGet room
/places/:place-id/graph.roomList/rooms/:room-id - DELETEDelete room
/places/:place-id/graph.roomList/rooms/:room-id - PATCHUpdate room
/places/:place-id/graph.roomList/rooms/:room-id - GETGet workspace
/places/:place-id/graph.roomList/workspaces/:workspace-id - DELETEDelete workspace
/places/:place-id/graph.roomList/workspaces/:workspace-id - PATCHUpdate workspace
/places/:place-id/graph.roomList/workspaces/:workspace-id - GETGet check in
/places/:place-id/graph.roomList/checkIns/:checkInClaim-calendarEventIdA subresource of a place object that indicates the check-in status of an Outlook calendar event booked at the place. - DELETEDelete check in
/places/:place-id/graph.roomList/checkIns/:checkInClaim-calendarEventId - PATCHUpdate check in
/places/:place-id/graph.roomList/checkIns/:checkInClaim-calendarEventId - GETCheck ins (room)
/places/:place-id/graph.roomList/rooms/:room-id/checkInsA subresource of a place object that indicates the check-in status of an Outlook calendar event booked at the place. - POSTCheck ins (room)
/places/:place-id/graph.roomList/rooms/:room-id/checkIns - GETCheck ins (workspace)
/places/:place-id/graph.roomList/workspaces/:workspace-id/checkInsA subresource of a place object that indicates the check-in status of an Outlook calendar event booked at the place. - POSTCheck ins (workspace)
/places/:place-id/graph.roomList/workspaces/:workspace-id/checkIns - GETGet check in
/places/:place-id/graph.roomList/rooms/:room-id/checkIns/:checkInClaim-calendarEventIdA subresource of a place object that indicates the check-in status of an Outlook calendar event booked at the place. - DELETEDelete check in
/places/:place-id/graph.roomList/rooms/:room-id/checkIns/:checkInClaim-calendarEventId - PATCHUpdate check in
/places/:place-id/graph.roomList/rooms/:room-id/checkIns/:checkInClaim-calendarEventId - GETGet check in
/places/:place-id/graph.roomList/workspaces/:workspace-id/checkIns/:checkInClaim-calendarEventIdA subresource of a place object that indicates the check-in status of an Outlook calendar event booked at the place. - DELETEDelete check in
/places/:place-id/graph.roomList/workspaces/:workspace-id/checkIns/:checkInClaim-calendarEventId - PATCHUpdate check in
/places/:place-id/graph.roomList/workspaces/:workspace-id/checkIns/:checkInClaim-calendarEventId
Places: workspace
- GETGet workspace
/places/graph.workspaceGet a collection of the specified type of place objects defined in a tenant. You can do the following for a given tenant: List all buildings. List all floors.… - GETGet workspace
/places/:place-id/graph.workspaceGet a collection of the specified type of place objects defined in a tenant. You can do the following for a given tenant: List all buildings. List all floors.… - GETCheck ins (workspace)
/places/:place-id/graph.workspace/checkInsA subresource of a place object that indicates the check-in status of an Outlook calendar event booked at the place. - POSTCheck ins (workspace)
/places/:place-id/graph.workspace/checkIns - GETGet check in
/places/:place-id/graph.workspace/checkIns/:checkInClaim-calendarEventIdA subresource of a place object that indicates the check-in status of an Outlook calendar event booked at the place. - DELETEDelete check in
/places/:place-id/graph.workspace/checkIns/:checkInClaim-calendarEventId - PATCHUpdate check in
/places/:place-id/graph.workspace/checkIns/:checkInClaim-calendarEventId
Places: check ins
- GETCheck ins (place)
/places/:place-id/checkInsRead the properties and relationships of a checkInClaim object. This API provides the check-in status for a specific place, such as a desk, room, or… - POSTCheck ins (place)
/places/:place-id/checkInsCreate a new checkInClaim object to record the check-in status for a specific place, such as a desk or a room, associated with a specific calendar… - GETGet check in
/places/:place-id/checkIns/:checkInClaim-calendarEventIdRead the properties and relationships of a checkInClaim object. This API provides the check-in status for a specific place, such as a desk, room, or… - DELETEDelete check in
/places/:place-id/checkIns/:checkInClaim-calendarEventId - PATCHUpdate check in
/places/:place-id/checkIns/:checkInClaim-calendarEventId
API details
- Base URL
https://graph.microsoft.com/v1.0- Authentication
- OAuth 2.0 (authorization code, client credentials flows)
- Operations
- 97 operations on 49 pathsGET 47POST 18PATCH 16DELETE 16
- Main resources
- Places: room list 27Places: building 26Places: desk 7Places: floor 7Places: room 7Places: section 7Places: workspace 7Places: check ins 5Places 4
- Description format
- OpenAPI 3.0.4, API version
v1.0 - Links
- Documentation · OpenAPI document
How to test the Microsoft Graph: Places, rooms and workspaces in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Microsoft Graph: Places, rooms and workspaces collection, without the publisher's secrets.
- Add your credentialsThis API uses OAuth 2.0 (authorization code, client credentials flows). Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “Create place” (POST /places), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Microsoft Graph: Places, rooms and workspaces?
Rooms, room lists, buildings, floors, desks and workspaces for booking and hybrid work. This listing is one area of Microsoft Graph, the single REST API for… It is listed under Productivity & workspace and has 97 endpoints.
Who publishes the Microsoft Graph: Places, rooms and workspaces?
It is listed from Microsoft's public API description (an OpenAPI document), not published by Microsoft on Swastik Codes. Anyone who controls microsoft.com can claim the profile by adding a DNS TXT record.
What is the base URL of the Microsoft Graph: Places, rooms and workspaces?
Requests go to https://graph.microsoft.com/v1.0. Endpoint paths are added to this base URL.
How do I authenticate with the Microsoft Graph: Places, rooms and workspaces?
With OAuth 2.0 (authorization code, client credentials flows).
How many endpoints does the Microsoft Graph: Places, rooms and workspaces have?
97 operations on 49 paths (47 GET, 18 POST, 16 PATCH, 16 DELETE). The largest groups are Places: room list, Places: building, Places: desk, Places: floor.
Is forking the Microsoft Graph: Places, rooms and workspaces free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.