Skip to main content
Use these operations to manage how SCIM role provisioning maps the role values your identity provider sends to Cortex roles. Each mapping connects one role value to one built-in or custom role. A custom role is identified by its tag. There is no update operation. To change a mapping, delete it and create a new one.
SCIM role provisioning is in Private Beta and is only available for Microsoft Entra ID. To request access, contact your Cortex account team. Until it is enabled for your workspace, these operations return 404.

​
Required permissions

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

​
Operations

List SCIM role mappings

GET /api/v1/scim/role-mappings

Create a SCIM role mapping

POST /api/v1/scim/role-mappings

Delete a SCIM role mapping

DELETE /api/v1/scim/role-mappings/{id}
Last modified on November 10, 2026