Endpoints
Delete an Endpoint
Permanently remove a SIP endpoint from your Vobiz account, immediately unregistering all devices and making the SIP URI permanently unavailable - irreversible.
DELETE
/
api
/
v1
/
Account
/
{auth_id}
/
Endpoint
/
{endpoint_id}
/
Delete an Endpoint
curl --request DELETE \
--url https://api.vobiz.ai/api/v1/Account/{auth_id}/Endpoint/{endpoint_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}/Endpoint/{endpoint_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}/Endpoint/{endpoint_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}/Endpoint/{endpoint_id}/
Authentication required:
X-Auth-ID- Your account Auth ID (e.g.,{auth_id})X-Auth-Token- Your account Auth TokenContent-Type: application/json
Permanent Deletion: This action is permanent and cannot be undone. Deleting an endpoint immediately unregisters it from all devices and makes the SIP URI permanently unavailable. Ensure no active calls or registrations depend on this endpoint before proceeding.
No request parameters are required for this endpoint.
Response
Success Response (204 No Content)
On success, returns HTTP status code204 No Content with an empty response body.
Response - 204 No Content
HTTP/1.1 204 No Content
Error Response (404 Not Found)
If the endpoint does not exist or has already been deleted.Response - 404 Not Found
HTTP/1.1 404 Not Found
Examples
cURL
cURL Request
curl -X DELETE https://api.vobiz.ai/api/v1/Account/{auth_id}/Endpoint/87654321/ \
-H "X-Auth-ID: YOUR_AUTH_ID" \
-H "X-Auth-Token: YOUR_AUTH_TOKEN"
Before Deletion:
- Verify the endpoint is no longer needed
- Check for any active registrations on SIP clients
- Ensure no applications are routing calls to this endpoint
- Consider updating endpoint instead if you need to change credentials
Impact: Deleting an endpoint immediately unregisters it from all devices and makes the SIP URI permanently unavailable. This action cannot be reversed.
Was this page helpful?
⌘I
Delete an Endpoint
curl --request DELETE \
--url https://api.vobiz.ai/api/v1/Account/{auth_id}/Endpoint/{endpoint_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}/Endpoint/{endpoint_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}/Endpoint/{endpoint_id}/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));"<string>"