Delete a Trunk

DELETE

api

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>'

import requests

url = "https://api.vobiz.ai/api/v1/Account/{auth_id}/trunks/{trunk_id}"

headers = {
    "X-Auth-ID": "<api-key>",
    "X-Auth-Token": "<api-key>"
}

response = requests.delete(url, headers=headers)

print(response.text)

const options = {
  method: 'DELETE',
  headers: {'X-Auth-ID': '<api-key>', 'X-Auth-Token': '<api-key>'}
};

fetch('https://api.vobiz.ai/api/v1/Account/{auth_id}/trunks/{trunk_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

"<string>"

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.

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>'

import requests

url = "https://api.vobiz.ai/api/v1/Account/{auth_id}/trunks/{trunk_id}"

headers = {
    "X-Auth-ID": "<api-key>",
    "X-Auth-Token": "<api-key>"
}

response = requests.delete(url, headers=headers)

print(response.text)

const options = {
  method: 'DELETE',
  headers: {'X-Auth-ID': '<api-key>', 'X-Auth-Token': '<api-key>'}
};

fetch('https://api.vobiz.ai/api/v1/Account/{auth_id}/trunks/{trunk_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

"<string>"

​Request

​Response

Authorizations

Path Parameters

Response

Request

Response