Vobiz Logo
Vobiz
|API Documentation
Console
← Back to Trunks

Delete a Trunk

Permanently remove a SIP trunk and all its associated resources.

This API permanently deletes a trunk and all its associated resources including credentials, IP ACL entries, and origination URIs. This action cannot be undone.

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 configuration while preventing new calls.

HTTP Request

DELETEhttps://api.vobiz.ai/api/v1/account/{account_id}/trunks/{trunk_id}

Authentication: Bearer token required. Include X-Auth-ID header.

Response

Returns HTTP 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 doesn't belong to your account
  • • 409 Conflict: Trunk has active calls (wait for calls to end first)

Examples

cURL

cURL Request
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"

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
Update a Trunk
Credentials Overview