DELETE
/
api
/
v1
/
phone-numbers
/
{phone_number}
/
release
curl -X DELETE "https://api.ravan.ai/api/v1/phone-numbers/+13612738809/release/" \
  -H "X-Api-Key: YOUR_API_KEY"

{
  "success": true,
  "message": "Phone number released successfully",
  "data": {
    "phone_number": "+13612738809",
    "status": "released",
    "released_at": "2026-03-20T16:00:00Z"
  }
}
This action cannot be undone. Once released, the phone number becomes available to other customers and you may not be able to reclaim it.

​
Authorizations

​
X-Api-Key
string
required
Your Agni API key. Find it in your support@ravan.ai under Settings → API Keys.

​
Path Parameters

​
phone_number
string
required
The phone number to release in E.164 format (e.g. +13612738809).

​
Response

​
success
boolean
Whether the request succeeded.
​
message
string
Human-readable status message.
​
data
object
Release confirmation.
curl -X DELETE "https://api.ravan.ai/api/v1/phone-numbers/+13612738809/release/" \
  -H "X-Api-Key: YOUR_API_KEY"

{
  "success": true,
  "message": "Phone number released successfully",
  "data": {
    "phone_number": "+13612738809",
    "status": "released",
    "released_at": "2026-03-20T16:00:00Z"
  }
}

Authorizations

​
X-Api-Key
string
header
required

Path Parameters

​
phone_number
string
required

The phone number to release (E.164 format, e.g. +12025551234)

Response

Successful response

​
success
boolean
​
message
string
​
data
object