---
title: "Replace a SCIM user"
method: PUT
path: "/scim/v2/Users/{id}"
tags: ["scim"]
---

# Replace a SCIM user

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

Replaces the mutable attributes of a user (RFC 7644 §3.5.1).

**Behavior & limitations:**
- `emails` and `displayName` are not mutable and are ignored.
- `active: false` **deletes** the user; `active: true` is a no-op.
- Multi-attribute updates are **not atomic**.
- Supply `If-Match` for optimistic concurrency; a stale value returns `412`.

## Path parameters

- `id` string, required

## Headers

- `If-Match` string

## Response `200`

Successful operation

## Other responses

- `400` — Invalid value
- `401` — Authentication token is missing, invalid, or expired
- `404` — User not found
- `412` — If-Match precondition failed

---

[API](https://skmtc.net/ringover/apis/ringover-public-api.md) · [All operations](https://skmtc.net/ringover/apis/ringover-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringover/ringover-public-api/revisions/9da73dd2f99e/schema)