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

# Modify User Group

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

Use this API to partially update user group details and/or 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 a user is added as a member of a user group, the user is provisioned with the role and organization configured for that user group. If the user belongs to other user groups, the user will still retain existing membership with those groups as users can be assigned to multiple roles and multiple organizations.

## Path parameters

- `groupId` string, uuid, required

## Request body

- PatchGroupResourceRequest
  - `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 — Display name of the group
  - `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
  - `Operations` Operation[]
    - `op` 'add' | 'replace' | 'remove' — The operation type
    - `path` string — The path of the attribute being operated on
    - `displayName` string — The display name of the group
    - `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

## Response `204`

No Content

Group details updated successfully.

## 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)