Download OpenAPI Spec
Home
Tree BG 1
Tree
Tree
TreeLeaves
TreeLeaves
Cat IdleGrassGrassRockRock

Beta Admin Scim Endpoints

(beta) Admin - Scim API.

Trigger Scim Sync

POST /v1/admin/scim/sync#

Trigger an on-demand SCIM synchronization for the Organization.

Requires SAML authentication to be enabled and the Organization to be in SCIM user provisioning mode. A dry run previews every change without applying it; a real run applies the categories selected in sync_config. Only one run may be active at a time — a conflicting request returns the already-active run.

202

Accepted

run_id#
*string

Unique identifier of the created SCIM synchronization run.

Playground

Test the endpoints live

curl https://api.mistral.ai/v1/admin/scim/sync \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{}'

202

{
  "run_id": "6f9619ff-8b86-d011-b42d-00cf4fc964ff"
}

Get Scim Sync Run

GET /v1/admin/scim/sync/{run_id}#

Retrieve an on-demand SCIM synchronization run for the Organization.

Returns the run's lifecycle status along with the preview or result summary once the synchronization plan has been built.

200

OK

created_at#
*date-time

Time at which the synchronization run was created.

dry_run#
*boolean

Whether the run only previewed changes.

error_message#
*string|null

Failure detail when the synchronization run could not complete.

finished_at#
*date-time|null

Time at which processing finished, if it has finished.

run_id#
*string

Unique identifier of the SCIM synchronization run.

started_at#
*date-time|null

Time at which processing started, if it has started.

status#
*"PENDING"|"RUNNING"|"SUCCESS"|"SKIPPED"|"FAILED"
summary#
*ScimSyncSummaryOut|null

Preview or result summary, available after the synchronization plan is built.

sync_config#
*AdminScimSyncConfig|null

Categories to synchronize. Required when dry_run is false; ignored for dry runs.

Playground

Test the endpoints live

curl https://api.mistral.ai/v1/admin/scim/sync/{run_id} \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

{
  "created_at": "2026-07-28T10:00:00Z",
  "dry_run": "true",
  "error_message": null,
  "finished_at": null,
  "run_id": "6f9619ff-8b86-d011-b42d-00cf4fc964ff",
  "started_at": null,
  "status": "PENDING",
  "summary": null,
  "sync_config": null
}