Delete Origination URI

DELETE

api

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

import requests

url = "https://api.vobiz.ai/api/v1/Account/{auth_id}/origination-uris/{uri_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}/origination-uris/{uri_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}/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:

First, set enabled: false on the URI to disable it
Monitor outbound calls to ensure remaining URIs handle traffic correctly
Wait for a testing period (e.g., 24 hours) to confirm no issues
If no problems occur, proceed with permanent deletion
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.

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

import requests

url = "https://api.vobiz.ai/api/v1/Account/{auth_id}/origination-uris/{uri_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}/origination-uris/{uri_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

"<string>"

​Response

​Examples

​cURL - Delete Origination URI

Authorizations

Path Parameters

Response

Response

Examples

cURL - Delete Origination URI