# Replace User

`PUT /Users/{id}`

## Description

Fully replaces a user's attributes. You must provide all required fields in the request body.

**Roam-specific behavior:**
- `userName` and `emails` are **immutable** — any attempt to change them returns a 400 error
- You can update `name.givenName`, `name.familyName`, `active`, `externalId`, and `role`
- Set `active: false` to archive the user; `active: true` to reactivate

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 user

---

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