Skip to main content
DELETE
/
api
/
v1
/
account
/
{auth_id}
/
origination-uris
/
{uri_id}
Delete an origination URI
curl --request DELETE \
  --url https://api.vobiz.ai/api/v1/account/{auth_id}/origination-uris/{uri_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}/origination-uris/{uri_id}
Permanently deletes an origination URI from your trunk. Once deleted, the trunk will no longer route outbound calls to this destination. 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 an origination URI is permanent and cannot be reversed. Ensure you have at least one active URI remaining for outbound calls to continue functioning.Important: If you delete all origination URIs, your trunk will not be able to route any outbound calls. Always maintain at least one active URI for production trunks.
Alternative: Consider setting enabled: false to temporarily disable the URI without losing the configuration. This allows you to re-enable it later without needing to reconfigure the SIP destination, priority, and weight.

​
Response

Returns 204 No Content on successful deletion. No response body is returned.
Response - 204 No Content
No Content

​
Examples

​
cURL - Delete Origination URI

cURL Request
curl -X DELETE https://api.vobiz.ai/api/v1/account/{auth_id}/origination-uris/aabbccdd-1234-5678-90ab-cdef12345678 \
  -H "X-Auth-ID: YOUR_AUTH_ID" \
  -H "X-Auth-Token: YOUR_AUTH_TOKEN"
Error Response (404 Not Found): If the origination URI does not exist:
Error Response - 404 Not Found
{
  "error": "Origination URI not found",
  "code": 404
}
Before Deleting:
  • List all origination URIs to verify the correct one is being deleted
  • Ensure at least one other active URI exists for outbound call routing
  • Consider the impact on failover and load balancing configuration
  • Save URI configuration details if you might need to recreate it later
Safe Deletion Workflow:
  1. First, set enabled: false on the URI to disable it
  2. Monitor outbound calls to ensure remaining URIs handle traffic correctly
  3. Wait for a testing period (e.g., 24 hours) to confirm no issues
  4. If no problems occur, proceed with permanent deletion
  5. If issues arise, re-enable the URI before it’s deleted
Production Best Practices:
  • Never delete the last remaining active origination URI on a production trunk
  • Always maintain at least 2 URIs (one primary, one backup) for redundancy
  • Document the reason for deletion and the URI configuration in your change log
  • Plan deletions during maintenance windows to minimize potential impact

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"

​
uri_id
string
required

Response

Success

The response is of type string.