---
title: "Bulk update groups"
method: PATCH
path: "/scim/v2/Groups/bulk"
tags: ["SCIM"]
---

# Bulk update groups

`PATCH /scim/v2/Groups/bulk`

Updates an existing group resource, allowing individual (or groups of) users to be added or removed from the group with a single operation.

Setting the operation attribute of a member object to delete will remove members from a group; add is the default operation for PATCH.

## Request body

- object
  - `schemas` string[], required — List of schema identifiers that define the format of the request.
  - `operations` object[], required — List of operations to be performed on the resource.
    - `op` 'add' | 'remove', required — Operation to be performed. Can be 'add' to add a new item or 'remove' to delete an item.
    - `path` string, required — Path to the item or property to be modified.
    - `value` object[], required — List of values associated with the operation.
      - `value` string — The value to be added or removed.

## Response `200`

OK

- object
  - `schemas` string[] — List of schema identifiers that define the structure of the response.
  - `id` string, nullable
  - `externalId` string, nullable
  - `meta` object, nullable — Metadata about the group.
    - `resourceType` string — Type of resource, which is 'Group' for this object.
    - `location` string
  - `totalResults` integer — Total number of groups returned in the response.
  - `resources` object[] — List of groups included in the response.
    - `schemas` string[] — List of schema identifiers that describe the format of the group.
    - `id` string — Unique identifier for the group.
    - `displayName` string — Name of the group.
    - `members` object[] — List of members associated with the group.
      - `value` string — Identifier for a member of the group.
      - `display` string
    - `urn:zuora:scim:schemas:1.0:GroupExtension` object — Custom attributes for the group defined by the extension schema.
      - `schemas` string[] — List of schema identifiers specific to the extension.
      - `description` string — Additional description for the group.
      - `organizationId` string — Identifier for the organization associated with the group.
      - `active` boolean — Indicates if the group is active.
    - `meta` object — Metadata about the group.
      - `resourceType` string — Type of resource, which is 'Group' for this object.
      - `location` string
  - `startIndex` integer
  - `itemsPerPage` integer

## Other responses

- `204` — No Content
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.dev/zuora/apis/api-reference.md) · [All operations](https://skmtc.dev/zuora/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zuora/api-reference/revisions/d11e237f3e54/schema)