---
title: "Update user"
method: PATCH
path: "/scim/Users/{userUid}"
tags: ["SCIM"]
---

# Update user

`PATCH /scim/Users/{userUid}`

Partially updates a user's attributes using SCIM PATCH operations (RFC 7644 Section 3.5.2).

Only the `replace` operation is supported. Supported target paths:
- `active`
- `externalId`
- `userName`
- `name.givenName`
- `name.familyName`
- `name` (complex object)
- `emails` (complex array)
- `emails[type eq "work"].value`

When `path` is omitted, the value must be an object whose fields are merged into the user resource.

Returns `204 No Content` on success.

## Path parameters

- `userUid` string, required

## Request body

- ScimPatchRequest — SCIM PATCH request body (RFC 7644 Section 3.5.2)
  - `schemas` string[] — SCIM schema URNs
  - `Operations` ScimPatchOperation[], required — List of PATCH operations to apply
    - `op` 'replace', required — Operation type. Only `replace` is supported; `add` and `remove` are rejected.
    - `path` string — Attribute path to update. When omitted, `value` must be an object whose fields are merged into the user. Supported paths: `active`, `externalId`, `userName`, `name.givenName`, `name.familyName`, `name`, `emails`, `emails[type eq "work"].value`.
    - `value` unknown

## Response `204`

User updated successfully — no content returned

## Other responses

- `400` — Bad request — unsupported operation, unsupported path, or malformed body
- `401` — Unauthorized — missing or invalid token
- `404` — User not found or does not belong to the authenticated organization
- `409` — Conflict — userName already in use by another identity
- `422` — Unprocessable entity — business rule violation
- `500` — Internal server error

---

[API](https://skmtc.net/phrase/apis/control-hub-service.md) · [All operations](https://skmtc.net/phrase/apis/control-hub-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/phrase/control-hub-service/revisions/98ecac7ba2bf/schema)