---
title: "Delete Phone Number"
method: DELETE
path: "/v1/convai/phone-numbers/{phone_number_id}"
tags: ["Agents Platform"]
---

# Delete Phone Number

`DELETE /v1/convai/phone-numbers/{phone_number_id}`

## Request

- Base URL: `https://api.elevenlabs.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.elevenlabs.io/v1/convai/phone-numbers/{phone_number_id}`
- Auth: none declared

Delete Phone Number by ID

## Path parameters

- `phone_number_id` string, required: The phone number ID. This is returned when a phone number is imported.

## Headers

- `xi-api-key` string, nullable: Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-02-08** `5b595807512c`: 3 info
  - api operation id `Delete_phone_number_v1_convai_phone_numbers__phone_number_id__delete` removed and replaced with `delete_phone_number_route`
  - api tag `Agents Platform` added
  - api tag `Conversational AI` removed
- **2025-05-16** `503db4198a44`: 2 info
  - `header` request parameter `xi-api-key` list-of-types was widened by adding types `null`
  - for the `header` request parameter `xi-api-key`, the type was generalized from `string` to no type
- **2024-12-02** `d04ae85f47ff`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/changes/v1/convai/phone-numbers/:phone_number_id/delete.md)

---

[API](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation.md) - [All operations](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/revisions/d04f5e77c40a?raw)