Skip to main content
DELETE
/
api
/
v1
/
account
/
{auth_id}
/
trunks
/
{trunk_id}
Delete a trunk
curl --request DELETE \
  --url https://api.vobiz.ai/api/v1/account/{auth_id}/trunks/{trunk_id} \
  --header 'X-Auth-ID: <api-key>' \
  --header 'X-Auth-Token: <api-key>'
"<string>"

Documentation Index

Fetch the complete documentation index at: https://docs.vobiz.ai/llms.txt

Use this file to discover all available pages before exploring further.

DELETE https://api.vobiz.ai/api/v1/account/{auth_id}/trunks/{trunk_id}
Permanently deletes a trunk and all its associated resources, including credentials, IP ACL entries, and origination URIs. This action cannot be undone.
Authentication required:
  • X-Auth-ID - Your account Auth ID
  • X-Auth-Token - Your account Auth Token
  • Content-Type: application/json
Warning: Deleting a trunk will:
  • Permanently delete all credentials associated with this trunk
  • Remove all IP ACL entries
  • Delete all origination URIs
  • Immediately stop all active calls on this trunk
  • Make the trunk’s SIP domain unavailable for inbound calls
Alternative: Consider disabling the trunk instead (set enabled: false) to preserve its configuration while preventing new calls.

​
Request

cURL
curl -X DELETE https://api.vobiz.ai/api/v1/account/{auth_id}/trunks/bfab10fb-cb97-488b-9c63-989c32980b0f \
  -H "X-Auth-ID: YOUR_AUTH_ID" \
  -H "X-Auth-Token: YOUR_AUTH_TOKEN"

​
Response

Returns 204 No Content on successful deletion. No response body is returned.
Response - 204 No Content
No Content
Error Responses:
  • 404 Not Found: Trunk does not exist or does not belong to your account
  • 409 Conflict: Trunk has active calls (wait for calls to end first)
Before Deleting:
  • Verify no active calls are using this trunk
  • Document any credentials or routing configurations
  • Check if phone numbers are associated with this trunk
  • Consider exporting trunk configuration for backup
  • Notify users who may be affected by the deletion

Authorizations

​
X-Auth-ID
string
header
required

Your Vobiz account Auth ID

​
X-Auth-Token
string
header
required

Your Vobiz account Auth Token

Path Parameters

​
auth_id
string
required

Your account Auth ID

Example:

"MA_XXXXXX"

​
trunk_id
string
required

Response

Success

The response is of type string.