> ## Documentation Index
> Fetch the complete documentation index at: https://docs.attio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Patch a SCIM group

> Applies partial updates to a SCIM group using SCIM PatchOp operations. Supports updating the display name and adding, removing, or replacing members.

Required scopes: `user_management:read-write`.

Supported token levels: `workspace`.

#### Authorizations

**Authorization** `string` *required*

This API uses OAuth 2.0 with the authorization code grant flow.

#### Path

**workspace\_team\_id** `string` *required*

The ID of the group to update.

Bodyapplication/json

**schemas** `string[]` *required*

Must include `"urn:ietf:params:scim:api:messages:2.0:PatchOp"`.

**Operations** `object[]` *required*

List of patch operations to apply sequentially.

**Operations\[]**

**op** `string` *required*

The operation type: `"add"`, `"remove"`, or `"replace"`.

**path** `string`

The attribute to target, e.g. `"displayName"` or `"members"`. Also supports the SCIM filter path syntax `members[value eq "{id}"]` with `op: "remove"` to remove a specific member. May be omitted when `value` contains a keyed object.

**value** `any`

The value for the operation. For member additions and replacements, must be an array of objects with a `value` property containing a workspace membership ID or workspace invite ID.

#### Response

The response has the same shape as [Update a SCIM group](https://docs.attio.com/rest-api/scim/update-group.md).

```json Add members theme={"system"}
{
  "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
  "Operations": [
    {
      "op": "add",
      "path": "members",
      "value": [{"value": "3a8f5b2c-9e14-4d7a-b832-1c6f85d90e47"}]
    }
  ]
}
```

```json Rename group theme={"system"}
{
  "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
  "Operations": [
    {
      "op": "replace",
      "path": "displayName",
      "value": "Platform Engineering"
    }
  ]
}
```

```json Remove all members theme={"system"}
{
  "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
  "Operations": [
    {
      "op": "remove",
      "path": "members"
    }
  ]
}
```

```json Remove specific member theme={"system"}
{
  "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
  "Operations": [
    {
      "op": "remove",
      "path": "members[value eq \"3a8f5b2c-9e14-4d7a-b832-1c6f85d90e47\"]"
    }
  ]
}
```

```json 200 theme={"system"}
{
  "schemas": ["urn:ietf:params:scim:schemas:core:2.0:Group"],
  "id": "b5d3f8a1-c920-47e6-8b4d-3f17a9c82e50",
  "displayName": "Platform Engineering",
  "members": [
    {
      "value": "3a8f5b2c-9e14-4d7a-b832-1c6f85d90e47",
      "$ref": "/scim/v2/Users/3a8f5b2c-9e14-4d7a-b832-1c6f85d90e47"
    }
  ],
  "meta": {
    "resourceType": "Group",
    "created": "2024-01-01T00:00:00.000Z",
    "lastModified": "2024-01-02T00:00:00.000Z"
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.