Skip to main content
DELETE
/
api
/
v1
/
sip-credentials
/
{id}
Delete SIP credential
const options = {method: 'DELETE'};

fetch('https://blackbox.dasha.ai/api/v1/sip-credentials/{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 credential has associated phone numbers
  • Returns 409 Conflict if phone numbers are using this credential
Force deletion (force=true):
  • Automatically deletes all associated phone numbers
  • Updates affected agents to remove phone number references
  • Completes deletion even if phone numbers were using the credential
Force deletion will permanently delete all phone numbers associated with this credential, which may affect agents configured to use those numbers for inbound or outbound calls.
Credentials managed by a VoIP provider (such as Twilio) are read-only and cannot be deleted directly. To remove provider-managed credentials, delete the provider integration instead.

​
Best Practice

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

Path Parameters

​
id
string<uuid>
required

Credential identifier

Query Parameters

​
force
boolean
default:false

Force deletion by removing associated phone numbers

Response

SIP credential deleted successfully