Skip to main content
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>'
"<string>"
DELETE https://api.vobiz.ai/api/v1/Account/{auth_id}/Endpoint/{endpoint_id}/
Permanently deletes an endpoint from your Vobiz account. Once deleted, the endpoint’s SIP URI is no longer accessible, and any devices or applications registered with this endpoint will be disconnected.
Authentication required:
  • X-Auth-ID - Your account Auth ID (e.g., {auth_id})
  • X-Auth-Token - Your account Auth Token
  • Content-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 code 204 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.

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"

​
endpoint_id
string
required
Example:

"87654321"

Response

Success

The response is of type string.