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
Your Vobiz account Auth ID
Your Vobiz account Auth Token
Path Parameters
Your account Auth ID
Example:
"MA_XXXXXX"
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"
}