Working with the upsert Places API in Microsoft Graph

The upsert places API allows you to efficiently create and update multiple places in a single asynchronous operation.

Supported scenarios

The following scenarios are supported when using the upsert places API:

Create multiple independent places.
Create places with hierarchy, including new child places under an existing place.
Update multiple independent places.
Update the hierarchy of places, including moving an existing place under a new place.

The following considerations apply when performing bulk create or update operations on places:

Create vs. update: Places without an id property are created and places with an id property are updated by ID.
Place hierarchy: Use the children@delta property to create or update children places within a parent place. The parentId property is automatically set for children places.
Assigned mode isn't supported in upsert places yet.
It isn't supported to update an existing child place under an existing parent place using children@delta property. They should be updated separately.

Job-level concurrency limits the number of upsert places operations that can run simultaneously within a tenant.

Only three concurrent upsert places operations are allowed at the tenant level.
If three operations are already created or in progress, another PATCH API call is rejected with a 429 Too Many Requests response code.

Was this page helpful?