Delete an Endpoint

Permanently delete an existing SIP endpoint from your account.

This API allows you to permanently delete an endpoint from your Vobiz account. Once deleted, the endpoint's SIP URI will no longer be accessible, and any devices or applications registered with this endpoint will be disconnected.

Authentication Required:

• Bearer Token: Include your access token in the Authorization header
• X-Auth-ID Header: Your account ID (e.g., {Auth_ID})

Warning - Permanent Deletion:

This action is permanent and cannot be undone. Deleting an endpoint will immediately unregister it from all devices and make the SIP URI permanently unavailable. Ensure that no active calls or registrations depend on this endpoint before deletion.

HTTP Request

DELETEhttps://api.vobiz.ai/api/v1/Account/{authID}/Endpoint/{endpointID}/

Base URL:

https://api.vobiz.ai/api/v1

Note: No request parameters are required for this endpoint.

Response

Success Response (204 No Content)

If successful, 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 will immediately unregister it from all devices and make the SIP URI permanently unavailable. This action cannot be reversed.

Create an Endpoint

Retrieve an Endpoint