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

# Changes to Replace a user's phone number

`PUT /users/{user_id}/phone_number`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 2 of 15 revisions.

- **2026-08-03** `cf036e7951d3` — 1 info
- **2026-06-04** `11bb1ccf4b7d` — 2 info

## Changes

- **2026-08-03** `cf036e7951d3` — 1 info
  - added the new `unverified` enum value to the request property `identification_status`
- **2026-06-04** `11bb1ccf4b7d` — 2 info
  - added the new optional request property `identification_status`
  - added the optional property `verification/oneOf[#/components/schemas/verification_otp]/channel` to the response with the `200` status

---

[Operation](https://skmtc.dev/clerk/apis/clerk-backend-api/docs/users/:user_id/phone_number/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/phone_number/put)