---
title: "Update a contact's phone number"
method: PUT
path: "/contacts/{contactId}/numbers/{number}"
tags: ["contacts"]
---

# Update a contact's phone number

`PUT /contacts/{contactId}/numbers/{number}`

Replaces a specific phone number on a contact. The number in the URL path is the existing number to replace; the new number is provided in the JSON request body. Phone numbers must be in E.164 format.

**Permission:** `Contacts Write` required.

**Monitoring:** No impact.

## Path parameters

- `contactId` integer, required
- `number` integer, required

## Request body

- NumberLight
  - `number` integer
  - `type` string

## Response `201`

Phone number successfully updated.

## Other responses

- `304` — Phone number was not modified — new value is identical.
- `400` — Invalid request body or ID — check phone number format (E.164).
- `401` — Unauthorized — missing or invalid API token, or missing `Contacts Write` permission.
- `404` — Contact not found — no contact matches the provided ID.
- `500` — Internal server error.

---

[API](https://skmtc.net/ringover/apis/ringover-public-api.md) · [All operations](https://skmtc.net/ringover/apis/ringover-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringover/ringover-public-api/revisions/9da73dd2f99e/schema)