Skip to main content
DELETE
/
api
/
v1
/
sip-phone-numbers
/
{id}
Delete phone number
const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};

fetch('https://blackbox.dasha.ai/api/v1/sip-phone-numbers/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>"
}

​
Deletion Modes

Normal deletion (force=false):
  • Fails if phone number is linked to any agents
  • Returns 409 Conflict if agents are using this number
Force deletion (force=true):
  • Automatically unlinks phone number from all agents
  • Updates affected agents to remove the phone number reference
  • Completes deletion even if agents were using the number

​
Best Practice

Check affected agents before deletion using the /affected-agents endpoint to understand the impact.

Path Parameters

​
id
string<uuid>
required

Phone number identifier

Query Parameters

​
force
boolean
default:false

Force deletion by unlinking from agents

Response

Phone number deleted successfully