---
title: "Update Phone Number"
method: PUT
path: "/v1/application/users/{userId}/phone-numbers/{phoneNumberId}"
tags: ["user-security"]
deprecated: true
---

# Update Phone Number

`PUT /v1/application/users/{userId}/phone-numbers/{phoneNumberId}`

> **Deprecated.**

Update a verified phone number for a user.

{% admonition type="warning" %}
This endpoint is restricted and requires both a client credentials token and additional access to use. Please speak with your implementation manager if you would like to use this API.
{% /admonition %}

## Path parameters

- `userId` integer, required
- `phoneNumberId` integer, required

## Headers

- `X-External-Correlation-Id` string, uuid

## Request body

- object
  - `phoneNumber` string — A valid phone number in string.

## Response `200`

OK

- PhoneNumber
  - `id` integer — ID of the phone number.
  - `phoneNumber` string — A text representation of phone number.
  - `type` string — Type of phone number when used in authentication. Only **PRIMARY** is supported at the moment.
  - `verified` boolean — Indicator if phone number is verified.
  - `clientId` string — Client ID of which this phone number belongs to.

## Other responses

- `422` — The phone number is already associated with another account.
- `429` — Rate limit exceeded. Retry after the number of seconds specified in the `Retry-After` header.

---

[API](https://skmtc.net/wise/apis/platform-api.md) · [All operations](https://skmtc.net/wise/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wise/platform-api/revisions/4907a1d269ab/schema)