How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Microsoft Graph servicePrincipals.synchronization API

The servicePrincipals.synchronization API from Microsoft Graph — 34 operation(s) for serviceprincipals.synchronization.

Microsoft Graph servicePrincipals.synchronization API is one of 564 APIs that Microsoft Graph publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 56 operations across 34 paths, and defines 76 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against a single base URL, https://graph.microsoft.com/v1.0.

56 operations 34 paths 76 schemas 9 DELETE22 GET7 PATCH15 POST3 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://graph.microsoft.com/v1.0
Resource Areas
1

Paths & Operations 56

Across 34 paths, the API surfaces 56 operations — 9 DELETE, 22 GET, 7 PATCH, 15 POST, 3 PUT. Each is listed below with its method, path, parameters, and response codes.

servicePrincipals.synchronization 56
GET
/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/schema/filterOperators()
Microsoft Graph Invoke function filterOperators
servicePrincipals.servicePrincipal.synchronization.jobs.synchronizationJob.schema.filterOperators 10 params → 2XX4XX5XX
GET
/servicePrincipals/{servicePrincipal-id}/synchronization/templates/{synchronizationTemplate-id}/schema/filterOperators()
Microsoft Graph Invoke function filterOperators
servicePrincipals.servicePrincipal.synchronization.templates.synchronizationTemplate.schema.filterOperators 10 params → 2XX4XX5XX
GET
/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/schema/functions()
Microsoft Graph Invoke function functions
servicePrincipals.servicePrincipal.synchronization.jobs.synchronizationJob.schema.functions 10 params → 2XX4XX5XX
GET
/servicePrincipals/{servicePrincipal-id}/synchronization/templates/{synchronizationTemplate-id}/schema/functions()
Microsoft Graph Invoke function functions
servicePrincipals.servicePrincipal.synchronization.templates.synchronizationTemplate.schema.functions 10 params → 2XX4XX5XX
GET
/servicePrincipals/{servicePrincipal-id}/synchronization
Microsoft Graph Get synchronization from servicePrincipals
servicePrincipals.GetSynchronization 3 params → 2XX4XX5XX
PUT
/servicePrincipals/{servicePrincipal-id}/synchronization
Microsoft Graph Update the navigation property synchronization in servicePrincipals
servicePrincipals.SetSynchronization 1 param body → 2XX4XX5XX
DELETE
/servicePrincipals/{servicePrincipal-id}/synchronization
Microsoft Graph Delete navigation property synchronization for servicePrincipals
servicePrincipals.DeleteSynchronization 2 params → 2044XX5XX
GET
/servicePrincipals/{servicePrincipal-id}/synchronization/jobs
Microsoft Graph List synchronization jobs
servicePrincipals.synchronization.ListJobs 9 params → 2XX4XX5XX
POST
/servicePrincipals/{servicePrincipal-id}/synchronization/jobs
Microsoft Graph Create synchronizationJob
servicePrincipals.synchronization.CreateJobs 1 param body → 2XX4XX5XX
GET
/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}
Microsoft Graph Get synchronizationJob
servicePrincipals.synchronization.GetJobs 4 params → 2XX4XX5XX
PATCH
/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}
Microsoft Graph Update the navigation property jobs in servicePrincipals
servicePrincipals.synchronization.UpdateJobs 2 params body → 2XX4XX5XX
DELETE
/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}
Microsoft Graph Delete synchronizationJob
servicePrincipals.synchronization.DeleteJobs 3 params → 2044XX5XX
GET
/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/bulkUpload
Microsoft Graph Get bulkUpload from servicePrincipals
servicePrincipals.synchronization.jobs.GetBulkUpload 4 params → 2XX4XX5XX
PATCH
/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/bulkUpload
Microsoft Graph Update the navigation property bulkUpload in servicePrincipals
servicePrincipals.synchronization.jobs.UpdateBulkUpload 2 params body → 2XX4XX5XX
DELETE
/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/bulkUpload
Microsoft Graph Delete navigation property bulkUpload for servicePrincipals
servicePrincipals.synchronization.jobs.DeleteBulkUpload 3 params → 2044XX5XX
GET
/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/bulkUpload/$value
Microsoft Graph Get media content for the navigation property bulkUpload from servicePrincipals
servicePrincipals.synchronization.jobs.GetBulkUploadContent 2 params → 2XX4XX5XX
PUT
/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/bulkUpload/$value
Microsoft Graph Update media content for the navigation property bulkUpload in servicePrincipals
servicePrincipals.synchronization.jobs.UpdateBulkUploadContent 2 params body → 2XX4XX5XX
DELETE
/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/bulkUpload/$value
Microsoft Graph Delete media content for the navigation property bulkUpload in servicePrincipals
servicePrincipals.synchronization.jobs.DeleteBulkUploadContent 3 params → 2044XX5XX
POST
/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/pause
Microsoft Graph Invoke action pause
servicePrincipals.servicePrincipal.synchronization.jobs.synchronizationJob.pause 2 params → 2044XX5XX
POST
/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/provisionOnDemand
Microsoft Graph Invoke action provisionOnDemand
servicePrincipals.servicePrincipal.synchronization.jobs.synchronizationJob.provisionOnDemand 2 params body → 2XX4XX5XX
POST
/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/restart
Microsoft Graph Invoke action restart
servicePrincipals.servicePrincipal.synchronization.jobs.synchronizationJob.restart 2 params body → 2044XX5XX
POST
/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/start
Microsoft Graph Invoke action start
servicePrincipals.servicePrincipal.synchronization.jobs.synchronizationJob.start 2 params → 2044XX5XX
POST
/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/validateCredentials
Microsoft Graph Invoke action validateCredentials
servicePrincipals.servicePrincipal.synchronization.jobs.synchronizationJob.validateCredentials 2 params body → 2044XX5XX
GET
/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/schema
Microsoft Graph Get synchronizationSchema
servicePrincipals.synchronization.jobs.GetSchema 4 params → 2XX4XX5XX
PATCH
/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/schema
Microsoft Graph Update synchronizationSchema
servicePrincipals.synchronization.jobs.UpdateSchema 2 params body → 2XX4XX5XX
DELETE
/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/schema
Microsoft Graph Delete navigation property schema for servicePrincipals
servicePrincipals.synchronization.jobs.DeleteSchema 3 params → 2044XX5XX
GET
/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/schema/directories
Microsoft Graph Get directories from servicePrincipals
servicePrincipals.synchronization.jobs.schema.ListDirectories 10 params → 2XX4XX5XX
POST
/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/schema/directories
Microsoft Graph Create new navigation property to directories for servicePrincipals
servicePrincipals.synchronization.jobs.schema.CreateDirectories 2 params body → 2XX4XX5XX
GET
/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/schema/directories/{directoryDefinition-id}
Microsoft Graph Get directories from servicePrincipals
servicePrincipals.synchronization.jobs.schema.GetDirectories 5 params → 2XX4XX5XX
PATCH
/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/schema/directories/{directoryDefinition-id}
Microsoft Graph Update the navigation property directories in servicePrincipals
servicePrincipals.synchronization.jobs.schema.UpdateDirectories 3 params body → 2XX4XX5XX
DELETE
/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/schema/directories/{directoryDefinition-id}
Microsoft Graph Delete navigation property directories for servicePrincipals
servicePrincipals.synchronization.jobs.schema.DeleteDirectories 4 params → 2044XX5XX
POST
/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/schema/directories/{directoryDefinition-id}/discover
Microsoft Graph Invoke action discover
servicePrincipals.servicePrincipal.synchronization.jobs.synchronizationJob.schema.directories.directoryDefinition.discover 3 params → 2XX4XX5XX
GET
/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/schema/directories/$count
Microsoft Graph Get the number of the resource
servicePrincipals.synchronization.jobs.schema.directories.GetCount-af56 4 params → 2XX4XX5XX
POST
/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/{synchronizationJob-id}/schema/parseExpression
Microsoft Graph Invoke action parseExpression
servicePrincipals.servicePrincipal.synchronization.jobs.synchronizationJob.schema.parseExpression 2 params body → 2XX4XX5XX
GET
/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/$count
Microsoft Graph Get the number of the resource
servicePrincipals.synchronization.jobs.GetCount-5eba 3 params → 2XX4XX5XX
POST
/servicePrincipals/{servicePrincipal-id}/synchronization/jobs/validateCredentials
Microsoft Graph Invoke action validateCredentials
servicePrincipals.servicePrincipal.synchronization.jobs.validateCredentials 1 param body → 2044XX5XX
POST
/servicePrincipals/{servicePrincipal-id}/synchronization/acquireAccessToken
Microsoft Graph Invoke action acquireAccessToken
servicePrincipals.servicePrincipal.synchronization.acquireAccessToken 1 param body → 2044XX5XX
PUT
/servicePrincipals/{servicePrincipal-id}/synchronization/secrets
Microsoft Graph Add synchronization secrets
servicePrincipals.synchronization.SetSecrets 1 param body → 2XX4XX5XX
GET
/servicePrincipals/{servicePrincipal-id}/synchronization/secrets/$count
Microsoft Graph Get the number of the resource
servicePrincipals.synchronization.Secrets.GetCount-65c9 3 params → 2XX4XX5XX
GET
/servicePrincipals/{servicePrincipal-id}/synchronization/templates
Microsoft Graph List existing synchronization templates
servicePrincipals.synchronization.ListTemplates 9 params → 2XX4XX5XX
POST
/servicePrincipals/{servicePrincipal-id}/synchronization/templates
Microsoft Graph Create new navigation property to templates for servicePrincipals
servicePrincipals.synchronization.CreateTemplates 1 param body → 2XX4XX5XX
GET
/servicePrincipals/{servicePrincipal-id}/synchronization/templates/{synchronizationTemplate-id}
Microsoft Graph Get templates from servicePrincipals
servicePrincipals.synchronization.GetTemplates 4 params → 2XX4XX5XX
PATCH
/servicePrincipals/{servicePrincipal-id}/synchronization/templates/{synchronizationTemplate-id}
Microsoft Graph Update the navigation property templates in servicePrincipals
servicePrincipals.synchronization.UpdateTemplates 2 params body → 2XX4XX5XX
DELETE
/servicePrincipals/{servicePrincipal-id}/synchronization/templates/{synchronizationTemplate-id}
Microsoft Graph Delete navigation property templates for servicePrincipals
servicePrincipals.synchronization.DeleteTemplates 3 params → 2044XX5XX
GET
/servicePrincipals/{servicePrincipal-id}/synchronization/templates/{synchronizationTemplate-id}/schema
Microsoft Graph Get schema from servicePrincipals
servicePrincipals.synchronization.templates.GetSchema 4 params → 2XX4XX5XX
PATCH
/servicePrincipals/{servicePrincipal-id}/synchronization/templates/{synchronizationTemplate-id}/schema
Microsoft Graph Update the navigation property schema in servicePrincipals
servicePrincipals.synchronization.templates.UpdateSchema 2 params body → 2XX4XX5XX
DELETE
/servicePrincipals/{servicePrincipal-id}/synchronization/templates/{synchronizationTemplate-id}/schema
Microsoft Graph Delete navigation property schema for servicePrincipals
servicePrincipals.synchronization.templates.DeleteSchema 3 params → 2044XX5XX
GET
/servicePrincipals/{servicePrincipal-id}/synchronization/templates/{synchronizationTemplate-id}/schema/directories
Microsoft Graph Get directories from servicePrincipals
servicePrincipals.synchronization.templates.schema.ListDirectories 10 params → 2XX4XX5XX
POST
/servicePrincipals/{servicePrincipal-id}/synchronization/templates/{synchronizationTemplate-id}/schema/directories
Microsoft Graph Create new navigation property to directories for servicePrincipals
servicePrincipals.synchronization.templates.schema.CreateDirectories 2 params body → 2XX4XX5XX
GET
/servicePrincipals/{servicePrincipal-id}/synchronization/templates/{synchronizationTemplate-id}/schema/directories/{directoryDefinition-id}
Microsoft Graph Get directories from servicePrincipals
servicePrincipals.synchronization.templates.schema.GetDirectories 5 params → 2XX4XX5XX
PATCH
/servicePrincipals/{servicePrincipal-id}/synchronization/templates/{synchronizationTemplate-id}/schema/directories/{directoryDefinition-id}
Microsoft Graph Update the navigation property directories in servicePrincipals
servicePrincipals.synchronization.templates.schema.UpdateDirectories 3 params body → 2XX4XX5XX
DELETE
/servicePrincipals/{servicePrincipal-id}/synchronization/templates/{synchronizationTemplate-id}/schema/directories/{directoryDefinition-id}
Microsoft Graph Delete navigation property directories for servicePrincipals
servicePrincipals.synchronization.templates.schema.DeleteDirectories 4 params → 2044XX5XX
POST
/servicePrincipals/{servicePrincipal-id}/synchronization/templates/{synchronizationTemplate-id}/schema/directories/{directoryDefinition-id}/discover
Microsoft Graph Invoke action discover
servicePrincipals.servicePrincipal.synchronization.templates.synchronizationTemplate.schema.directories.directoryDefinition.discover 3 params → 2XX4XX5XX
GET
/servicePrincipals/{servicePrincipal-id}/synchronization/templates/{synchronizationTemplate-id}/schema/directories/$count
Microsoft Graph Get the number of the resource
servicePrincipals.synchronization.templates.schema.directories.GetCount-f937 4 params → 2XX4XX5XX
POST
/servicePrincipals/{servicePrincipal-id}/synchronization/templates/{synchronizationTemplate-id}/schema/parseExpression
Microsoft Graph Invoke action parseExpression
servicePrincipals.servicePrincipal.synchronization.templates.synchronizationTemplate.schema.parseExpression 2 params body → 2XX4XX5XX
GET
/servicePrincipals/{servicePrincipal-id}/synchronization/templates/$count
Microsoft Graph Get the number of the resource
servicePrincipals.synchronization.templates.GetCount-1c9d 3 params → 2XX4XX5XX

