IP Access Control List
Update IP ACL
Modify a Vobiz IP ACL entry to update the whitelisted IPv4 address, toggle its enabled state, or edit the description - all with a single PUT request.
PUT
/
api
/
v1
/
Account
/
{auth_id}
/
ip-acl
/
{ip_acl_id}
Update an IP ACL
curl --request PUT \
--url https://api.vobiz.ai/api/v1/Account/{auth_id}/ip-acl/{ip_acl_id} \
--header 'Content-Type: application/json' \
--header 'X-Auth-ID: <api-key>' \
--header 'X-Auth-Token: <api-key>' \
--data '
{
"name": "<string>",
"ip_address": "<string>"
}
'import requests
url = "https://api.vobiz.ai/api/v1/Account/{auth_id}/ip-acl/{ip_acl_id}"
payload = {
"name": "<string>",
"ip_address": "<string>"
}
headers = {
"X-Auth-ID": "<api-key>",
"X-Auth-Token": "<api-key>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {
'X-Auth-ID': '<api-key>',
'X-Auth-Token': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({name: '<string>', ip_address: '<string>'})
};
fetch('https://api.vobiz.ai/api/v1/Account/{auth_id}/ip-acl/{ip_acl_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "aabbccdd-1234-5678-90ab-cdef12345678",
"account_id": "MA_XXXXXXXX",
"ip_address": "192.168.1.0/24",
"description": "Datacenter ACL",
"enabled": true,
"created_at": "2026-03-25T10:00:00Z",
"updated_at": "2026-03-25T11:30:00Z"
}PUT https://api.vobiz.ai/api/v1/Account/{auth_id}/ip-acl/{ip_acl_id}
Authentication required:
X-Auth-ID- Your account Auth IDX-Auth-Token- Your account Auth TokenContent-Type: application/json
Full update. Send both
name and ip_address on every update - this is a replace, not a partial patch. To preserve the label or address, resend its current value.Request Parameters
| Field | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Label for the entry. Surfaces as description on the returned object. |
ip_address | string | Yes | IPv4 address or CIDR range (e.g., 192.168.1.200 or 10.40.50.0/24). |
Disable without deleting. The update body accepts only
name and ip_address. To toggle an entry’s enabled state, use the Console (or delete and recreate the entry). If you only need to temporarily stop traffic, removing the entry and re-adding it later is the documented API path.Response
Returns the complete IP ACL object with updated values and a newupdated_at timestamp.
Response - 200 OK
{
"id": "aabbccdd-1234-5678-90ab-cdef12345678",
"account_id": "MA_XXXXXXXX",
"ip_address": "192.168.1.200",
"description": "Office static IP",
"enabled": true,
"created_at": "2026-05-12T05:11:51Z",
"updated_at": "2026-05-12T05:12:30Z"
}
Examples
cURL - Update the IP address
cURL Request
curl -X PUT 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" \
-H "Content-Type: application/json" \
-d '{
"name": "Office static IP",
"ip_address": "192.168.1.200"
}'
cURL - Rename the entry (resend the IP)
cURL Request
curl -X PUT 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" \
-H "Content-Type: application/json" \
-d '{
"name": "Main office - Building A",
"ip_address": "192.168.1.200"
}'
IP Address Changes: If you update the IP address, existing authenticated connections may be disconnected. Plan IP changes during maintenance windows.
Error Response (400 Bad Request): If the new IP address format is invalid:
Error Response - 400 Bad Request
{
"error": "Invalid IP address format",
"code": 400
}
Best Practice: When migrating to a new IP, add the new entry first with Create IP ACL, test connectivity from it, then delete the old entry to avoid service interruption.
Authorizations
Was this page helpful?
⌘I
Update an IP ACL
curl --request PUT \
--url https://api.vobiz.ai/api/v1/Account/{auth_id}/ip-acl/{ip_acl_id} \
--header 'Content-Type: application/json' \
--header 'X-Auth-ID: <api-key>' \
--header 'X-Auth-Token: <api-key>' \
--data '
{
"name": "<string>",
"ip_address": "<string>"
}
'import requests
url = "https://api.vobiz.ai/api/v1/Account/{auth_id}/ip-acl/{ip_acl_id}"
payload = {
"name": "<string>",
"ip_address": "<string>"
}
headers = {
"X-Auth-ID": "<api-key>",
"X-Auth-Token": "<api-key>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {
'X-Auth-ID': '<api-key>',
'X-Auth-Token': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({name: '<string>', ip_address: '<string>'})
};
fetch('https://api.vobiz.ai/api/v1/Account/{auth_id}/ip-acl/{ip_acl_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "aabbccdd-1234-5678-90ab-cdef12345678",
"account_id": "MA_XXXXXXXX",
"ip_address": "192.168.1.0/24",
"description": "Datacenter ACL",
"enabled": true,
"created_at": "2026-03-25T10:00:00Z",
"updated_at": "2026-03-25T11:30:00Z"
}