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.

Understand request payload

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

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.

Related content

• place resource type
• Upsert places
• Get operation
• List operations