Release phone number
Phone Numbers
Release phone number
Release a phone number and cancel its subscription
DELETE
Release phone number
This endpoint releases a phone number from your account. For dedicated numbers with subscriptions, this cancels the subscription and the number will be released at the end of the current billing period.
Path Parameters
The unique identifier of the phone number to release
Response
Success message indicating the release status
Release Behavior
The release behavior depends on the phone number type:What Happens to Attached Resources
When you release a phone number:- Any inbound assistants attached to this number will have their phone number unassigned
- Any campaigns using this number will have it removed from their phone number rotation
- Call history is preserved and remains accessible

