Delete a phone number

DELETE/phone-numbers/{id}

Remove a phone number from your organization: no call can be placed from it or received on it through Revox anymore. A number bought through Revox is also released, so it stops being billed and cannot be recovered. Returns 400 when the release fails; try again later.

Request

curl -X DELETE "https://www.getrevox.com/api/phone-numbers/6f9a3c1e-2b7d-4e58-9a10-3d2c4b5e6f70" \
  -H "Authorization: Bearer $REVOX_API_KEY"

const res = await fetch("https://www.getrevox.com/api/phone-numbers/6f9a3c1e-2b7d-4e58-9a10-3d2c4b5e6f70", {
  method: "DELETE",
  headers: {
    Authorization: `Bearer ${process.env.REVOX_API_KEY}`,
  },
});
const data = await res.json();
console.log(data);

import os

import requests

response = requests.delete(
    "https://www.getrevox.com/api/phone-numbers/6f9a3c1e-2b7d-4e58-9a10-3d2c4b5e6f70",
    headers={"Authorization": f"Bearer {os.environ['REVOX_API_KEY']}"},
    timeout=30,
)
response.raise_for_status()
print(response.json())

Try itSend this request live

Response

Success

{ "success": true }

{
  "message": "Request validation failed",
  "bodyErrors": {
    "issues": [
      {
        "path": ["phone_number"],
        "message": "Invalid input: expected string, received undefined",
        "code": "invalid_type"
      }
    ]
  }
}

{ "error": "Not found" }

Path parameters

idstringrequired
ID of the phone number record, as returned by GET /phone-numbers (not the phone number itself).

Request body

No body: send the request without one.

Response

200

successboolean
True when the number was deleted.

Errors

400Invalid request: a field or parameter failed validation{ "message"?: string, "error"?: string, "bodyErrors"?: {…} }
404Not found in your organization{ "error": string }

Error bodies carry an error (or message) string; a 400 adds bodyErrors.issues. See Errors.