Skip to main content
DELETE
/
api
/
v1
/
Account
/
{auth_id}
/
numbers
/
{e164}
Unrent a number
curl --request DELETE \
  --url https://api.vobiz.ai/api/v1/Account/{auth_id}/numbers/{e164} \
  --header 'X-Auth-ID: <api-key>' \
  --header 'X-Auth-Token: <api-key>'
DELETE https://api.vobiz.ai/api/v1/Account/{auth_id}/numbers/{e164}
Releases a phone number from your account back to inventory. This operation cannot be undone.
Authentication required:
  • X-Auth-ID - Your Auth ID (e.g., {auth_id})
  • X-Auth-Token - Your account Auth Token
  • Content-Type: application/json
Releasing a phone number is permanent and cannot be reversed. Once released, the number returns to inventory and you lose access to it immediately. Any active calls or configurations using this number will be affected.

​
Path parameters

  • auth_id - Your account Auth ID.
  • e164 - The phone number to release, in E.164 format (e.g., 919876543210). This must be a number currently assigned to your account.
This path uses the capital-A /Account/ casing. The e164 segment is taken as-is in the path. No request body is required.

​
Request

cURL Request
curl -X DELETE "https://api.vobiz.ai/api/v1/Account/{auth_id}/numbers/919876543210" \
  -H "X-Auth-ID: {auth_id}" \
  -H "X-Auth-Token: {auth_token}"

​
Response

A successful release returns 204 No Content with an empty body. 
HTTP/1.1 204 No Content
Success: The phone number has been released from your account and returned to inventory.Changes Made:
  • auth_id set to NULL
  • trunk_group_id set to NULL
  • released_at timestamp set
  • Number becomes available in inventory for purchase
Error Response (403 Forbidden): If account does not own this number:
Error Response - 403 Forbidden
{
  "error": "forbidden",
  "message": "account does not own this number"
}

Authorizations

​
X-Auth-ID
string
header
required

Your Vobiz account Auth ID

​
X-Auth-Token
string
header
required

Your Vobiz account Auth Token

Path Parameters

​
auth_id
string
required

Your account Auth ID

Example:

"MA_XXXXXX"

​
e164
string
required

Phone number in E.164 format (without the +)

Example:

"919876543210"

Response

204

Number released