---
title: "✨ Update SCIM Settings"
method: POST
path: "/api/scim/settings"
tags: ["SSO"]
---

# ✨ Update SCIM Settings

`POST /api/scim/settings`

<Card href="https://humansignal.com/goenterprise">
        <img style="pointer-events: none; margin-left: 0px; margin-right: 0px;" src="https://docs.humansignal.com/images/badge.svg" alt="Label Studio Enterprise badge"/>
        <p style="margin-top: 10px; font-size: 14px;">
            This endpoint is not available in Label Studio Community Edition. [Learn more about Label Studio Enterprise](https://humansignal.com/goenterprise)
        </p>
    </Card>
Update SCIM settings for the currently active organization.

## Request body

- ScimSettingsUpdateRequest
  - `projects_groups` ProjectGroupRequest[] — Projects to Groups Mapping. List of objects with project_id, group, role.
    - `group` string, required — Group name
    - `project_id` integer, required — Project ID
    - `role` 'Inherit' | 'Annotator' | 'Reviewer', required — * `Inherit` - Inherit * `Annotator` - Annotator * `Reviewer` - Reviewer
  - `roles_groups` array[] — Organization Roles to Groups Mapping. List of [role_name, group_name] pairs.
    - string[]
  - `workspaces_groups` array[] — Workspaces to Groups Mapping. List of [workspace_title, group_name] pairs.
    - string[]

## Response `201`

- ScimSettingsUpdate
  - `projects_groups` ProjectGroup[] — Projects to Groups Mapping. List of objects with project_id, group, role.
    - `group` string, required — Group name
    - `project_id` integer, required — Project ID
    - `role` 'Inherit' | 'Annotator' | 'Reviewer', required — * `Inherit` - Inherit * `Annotator` - Annotator * `Reviewer` - Reviewer
  - `roles_groups` array[] — Organization Roles to Groups Mapping. List of [role_name, group_name] pairs.
    - string[]
  - `workspaces_groups` array[] — Workspaces to Groups Mapping. List of [workspace_title, group_name] pairs.
    - string[]

---

[API](https://skmtc.net/humansignal/apis/label-studio-api.md) · [All operations](https://skmtc.net/humansignal/apis/label-studio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/humansignal/label-studio-api/versions/1b113b8df950/schema)