Skip to main content
DELETE
/
api
/
v1
/
account
/
{auth_id}
/
numbers
/
{e164_number}
Unrent a number
curl --request DELETE \
  --url https://api.vobiz.ai/api/v1/account/{auth_id}/numbers/{e164_number} \
  --header 'X-Auth-ID: <api-key>' \
  --header 'X-Auth-Token: <api-key>'

Documentation Index

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

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

DELETE https://api.vobiz.ai/api/v1/account/{auth_id}/numbers/{e164_number}
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

  • e164_number - The phone number in E.164 format to release (e.g., +918071387149). This must be a number currently assigned to your account.
No request body is required for this endpoint.

​
Request

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

​
Response Example

Success Response (200 OK)
{
  "message": "number returned to inventory"
}
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_number
string
required

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

Example:

"919876543210"

Response

204

Number released