Skip to main content
DELETE
/
agents
/
phone-numbers
/
{id}
Delete Phone Number
curl --request DELETE \
  --url https://api.cartesia.ai/agents/phone-numbers/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Cartesia-Version: <cartesia-version>'

Authorizations

​
Authorization
string
header
required

Cartesia API key (sk_car_...). Get one at play.cartesia.ai/keys.

Headers

​
Cartesia-Version
enum<string>
required

API version header.

Available options:
2026-03-01
Example:

"2026-03-01"

Path Parameters

​
id
string
required

The phone number ID. The phone number must be unassigned from any agent before it can be deleted. For Cartesia-managed numbers, the number is deprovisioned and cannot be recovered.

Response

Phone number deleted.