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

# Modify Group

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

Use this API to partially update SCIM group details and/or 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.

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

OK

Group members 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)