Vobiz Logo
Vobiz
|API Documentation
Console
← Back to IP ACL

Delete IP ACL

Permanently remove an IP address from the trunk whitelist.

This API permanently deletes an IP ACL entry from a trunk. Once deleted, the IP address will no longer be whitelisted for authentication, and calls from this IP will be rejected unless other authentication methods (like credentials) are configured and valid.

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 settingenabled: false. This preserves the configuration for future use.

HTTP Request

DELETEhttps://api.vobiz.ai/api/v1/account/{account_id}/ip-acl/{ip_acl_id}

Authentication Required:

  • • X-Auth-ID: Your account ID (e.g., {Auth_ID})
  • • X-Auth-Token: Your account Auth Token
  • • Content-Type: application/json

Response

Returns HTTP 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 doesn't 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}'
Update IP ACL
Origination URIs