Skip to main content
DELETE
Delete Phone Number

Authorizations

Authorization
string
header
default:$CARTESIA_API_KEY
required

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

Headers

Cartesia-Version
enum<string>
default:2026-08-14
required

API version header.

Available options:
2026-08-14
Example:

"2026-08-14"

Path Parameters

id
string
required

The phone number ID. Twilio numbers can be deleted while assigned. Cartesia disconnects the agent and attempts to clear the Twilio webhook, but cleanup failures do not block deletion. Unassign Cartesia-managed and SIP trunk numbers first. Deleting a Cartesia-managed number releases it permanently.

Response

Phone number deleted.