---
title: "Changes to Update a phone number"
method: PATCH
path: "/phone_numbers/{id}"
---

# Changes to Update a phone number

`PATCH /phone_numbers/{id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 68 revisions.

- **2026-10-16** `912b2a3101fc`: 2 info
- **2026-07-14** `645782889002`: 2 info
- **2026-06-30** `40e6c6e044f1`: 1 info

## Changes

- **2026-10-16** `912b2a3101fc`: 2 info
  - added the new optional request property `metadata`
  - added the required property `metadata` to the response with the `200` status
- **2026-07-14** `645782889002`: 2 info
  - response property `campaign_id` deprecated
  - added the required property `campaign` to the response with the `200` status
- **2026-06-30** `40e6c6e044f1`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/surgeapi/apis/surge/docs/phone_numbers/:id/patch.md) - [API](https://skmtc.dev/surgeapi/apis/surge.md) - [Page](https://skmtc.dev/surgeapi/apis/surge/changes/phone_numbers/:id/patch)