---
title: "Update User - PATCH"
method: PATCH
path: "/Users/{id}"
tags: ["Users Endpoint"]
---

# Update User - PATCH

`PATCH /Users/{id}`

This API updates user details and returns the updated user details using a PATCH operation.

  - <b>Scope(Permission) required:</b> ``internal_user_mgt_update``

 - <b>Supported Operations:</b>``add``, ``replace``, ``remove``

 - <b>Flow type:</b> Client Credentials OAuth Flow

## Path parameters

- `id` string, required

## Query parameters

- `attributes` string
- `excludedAttributes` string

## Response `200`

Valid user is found

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Valid user is not found

## Changes

- **2025-08-05** `d290ee2c70fc` — 3 breaking, 1 info
  - the `schemas/items/` request property type/format changed from `string`/`` to `object`/``
  - the `roles` response's property type/format changed from `array`/`` to `object`/`` for status `200`
  - the `schemas` response's property type/format changed from `array`/`` to `object`/`` for status `200`
  - response property `emails/items/` list-of-types was narrowed by removing types `string` from media type `application/scim+json` of response `200`

[Change history](https://skmtc.dev/ballerina-platform/apis/scim-2-0-api/changes/Users/:id/patch.md)

---

[API](https://skmtc.dev/ballerina-platform/apis/scim-2-0-api.md) · [All operations](https://skmtc.dev/ballerina-platform/apis/scim-2-0-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ballerina-platform/scim-2-0-api/revisions/d290ee2c70fc/schema)