Skip to main content
Releases a phone number from your account. For dedicated numbers, this cancels the subscription and the number is released at the end of the current billing period.

Endpoint

DELETE /user/phone-numbers/{id}

Path parameters

integer
required
Unique identifier of the phone number to release.

Response

string
Confirmation message indicating the release status.

Release behavior

Example

200 Subscription cancelled
200 Immediately deleted
404 Not found
Once released, you may not be able to reclaim the same number. Update any assistants or campaigns using this number before releasing it.
When you release a phone number:
  • Inbound assistants assigned to this number will have the number unassigned.
  • Campaigns using this number will have it removed from their rotation.
  • Call history is preserved and remains accessible.