---
title: "Update phone number"
method: PATCH
path: "/internal/telephony/phone-numbers/{id}"
tags: ["Telephony - Phone Numbers"]
---

# Update phone number

`PATCH /internal/telephony/phone-numbers/{id}`

Update phone number details.

## Path parameters

- `id` string, uuid, required

## Request body

- UpdatePhoneNumber
  - `status` 'pending' | 'active' | 'payment_failed' | 'activation_failed' — Phone number status
  - `type` 'inbound_outbound' | 'outbound_only' — Phone number type
  - `telephonyId` string, nullable
  - `engineId` string, nullable
  - `available` boolean

## Response `200`

Phone number updated

- PhoneNumber
  - `id` string, uuid, required — Unique identifier
  - `workspaceId` string, uuid, required — Workspace ID
  - `number` string, required — Phone number in E.164 format
  - `countryDial` string, nullable, required — Country dialing code
  - `status` 'pending' | 'active' | 'payment_failed' | 'activation_failed', required — Phone number status
  - `type` 'inbound_outbound' | 'outbound_only', required — Phone number type
  - `engineId` string, nullable, required — Voice engine ID
  - `telephonyId` string, nullable, required — Provider phone number ID
  - `price` number, nullable, required — Monthly price in USD
  - `purchasedAt` string, date-time, nullable, required — Purchase timestamp
  - `renewalAt` string, date-time, nullable, required — Next renewal timestamp
  - `dialsToday` number, required — Dials today
  - `dialsTotal` number, required — Total dials
  - `available` boolean, required — Available for use
  - `deletedAt` string, date-time, nullable, required — Soft delete timestamp
  - `createdAt` string, date-time, required — Creation timestamp
  - `updatedAt` string, date-time, required — Last update timestamp

## Other responses

- `400` — Validation error
- `401` — Unauthorized
- `404` — Not found

---

[API](https://skmtc.net/nedzo/apis/nedzo-api.md) · [All operations](https://skmtc.net/nedzo/apis/nedzo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nedzo/nedzo-api/versions/f2607cdb56fa/schema)