Skip to main content
DELETE
Release Phone Number
This endpoint releases a phone number from your account. For dedicated numbers with subscriptions, the subscription is cancelled and the number will be released at the end of the current billing period.

Path Parameters

integer
required
The unique identifier of the phone number to release

Response Fields

string
Success message indicating the release status

Release Behavior

The release behavior depends on the phone number type:
Once a phone number is released, you may not be able to get the same number back. Make sure to update all assistants or campaigns using this number before releasing it.

What Happens to Associated Resources

When you release a phone number:
  • All inbound assistants assigned to this number will have their phone number removed
  • All campaigns using this number will have it removed from their phone number rotation
  • Call history is preserved and remains accessible