How to Remove IP Addresses from a User's Whitelist

Removing an IP address or subnet from a user's whitelist allows authorized administrators to revoke access for specific public IPs. This action helps maintain tight security controls by ensuring only trusted sources can interact with the Vultr account. Access to this endpoint is restricted to root users or those with the manage_users permission. Only public IPs can be removed—private IP addresses are not supported, and valid subnet sizes must be respected. This operation enables precise control over access policies, supporting secure and flexible user management.

Follow this guide to remove IP addresses from a user's whitelist using the Vultr API.

1. Send a GET request to the Get Users endpoint to view all users and note the user id for the target user.

   console Copy

   $ curl "https://api.vultr.com/v2/users" \
       -X GET \
       -H "Authorization: Bearer ${VULTR_API_KEY}"
   

2. Send a DELETE request to the Remove IP from User Whitelist endpoint to remove IP addresses from a user's IP whitelist.

   console Copy

   $ curl "https://api.vultr.com/v2/users/{user-id}/ip-whitelist" \
   -X DELETE \
   -H "Authorization: Bearer ${VULTR_API_KEY}" \
   -H "Content-Type: application/json" \
   --data '{
       "subnet" : "8.8.8.0",
       "subnet_size" : 24
   }'
   

3. Send a GET request to the List User IP Whitelist endpoint to list confirm the removal of IP addresses.

   console Copy

   $ curl "https://api.vultr.com/v2/users/{user-id}/ip-whitelist" \
       -X GET \
       -H "Authorization: Bearer ${VULTR_API_KEY}"