Skip to main content
DELETE
/
api
/
v1
/
Account
/
{auth_id}
/
ip-acl
/
{ip_acl_id}
Delete an IP ACL
curl --request DELETE \
  --url https://api.vobiz.ai/api/v1/Account/{auth_id}/ip-acl/{ip_acl_id} \
  --header 'X-Auth-ID: <api-key>' \
  --header 'X-Auth-Token: <api-key>'
"<string>"
DELETE https://api.vobiz.ai/api/v1/Account/{auth_id}/ip-acl/{ip_acl_id}
Permanently deletes an IP ACL entry from a trunk. Once deleted, the IP address is no longer whitelisted for authentication, and calls from that IP will be rejected unless other authentication methods (such as credentials) are configured.
Authentication required:
  • X-Auth-ID - Your account Auth ID
  • X-Auth-Token - Your account Auth Token
  • Content-Type: application/json
Warning: This action is permanent and cannot be undone. Active connections from this IP address may be immediately disconnected.Alternative: Consider disabling the IP ACL entry instead of deleting it by setting enabled: false. This preserves the configuration for future use.

​
Response

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

​
Examples

​
cURL - Delete IP ACL

cURL Request
curl -X DELETE https://api.vobiz.ai/api/v1/Account/{auth_id}/ip-acl/c1d2e3f4-a5b6-7890-cdef-1234567890ab \
  -H "X-Auth-ID: YOUR_AUTH_ID" \
  -H "X-Auth-Token: YOUR_AUTH_TOKEN"
Error Response (404 Not Found): If the IP ACL ID does not exist or was already deleted:
Error Response - 404 Not Found
{
  "error": "IP ACL not found",
  "code": 404
}
Before Deleting:
  • Verify you have the correct IP ACL ID
  • Ensure you have alternative authentication methods configured (if needed)
  • Check if there are active connections from this IP
  • Consider temporarily disabling instead of deleting
After Deletion:
  • The IP address is immediately removed from the whitelist
  • New authentication attempts from this IP will fail
  • Active calls may be terminated depending on trunk configuration
  • The IP ACL entry cannot be recovered - create a new one if needed
Alternative - Disable Instead: To temporarily block an IP without losing the configuration:
Alternative - Disable IP ACL
curl -X PUT https://api.vobiz.ai/api/v1/Account/{auth_id}/ip-acl/IP_ACL_ID \
  -H "X-Auth-ID: YOUR_AUTH_ID" \
  -H "X-Auth-Token: YOUR_AUTH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"enabled": false}'

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"

​
ip_acl_id
string
required

Response

Success

The response is of type string.