---
title: "Update a group"
method: PUT
path: "/scim/v2/Groups/{id}"
tags: ["SCIM"]
---

# Update a group

`PUT /scim/v2/Groups/{id}`

Updates an existing group resource, overwriting all values for a group even if an attribute is empty or not provided.
PUT will replace all members of a group with those members provided via the members attribute. If an attribute that had been set previously is left blank during a PUT operation, the new value will be blank in accordance with the data type of the attribute and the storage provider.

## Path parameters

- `id` string, required

## Headers

- `Idempotency-Key` string
- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Track-Id` string
- `Zuora-Entity-Ids` string

## Request body

- object
  - `schemas` string[] — List of schema URNs defining the structure of the request.
  - `operations` object[]
    - `op` string, required — The operation to perform (e.g., add, remove, replace).
    - `path` string, required — The path to the attribute that is being modified.
    - `value` object[], required
      - `value` string, required — The value to be added.

## Response `200`

OK

- object
  - `schemas` string[] — List of schema identifiers that define the structure of the group resource.
  - `id` string — Unique identifier assigned to the group.
  - `displayName` string — Name of the group.
  - `members` object[] — List of members associated with the group.
    - `value` string — Unique identifier of a member within the group.
    - `display` string
  - `urn:zuora:scim:schemas:1.0:GroupExtension` object — Custom attributes specific to the group defined by the extension schema.
    - `schemas` string[] — List of schema identifiers that define the format of the custom attributes.
    - `description` string — Additional description or notes about the group.
    - `organizationId` string — Identifier for the organization to which the group belongs.
    - `active` boolean — Indicates whether the group is currently active.
  - `meta` object — Metadata related to the group resource.
    - `resourceType` 'Group' — Type of the resource, which is 'Group' for this object.
    - `location` string — URL where the group resource can be accessed.

## Other responses

- `201` — Created
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

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