Overview
Management endpoints for SCIM group-to-workspace mappings, authenticated with a management key. These are not the SCIM 2.0 connector endpoints for your identity provider. In your identity provider, enter the SCIM endpoint URL shown when you enable provisioning under Settings > Members > SCIM Mappings. See https://openrouter.ai/docs/guides/features/scim-mappings#set-up-provisioning.Available Operations
- list_mappings - List SCIM group mappings
- create - Create a SCIM group mapping
- delete - Delete a SCIM group mapping
- read - Get a SCIM group mapping
- update - Update a SCIM group mapping
- list_groups - List SCIM groups
- create_sync_job - Start a SCIM directory sync
- get_sync_job - Get SCIM directory sync status
list_mappings
List SCIM group-to-workspace mappings for the organization. Management key required.Example Usage
Parameters
Response
operations.ListScimGroupMappingsResponseErrors
create
Create a SCIM group-to-workspace role mapping. Creating a mapping that already exists with the same role succeeds and re-applies the mapping to the group members. Requesting a different role for an existing mapping returns 409. Assigning theadmin role is dashboard-only and returns 403 for management keys. Management key required.
Example Usage
Parameters
Response
components.CreateScimGroupMappingResponseErrors
delete
Delete a SCIM group-to-workspace mapping. For anadmin mapping, keep_members=true returns 403 and leaves the mapping in place — preserving members as workspace admins is dashboard-only. Management key required.
Example Usage
Parameters
Response
components.DeleteScimGroupMappingResponseErrors
read
Get a SCIM group-to-workspace mapping. Management key required.Example Usage
Parameters
Response
components.GetScimGroupMappingResponseErrors
update
Update a SCIM group mapping role. Assigning theadmin role is dashboard-only and returns 403 for management keys. Management key required.