---
title: "Update User Group"
method: PUT
path: "/api/scim/v3/Groups/{groupId}"
tags: ["User Groups V3"]
---

# Update User Group

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

Use this API to fully update user group details and user 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 Enhanced SCIM Integration that leverages Group Provisioning to manage access for users by provisioning them to one or more user groups. For more information, see [SCIM User & Group Provisioning](https://my.onetrust.com/s/article/UUID-93f936ef-8076-280c-a58e-ba2d3437dfad).
> - When this API is called, the existing list of users that are members of the user 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 user 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 details modified 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)