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

# Patch a SCIM user

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

Applies partial modifications (RFC 7644 §3.5.2).

**Behavior & limitations:**
- Removing the required `userName` returns `400`.
- `active: false` **deletes** the user.
- `emails` / `displayName` are not mutable.
- `roles[].value` must be a numeric profile id (a non-numeric value is silently ignored).
- 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 or noTarget
- `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)