Release phone number

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

Response

{
  "message": "Phone number released successfully. It will be removed at the end of the billing period."
}

{
  "message": "Phone number deleted successfully."
}

{
  "error": "Phone number is already scheduled for release."
}

{
  "error": "Phone number not found."
}

{
  "error": "Failed to release phone number. Please try again or contact support."
}

Release Behavior

The release behavior depends on the phone number type:

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