Schemas 76

The contract defines 76 schemas that model the data the API accepts and returns. The most detailed are microsoft.graph.synchronizationTaskExecution (15 properties), microsoft.graph.synchronizationStatus (13 properties), microsoft.graph.attributeDefinition (13 properties), microsoft.graph.synchronizationRule (11 properties). Each schema is shown below with its type and property counts.

ODataCountResponse
integer
microsoft.graph.mutability
string
microsoft.graph.filterClause
object
4 properties 1 required
microsoft.graph.attributeMapping
object
8 properties 1 required
microsoft.graph.referencedObject
object
3 properties 1 required
microsoft.graph.synchronizationJobApplicationParameters
object
3 properties 1 required
microsoft.graph.ODataErrors.InnerError
object
4 properties 1 required
microsoft.graph.synchronizationQuarantine
object
7 properties 1 required
microsoft.graph.keyValuePair
object
3 properties 1 required
microsoft.graph.objectDefinitionMetadataEntry
object
3 properties 1 required
microsoft.graph.objectDefinition
object
5 properties 1 required
microsoft.graph.synchronizationStatus
object
13 properties 1 required
microsoft.graph.containerFilter
object
2 properties 1 required
microsoft.graph.filter
object
4 properties 1 required
microsoft.graph.directoryDefinitionCollectionResponse
object
microsoft.graph.synchronizationSchedule
object
4 properties 1 required
microsoft.graph.objectMappingMetadata
string
microsoft.graph.filterOperatorSchema
microsoft.graph.expressionInputObject
object
3 properties 1 required
microsoft.graph.attributeMappingSourceType
string
microsoft.graph.scopeOperatorMultiValuedComparisonType
string
microsoft.graph.groupFilter
object
2 properties 1 required
microsoft.graph.ODataErrors.ErrorDetails
object
3 properties 2 required
microsoft.graph.stringKeyLongValuePair
object
3 properties 1 required
microsoft.graph.synchronizationStatusCode
string
microsoft.graph.synchronizationJob
microsoft.graph.stringKeyObjectValuePair
object
2 properties 1 required
microsoft.graph.stringKeyStringValuePair
object
3 properties 1 required
microsoft.graph.synchronizationRule
object
11 properties 1 required
microsoft.graph.attributeMappingFunctionSchema
microsoft.graph.stringKeyAttributeMappingSourceValuePair
object
3 properties 1 required
microsoft.graph.objectDefinitionMetadata
string
microsoft.graph.publicErrorDetail
object
4 properties 1 required
microsoft.graph.synchronizationMetadataEntry
object
3 properties 1 required
microsoft.graph.synchronizationLinkedObjects
object
4 properties 1 required
microsoft.graph.synchronizationProgress
object
5 properties 1 required
microsoft.graph.parseExpressionResponse
object
6 properties 1 required
microsoft.graph.attributeFlowBehavior
string
microsoft.graph.synchronizationJobRestartScope
string
microsoft.graph.synchronizationTaskExecution
object
15 properties 1 required
microsoft.graph.entity
object
2 properties 1 required
microsoft.graph.attributeMappingParameterSchema
object
5 properties 1 required
microsoft.graph.synchronizationSecretKeyStringValuePair
object
3 properties 1 required
microsoft.graph.synchronizationTemplate
microsoft.graph.quarantineReason
string
microsoft.graph.synchronizationError
object
4 properties 1 required
microsoft.graph.attributeDefinition
object
13 properties 1 required
microsoft.graph.synchronizationMetadata
string
microsoft.graph.bulkUpload
microsoft.graph.publicInnerError
object
5 properties 1 required
microsoft.graph.attributeDefinitionMetadataEntry
object
3 properties 1 required
microsoft.graph.synchronization
microsoft.graph.attributeDefinitionMetadata
string
microsoft.graph.synchronizationSecret
string
microsoft.graph.filterOperand
object
2 properties 1 required
microsoft.graph.ODataErrors.MainError
object
5 properties 2 required
microsoft.graph.attributeMappingSource
object
5 properties 1 required
microsoft.graph.synchronizationTaskExecutionResult
string
microsoft.graph.synchronizationSchema
microsoft.graph.synchronizationJobRestartCriteria
object
2 properties 1 required
microsoft.graph.attributeFlowType
string
microsoft.graph.ODataErrors.ODataError
object
1 property 1 required
microsoft.graph.objectMappingMetadataEntry
object
3 properties 1 required
microsoft.graph.synchronizationTemplateCollectionResponse
object
microsoft.graph.attributeType
string
microsoft.graph.directoryDefinitionDiscoverabilities
string
microsoft.graph.synchronizationJobCollectionResponse
object
microsoft.graph.objectMapping
object
9 properties 1 required
microsoft.graph.directoryDefinition
microsoft.graph.filterGroup
object
3 properties 1 required
microsoft.graph.synchronizationJobSubject
object
4 properties 1 required
microsoft.graph.objectFlowTypes
string
microsoft.graph.scopeOperatorType
string
BaseCollectionPaginationCountResponse
object
2 properties
microsoft.graph.synchronizationScheduleState
string
microsoft.graph.publicError
object
6 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

microsoft-graph-serviceprincipals-synchronization-api-openapi.yml Raw ↑

Other APIs Microsoft Graph publishes across the network.

Microsoft Graph Admin.admin API
Microsoft Graph admin.adminMicrosoft365Apps API
Microsoft Graph admin.adminReportSettings API
Microsoft Graph Admin Consent Policy API
Microsoft Graph Admin.edge API
Microsoft Graph admin.peopleAdminSettings API
Microsoft Graph admin.serviceAnnouncement API
Microsoft Graph Admin.sharepoint API
Microsoft Graph Administration API
Microsoft Graph Administrative Units API
Microsoft Graph Agreement Acceptances API
Microsoft Graph Agreement File Localizations API
Where this information came from

This is an independent, third-party profile of Microsoft Graph servicePrincipals.synchronization API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.