---
title: "Update user metadata"
method: PUT
path: "/v3/users/{user_id}/metadata"
tags: ["User"]
---

# Update user metadata

`PUT /v3/users/{user_id}/metadata`

## Request

- Base URL: `https://api-APP_ID.sendbird.com`
- URL: `https://api-APP_ID.sendbird.com/v3/users/{user_id}/metadata`
- Auth: none declared

## Update metadata When updating existing items of the user metadata by their keys or adding new items to the metadata
https://sendbird.com/docs/chat/platform-api/v3/user/managing-metadata/user-update-metadata

## Path parameters

- `user_id` string, required

## Headers

- `api-token` string

## Request body

- UpdateUserMetadataRequest
  - `metadata` object, nullable, required
  - `upsert` boolean, nullable

## Response `200`

Successful response

- UpdateUserMetadataResponse

## Changes

- **2026-01-05** `0b5bb7238836`: 1 info
  - endpoint added
- **2025-07-27** `7a85bad03e90`: 1 breaking
  - api path removed without deprecation
- **2023-11-10** `135d8b0705d4`: 1 info
  - the `header` request parameter `Api-Token` became optional
- **2022-07-27** `0b6cf41bc62a`: 1 breaking, 2 info
  - the `metadata` request property type changed from `string` to `object`
  - api tag `Metadata` added
  - api tag `User` removed
- **2022-06-29** `4012275aa67d`: 2 info
  - api tag `User` added
  - api tag `User & channel metadata` removed

[Operation history](https://skmtc.dev/sendbird/apis/sendbird-platform-sdk/changes/v3/users/:user_id/metadata/put.md)

---

[API](https://skmtc.dev/sendbird/apis/sendbird-platform-sdk.md) - [All operations](https://skmtc.dev/sendbird/apis/sendbird-platform-sdk/llms.txt) - [OpenAPI document](https://skmtc.dev/sendbird/apis/sendbird-platform-sdk/revisions/9e53a5288df0?raw)