Skip to main content
DELETE
/
user
/
phone-numbers
/
{id}
Release phone number
curl --request DELETE \
  --url https://app.autocalls.ai/api/user/phone-numbers/{id} \
  --header 'Authorization: Bearer <token>'
{
  "message": "Phone number released successfully. It will be removed at the end of the billing period."
}

Documentation Index

Fetch the complete documentation index at: https://docs.autocalls.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

​
id
integer
required
The unique identifier of the phone number to release

​
Response

​
message
string
Success message indicating the release status
{
  "message": "Phone number released successfully. It will be removed at the end of the billing period."
}

​
Release Behavior

The release behavior depends on the phone number type:
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.
Once a phone number is released, you may not be able to get the same number back. Make sure to update any assistants or campaigns using this number before releasing it.

​
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