---
title: "Update Group"
method: PUT
path: "/api/scim/v2/Groups/{groupId}"
tags: ["Groups V2"]
---

# Update Group

`PUT /api/scim/v2/Groups/{groupId}`

Use this API to fully update SCIM group details and SCIM group membership. This API should only be used when provisioning and managing users from your Identity Provider using the System for Cross-Domain Identity Management (SCIM) standard to facilitate the automated creation of user identities from a third-party identity management application.

> 🗒 Things to Know
>
> - This API supports OneTrust's Legacy SCIM Integration that leverages SCIM groups, which are unique role-organization combinations that each represent a specific role within a particular organization. For more information, see [Legacy SCIM User Provisioning](https://my.onetrust.com/s/article/UUID-abda73a7-4996-c1b4-2e2a-e46aa3f2a3cc).
> - When a user is added as a member of a SCIM group, the user is provisioned with that specific role-organization combination. If the user belongs to other SCIM groups, the user will still retain existing membership with those groups as users can be assigned to multiple roles and multiple organizations.
> - When this API is called, the existing list of users that are members of the SCIM group will be replaced with the new list of users defined in the request. If no users are specified, the existing list of users will be removed from the SCIM group.

## Path parameters

- `groupId` string, uuid, required

## Request body

- GroupResource
  - `id` string, uuid — Unique identifier for the user created by the OneTrust application.
  - `externalId` string — External Id
  - `meta` Meta
    - `created` string, date-time — The date and time when the resource was created
    - `lastModified` string, date-time — The date and time when the resource was last modified
    - `location` string, uri — The URL for the resource
    - `version` string — The version of the resource
    - `attributes` unknown[]
      - unknown
    - `resourceType` 'User' | 'Group' | 'ResourceType' | 'ServiceProviderConfig' | 'Schema' — The resource type
  - `schemas` string[]
  - `displayName` string, required — Assessments Manager - ADFS
  - `members` Member[]
    - `value` string, uuid, required — The unique ID of the user that you want to add to the Group.
    - `type` 'User' — The type of the resource.
    - `$ref` string, url — A hyperlink to the resource
  - `urn:ietf:params:scim:schemas:onetrust:Group` OneTrustGroup
    - `category` string — The display name of the group
    - `description` string — The description of the group

## Response `200`

OK

Group members updated successfully.

- GroupResource
  - `id` string, uuid — Unique identifier for the user created by the OneTrust application.
  - `externalId` string — External Id
  - `meta` Meta
    - `created` string, date-time — The date and time when the resource was created
    - `lastModified` string, date-time — The date and time when the resource was last modified
    - `location` string, uri — The URL for the resource
    - `version` string — The version of the resource
    - `attributes` unknown[]
      - unknown
    - `resourceType` 'User' | 'Group' | 'ResourceType' | 'ServiceProviderConfig' | 'Schema' — The resource type
  - `schemas` string[]
  - `displayName` string, required — Assessments Manager - ADFS
  - `members` Member[]
    - `value` string, uuid, required — The unique ID of the user that you want to add to the Group.
    - `type` 'User' — The type of the resource.
    - `$ref` string, url — A hyperlink to the resource
  - `urn:ietf:params:scim:schemas:onetrust:Group` OneTrustGroup
    - `category` string — The display name of the group
    - `description` string — The description of the group

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `429` — Too Many Requests. For more information, see [API Rate Limits](https://developer.onetrust.com/onetrust/reference/rate-limits-overview).
- `500` — Internal Server Error

---

[API](https://skmtc.net/onetrust/apis/platform-access-management.md) · [All operations](https://skmtc.net/onetrust/apis/platform-access-management/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/onetrust/platform-access-management/versions/21de3aa0b170/schema)