> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cortex.io/llms.txt
> Use this file to discover all available pages before exploring further.

# SCIM Role Mappings

PRIVATE BETA

Use these operations to manage how [SCIM role provisioning](https://docs.cortex.io/configure/settings/managing-users/scim/scim-role-provisioning.md) 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.

> [!NOTE]
>
> 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

> [card] [List SCIM role mappings](https://docs.cortex.io/api/rest/scim-role-mappings/list-scim-role-mappings.md)
>
> `GET /api/v1/scim/role-mappings`

> [card] [Create a SCIM role mapping](https://docs.cortex.io/api/rest/scim-role-mappings/create-a-scim-role-mapping.md)
>
> `POST /api/v1/scim/role-mappings`

> [card] [Delete a SCIM role mapping](https://docs.cortex.io/api/rest/scim-role-mappings/delete-a-scim-role-mapping.md)
>
> `DELETE /api/v1/scim/role-mappings/{id}`


## Related topics

- [Delete a SCIM role mapping](https://docs.cortex.io/api/rest/scim-role-mappings/delete-a-scim-role-mapping.md)
- [List SCIM role mappings](https://docs.cortex.io/api/rest/scim-role-mappings/list-scim-role-mappings.md)
- [Create a SCIM role mapping](https://docs.cortex.io/api/rest/scim-role-mappings/create-a-scim-role-mapping.md)