Synchronization of Organization Objects

This set of endpoints represents status of synchronization of Microsoft organization objects with the organization cache database and allows you to start the synchronization process.

NOTE
Synchronization of objects with the organization cache database is only available for Microsoft organizations with modern app-only authentication.

Get Synchronization Status

Returns status of synchronization of Microsoft organization objects with the organization cache database.

SecurityBearer
Responses
200

OK

default

Operation failure response.

get/v8/Organizations/SyncState
Request samples
Response samples
application/json
[
  • {
    }
]

Get Synchronization Status by Organization ID

Returns status of synchronization of Microsoft organization objects with the organization cache database.

SecurityBearer
Request
path Parameters
organizationId
required
string <uuid>

Specifies the identification number of the Microsoft 365 organization. For more information on how to get this parameter, see Get Organizations.

Responses
200

OK

default

Operation failure response.

get/v8/Organizations/{organizationId}/SyncState
Request samples
Response samples
application/json
{
  • "organizationId": "00000000-0000-0000-0000-000000000000",
  • "lastSyncState": {
    },
  • "currentSyncState": {
    },
  • "_links": {
    }
}

Start Synchronization

Starts synchronization of Microsoft organization objects with the organization cache database.

x-codegen-request-body-name: options
SecurityBearer
Request
path Parameters
organizationId
required
string <uuid>

Specifies the identification number of the Microsoft 365 organization. For more information on how to get this parameter, see Get Organizations.

Request Body schema: application/json
required
type
string

Specifies the synchronization type. The following values are available:

  • Full - all objects in the Microsoft organization will be synchronized with the organization cache database.
  • Incremental - only new and modified objects in the Microsoft organization will be synchronized with the organization cache database.

Enum: "Incremental" "Full"
Responses
204

No Content

default

Operation failure response.

post/v8/Organizations/{organizationId}/Sync
Request samples
application/json
{
  • "type": "Incremental"
}
Response samples
application/json
{
  • "message": "string",
  • "errorCode": "ProxyOffline",
  • "stackTrace": "string"
}

Document updated 12/18/2025

Page content applies to build 8.3.0.2201