Release number

Release a phone number and cancel its subscription.

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

Type	Behavior
Dedicated (normal)	Subscription is cancelled. Number remains active until the end of the billing period, then is released.
SIP	Immediately deleted from your account.
Caller ID	Immediately deleted from your account and removed from the telephony provider.

Example

cURL

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.