---
title: "Replace Phone Number"
method: POST
path: "/v1/phone-numbers/{id}/replace"
---

# Replace Phone Number

`POST /v1/phone-numbers/{id}/replace`

Replaces an existing phone number with a new one with the same configuration. The old number is scheduled for deletion but remains active for callbacks for 30 days.

## Path parameters

- `id` string, uuid, required

## Response `200`

Phone number replaced successfully

- object
  - `oldNumber` PhoneNumber
    - `type` 'PhoneNumber' — Resource type identifier
    - `id` string, uuid — Unique identifier for the phone number
    - `phoneNumber` string — Phone number in E.164 format (e.g. +4917642048466)
    - `inOutboundPool` boolean — Whether this phone number is available for outbound calls
    - `phoneNumberType` 'local' | 'mobile' | 'null', nullable — Type of phone number (local or mobile)
    - `createdAt` string, date-time — When the phone number was added to the account
  - `newNumber` PhoneNumber
    - `type` 'PhoneNumber' — Resource type identifier
    - `id` string, uuid — Unique identifier for the phone number
    - `phoneNumber` string — Phone number in E.164 format (e.g. +4917642048466)
    - `inOutboundPool` boolean — Whether this phone number is available for outbound calls
    - `phoneNumberType` 'local' | 'mobile' | 'null', nullable — Type of phone number (local or mobile)
    - `createdAt` string, date-time — When the phone number was added to the account

## Other responses

- `400` — Invalid request
- `401` — Unauthorized - Invalid API key

---

[API](https://skmtc.dev/telli/apis/telli-api.md) · [All operations](https://skmtc.dev/telli/apis/telli-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/telli/telli-api/revisions/9815a3c63c75/schema)