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

​
id
integer
required
Unique identifier of the phone number to release.

​
Response

​
message
string
Confirmation message indicating the release status.

​
Release behavior

TypeBehavior
Dedicated (normal)Subscription is cancelled. Number remains active until the end of the billing period, then is released.
SIPImmediately deleted from your account.
Caller IDImmediately deleted from your account and removed from the telephony provider.

​
Example

curl -X DELETE "https://portal.intellixent.ai/api/user/phone-numbers/123" \
  -H "Authorization: Bearer YOUR_API_KEY"
200 Subscription cancelled
{
  "message": "Phone number released successfully. It will be removed at the end of the billing period."
}
200 Immediately deleted
{
  "message": "Phone number deleted successfully."
}
404 Not found
{
  "error": "Phone number 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.