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 ⚠️ Deprecateddelete- Delete a SCIM group mapping ⚠️ Deprecated- read - Get a SCIM group mapping
update- Update a SCIM group mapping ⚠️ Deprecated- list_groups - List SCIM groups
create_sync_job- Start a SCIM directory sync ⚠️ Deprecated- 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. Disabled: no API key can perform this write, including management keys. Use the organization settings in the dashboard, which require step-up verification. A valid management key for an organization with SCIM access receives 403; an invalid key still receives 401 and an organization without SCIM access receives 404.
⚠️ DEPRECATED: This will be removed in a future release, please migrate away from it as soon as possible.
Example Usage
Parameters
Response
components.CreateScimGroupMappingResponseErrors
delete
Delete a SCIM group-to-workspace mapping. Disabled: no API key can perform this write, including management keys. Use the organization settings in the dashboard, which require step-up verification. A valid management key for an organization with SCIM access receives 403; an invalid key still receives 401 and an organization without SCIM access receives 404.
⚠️ DEPRECATED: This will be removed in a future release, please migrate away from it as soon as possible.
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. Disabled: no API key can perform this write, including management keys. Use the organization settings in the dashboard, which require step-up verification. A valid management key for an organization with SCIM access receives 403; an invalid key still receives 401 and an organization without SCIM access receives 404.
⚠️ DEPRECATED: This will be removed in a future release, please migrate away from it as soon as possible.
Example Usage
Parameters
Response
components.UpdateScimGroupMappingResponseErrors
list_groups
List SCIM groups for the organization. Management key required.Example Usage
Parameters
Response
operations.ListScimGroupsResponseErrors
create_sync_job
Start a SCIM directory sync. Disabled: no API key can perform this write, including management keys. Use the organization settings in the dashboard, which require step-up verification. A valid management key for an organization with SCIM access receives 403; an invalid key still receives 401 and an organization without SCIM access receives 404.
⚠️ DEPRECATED: This will be removed in a future release, please migrate away from it as soon as possible.