Skip to main content
DELETE
/
api
/
call
/
delete-phone
/
{phoneId}
curl --location --request DELETE '{{baseUrl}}/api/call/delete-phone/64e5f12345abcdef87654321' \
  --header 'Authorization: Bearer {{authToken}}'

{
  "success": true,
  "deletedId": "64e5f12345abcdef87654321"
}

​
Overview

Delete phone numbers that you no longer pay for or that have been reassigned. The number is removed from the workspace and no longer appears in batch or agent pickers.

​
Prerequisites

  • Bearer token for an admin user.
  • The phoneId of the record you want to remove.
  • Confirm that no active batches rely on the number.

​
Request

​
phoneId
string
required
Identifier of the phone record to delete.
​
Authorization
string
required
Bearer token for the workspace admin.
curl --location --request DELETE '{{baseUrl}}/api/call/delete-phone/64e5f12345abcdef87654321' \
  --header 'Authorization: Bearer {{authToken}}'

​
Response

{
  "success": true,
  "deletedId": "64e5f12345abcdef87654321"
}
​
deletedId
string
required
Confirms which phone record was removed.

​
Error Handling

  • 400 Bad Request – phoneId missing or invalid.
  • 404 Not Found – Phone already deleted or does not belong to the workspace.
  • 500 Internal Server Error – Deletion failed; retry or contact support with the phoneId.
Deleting a number clears it from existing batches. Update those batches first to avoid dialer failures.

Authorizations

​
Authorization
string
header
required

Bearer token authentication for workspace access

Path Parameters

​
phoneId
string
required

Response

Phone deleted successfully