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
Standalone function
The standalone function version of this method:Parameters
Response
Promise<operations.ListScimGroupMappingsResponse>Errors
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
Standalone function
The standalone function version of this method:Parameters
Response
Promise<models.CreateScimGroupMappingResponse>Errors
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
Standalone function
The standalone function version of this method:Parameters
Response
Promise<models.DeleteScimGroupMappingResponse>Errors
read
Get a SCIM group-to-workspace mapping. Management key required.Example Usage
Standalone function
The standalone function version of this method:Parameters
Response
Promise<models.GetScimGroupMappingResponse>Errors
update
Update a SCIM group mapping role. Assigning theadmin role is dashboard-only and returns 403 for management keys. Management key required.