---
title: "Partially update user"
method: PATCH
path: "/users"
tags: ["product:chat"]
---

# Partially update user

`PATCH /users`

Updates certain fields of the user

Sends events:
- user.presence.changed
- user.updated

## Request body

- UpdateUsersPartialRequest, nullable
  - `users` UpdateUserPartialRequest[], required
    - `id` string, required — User ID to update
    - `set` object
    - `unset` string[]

## Response `200`

Successful response

- UpdateUsersResponse, nullable
  - `duration` string, required — Duration of the request in milliseconds
  - `membership_deletion_task_id` string, required
  - `users` object, required — Object containing users

## Other responses

- `400` — Bad request
- `429` — Too many requests

## Changes

> 108 revisions in range; 2 not diffed, 10 could not be searched.

- **2026-08-04** `3a53189f9dc6` — 2 info
  - added the optional property `users/additionalProperties/channel_mutes/items/channel/members/items/ban_from_future_channels` to the response with the `200` status
  - added the optional property `users/additionalProperties/channel_mutes/items/channel/members/items/future_channel_ban_expires` to the response with the `200` status
- **2026-07-29** `d274674f0337` — 19 breaking, 5 warning, 24 info
  - the response property `users/additionalProperties/channel_mutes/items/channel/members/items/` became nullable for the status `200`
  - the response property `users/additionalProperties/channel_mutes/items/channel/created_by/privacy_settings/delivery_receipts/enabled` became optional for the status `200`
  - the response property `users/additionalProperties/channel_mutes/items/channel/created_by/privacy_settings/read_receipts/enabled` became optional for the status `200`
  - the response property `users/additionalProperties/channel_mutes/items/channel/created_by/privacy_settings/typing_indicators/enabled` became optional for the status `200`
  - …44 more

[Change history](https://skmtc.dev/getstream/apis/stream-api/changes/users/patch.md)

---

[API](https://skmtc.dev/getstream/apis/stream-api.md) · [All operations](https://skmtc.dev/getstream/apis/stream-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getstream/stream-api/revisions/653d3d10a523/schema)