Skip to main content
Use these operations to interact with SCIM-provisioned users in Cortex.

Required permissions

  • Your API key must have the Configure Open ID Connector & SCIM permission.

Required SCIM toggles

Each operation is gated on the matching SCIM toggle in your workspace settings. A request whose required toggle is off is rejected without taking effect: A user created or reactivated while automatic provisioning is enabled is assigned your workspace’s default role, unless SCIM role provisioning is on. In that case, the user gets the roles mapped to the roles values in the request.

Operations

For the filter string in the Find users operation, use a value of userName eq "<email>" to return a result based on an email value.

Find users

GET /scim/v2/Users

Gets a user by id

GET /scim/v2/Users/{id}

Creates a user

POST /scim/v2/Users

Updates a user

PUT /scim/v2/Users/{id}

Patches a user

PATCH /scim/v2/Users/{id}

Deletes a user

DELETE /scim/v2/Users/{id}
Last modified on November 10, 2026