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
- ListMappings - 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
- ListGroups - List SCIM groups
- CreateSyncJob - Start a SCIM directory sync
- GetSyncJob - Get SCIM directory sync status
ListMappings
List SCIM group-to-workspace mappings for the organization. Management key required.Example Usage
Parameters
Response
*operations.ListScimGroupMappingsResponse, errorErrors
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.CreateScimGroupMappingResponse, errorErrors
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.DeleteScimGroupMappingResponse, errorErrors
Read
Get a SCIM group-to-workspace mapping. Management key required.Example Usage
Parameters
Response
*components.GetScimGroupMappingResponse, errorErrors
Update
Update a SCIM group mapping role. Assigning theadmin role is dashboard-only and returns 403 for management keys. Management key required.