---
title: "Patch Phone Number"
method: PATCH
path: "/v4/accounts/{voip_id}/phone-numbers/{id}"
tags: ["Phone Numbers"]
---

# Patch Phone Number

`PATCH /v4/accounts/{voip_id}/phone-numbers/{id}`

## Request

- Base URL: `https://api.phone.com`
- URL: `https://api.phone.com/v4/accounts/{voip_id}/phone-numbers/{id}`
- Auth: HTTP bearer

Replace parameters on an individual Phone Number

## Path parameters

- `voip_id` integer, required
- `id` integer, required

## Request body

- PhoneNumber
  - `name` string, nullable: Name
  - `route` object, nullable: The Route assigned to handle incoming calls for this number, if any.
    - `id` integer, nullable: Route ID. Read-only.
    - `name` string, nullable: Route name
  - `block_incoming` boolean, nullable: Whether to block incoming calls.
  - `block_anonymous` boolean, nullable: Whether to block anonymous calls.
  - `caller_id` object: Caller ID Object
    - `name` string, nullable: Name that this number will be associated with. Must be no longer than 15 characters, and can only contain English letters, numbers, spaces, and commas.
    - `type` 'business' | 'personal', nullable: Can be 'business' or 'personal'
  - `sms_forwarding` object: SMS Forwarding Object
    - `type` 'application' | 'extension': Can be 'extension' or 'application'
    - `application` unknown
    - `extension` unknown
  - `call_notifications` object: Call Notifications Object
    - `emails` string[], nullable: Array of email addresses
    - `sms` string, nullable: A phone number capable of receiving SMS messages
  - `reservation_id` string, nullable: Reserve phone number ID
  - `phone_number` unknown
  - `record_calls` boolean, nullable: Record calls (feature needs to be enabled on account level)

## Response `200`

OK

- object

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `402`: Payment Required
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `422`: Validation failed
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/phone/apis/phoenix-api-by-phone-com.md) · [All operations](https://skmtc.dev/phone/apis/phoenix-api-by-phone-com/llms.txt) · [OpenAPI document](https://skmtc.dev/phone/apis/phoenix-api-by-phone-com/revisions/70c6c9ab8d8f?raw)