---
title: "Changes to Replace a user's metadata"
method: PUT
path: "/users/{user_id}/metadata"
---

# Changes to Replace a user's metadata

`PUT /users/{user_id}/metadata`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 8 of 49 revisions.

- **2026-10-23** (2025-11-10) `a490313abffa`: 1 warning
- **2026-10-16** (2025-11-10) `7db12d6a9b2a`: 1 info
- **2026-10-02** (2025-11-10) `896a452e4c0c`: 1 info
- **2026-09-18** (2025-11-10) `1f66c253acac`: 9 info
- **2026-09-09** (2025-11-10) `b5f30169c3f3`: 1 info
- **2026-07-30** (2025-11-10) `1d47a6af3bef`: 1 info
- **2026-06-04** (2025-11-10) `4db0b9e2d5e6`: 2 info
- **2026-05-28** (2025-11-10) `e3f2b3a1c567`: 1 info

## Changes

- **2026-10-23** (2025-11-10) `a490313abffa`: 1 warning
  - removed the optional property `organization_memberships/items/organization/allOf[#/components/schemas/Organization]/self_serve_directory_sync_enabled` from the response with the `200` status
- **2026-10-16** (2025-11-10) `7db12d6a9b2a`: 1 info
  - added the optional property `organization_memberships/items/organization/allOf[#/components/schemas/Organization]/self_serve_directory_sync_enabled` to the response with the `200` status
- **2026-10-02** (2025-11-10) `896a452e4c0c`: 1 info
  - added the optional property `timezone` to the response with the `200` status
- **2026-09-18** (2025-11-10) `1f66c253acac`: 9 info
  - added the optional property `directories` to the response with the `200` status
  - added the optional property `directory` to the response with the `200` status
  - added the optional property `scim/allOf[#/components/schemas/SCIMUserMetadata]/groups` to the response with the `200` status
  - the response property `scim/allOf[#/components/schemas/SCIMUserMetadata]/directory_enabled` became required for the status `200`
  - response property `scim` deprecated
  - added the required property `scim/allOf[#/components/schemas/SCIMUserMetadata]/directory_name` to the response with the `200` status
  - added the required property `scim/allOf[#/components/schemas/SCIMUserMetadata]/enterprise_connection_id` to the response with the `200` status
  - added the required property `scim/allOf[#/components/schemas/SCIMUserMetadata]/id` to the response with the `200` status
  - added the required property `scim/allOf[#/components/schemas/SCIMUserMetadata]/provider` to the response with the `200` status
- **2026-09-09** (2025-11-10) `b5f30169c3f3`: 1 info
  - added the optional property `organization_memberships/items/organization/allOf[#/components/schemas/Organization]/self_serve_sso_enabled` to the response with the `200` status
- **2026-07-30** (2025-11-10) `1d47a6af3bef`: 1 info
  - added the optional property `organization_memberships/items/public_user_data/deprovisioned` to the response with the `200` status
- **2026-06-04** (2025-11-10) `4db0b9e2d5e6`: 2 info
  - added the optional property `email_addresses/items/verification/oneOf[#/components/schemas/verification_otp]/channel` to the response with the `200` status
  - added the optional property `phone_numbers/items/verification/oneOf[#/components/schemas/verification_otp]/channel` to the response with the `200` status
- **2026-05-28** (2025-11-10) `e3f2b3a1c567`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/clerk/apis/clerk-backend-api/docs/users/:user_id/metadata/put.md) - [API](https://skmtc.dev/clerk/apis/clerk-backend-api.md) - [Page](https://skmtc.dev/clerk/apis/clerk-backend-api/changes/users/:user_id/metadata/put)