# Replace Group

`PUT /Groups/{id}`

## Description

Fully replaces a group's attributes. The entire `members` list is replaced with the provided values.

**Required fields:** `displayName` (max 64 characters).

**Note:** This is a full replacement — any members not included in the request will be removed from the group.

**Member resolution is best-effort:** member IDs that do not resolve to an active user in your account (unknown IDs, or archived users) are skipped rather than failing the request, so a stale member in the IdP-side group cannot wedge the sync. Archived users' existing memberships are never removed by a sync. The response reflects the membership actually applied.

See [RFC 7644 §3.5.1](https://www.rfc-editor.org/rfc/rfc7644#section-3.5.1) for SCIM resource replacement.

## Request Body

## Responses

### 200 - Updated group

---

*Machine-readable API documentation.*
*Full documentation: https://developer.ro.am/docs/scim/02-groups-replace*