---
title: "Update an existing IP Pool."
slug: "update-an-existing-ip-pool-1"
updated: 2026-03-02T22:30:52Z
published: 2026-03-02T22:35:48Z
canonical: "support.appgate.com/update-an-existing-ip-pool-1"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.appgate.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update an existing IP Pool.

Put/ip-pools/{id}

Update an existing IP Pool.

SecurityHTTPType bearer

Path parametersidstring (uuid) Required

ID of the object.

Example12699e27-b584-464a-81ee-5b4784b6d425

Body parameters

IP Pool object.

<select class='api-response-data' aria-label='Media type'><option value='1747cd67-2db7-465a-a29e-299fb2e1e8cb'>application/json</option>
</select>object  idstring  (uuid)    

ID of the object.

Example4c07bc67-57ea-42dd-b702-c2d6c45419fc
namestring    Required

Name of the object.

Exampleobject
notesstring    

Notes for the object. Used for documentation purposes.

ExampleThis object has been created for test purposes.

tags Array of string   

Array of tags.

Example[
  "developer",
  "api-created"
]string    
ipVersion6boolean    

Whether the IP pool is for v4 or v6.

Defaultfalse
ranges
excludedRanges
leaseTimeDaysinteger    

Number of days Allocated IPs will be reserved for device&users before they are reclaimable by others.

Default30

Responses200

Updated IP Pool.

<select class='api-response-data' aria-label='Media type'><option value='c558e373-538d-47e1-86d6-d9640daa5e98'>application/json</option>
</select>object  idstring  (uuid)    

ID of the object.

Example4c07bc67-57ea-42dd-b702-c2d6c45419fc
namestring    

Name of the object.

Exampleobject
notesstring    

Notes for the object. Used for documentation purposes.

ExampleThis object has been created for test purposes.
createdstring  (date-time)    

Create date.

updatedstring  (date-time)    

Last update date.

tags Array of string   

Array of tags.

Example[
  "developer",
  "api-created"
]string    
ipVersion6boolean    

Whether the IP pool is for v4 or v6.

Defaultfalse
ranges
excludedRanges
leaseTimeDaysinteger    

Number of days Allocated IPs will be reserved for device&users before they are reclaimable by others.

Default30
totalinteger  (int64)    

The total size of the IP Pool.

Example254
currentlyUsedinteger  (int64)    

Number of IPs in the pool are currently in use by device&users.

Example16
reservedinteger  (int64)    

Number of IPs in the pool are not currently in use but reserved for device&users according to the "leaseTimeDays" setting.

Example32

400

JSON error. Check the JSON format.

<select class='api-response-data' aria-label='Media type'><option value='176d2276-7bc1-4497-a7d7-4808ec135016'>application/json</option>
</select>object  

Generic HTTP error.

idstring    

Machine readable error code.

messagestring    

Human readable error details.

401

Token error. Login again.

<select class='api-response-data' aria-label='Media type'><option value='58c4f98a-9cda-4370-91ee-12b0da88af08'>application/json</option>
</select>object  

Generic HTTP error.

idstring    

Machine readable error code.

messagestring    

Human readable error details.

403

Insufficient permissions to access this resource.

<select class='api-response-data' aria-label='Media type'><option value='acf4e380-45b8-4962-bed7-186f793e4879'>application/json</option>
</select>object  

Generic HTTP error.

idstring    

Machine readable error code.

messagestring    

Human readable error details.

404

The requested resource can not be found.

<select class='api-response-data' aria-label='Media type'><option value='1666126e-502b-42cb-9afe-19e60057689a'>application/json</option>
</select>object  

Generic HTTP error.

idstring    

Machine readable error code.

messagestring    

Human readable error details.

406

Invalid 'Accept' header.

<select class='api-response-data' aria-label='Media type'><option value='edb801bd-7c1e-43f4-935e-d0b2383e0197'>application/json</option>
</select>object  

Generic HTTP error.

idstring    

Machine readable error code.

messagestring    

Human readable error details.

422

Request validation error. Check "errors" array for details.

<select class='api-response-data' aria-label='Media type'><option value='dc2177d5-c981-40ff-aa3a-9981d551682f'>application/json</option>
</select>Expand Allobject  

Http 422 error for object validation.

idstring    

Machine readable error code.

messagestring    

Human readable error details.

errors Array of object   

List of fields with validation errors.

object  fieldstring    

Name of the field that failed validation.

Examplename
messagestring    

Failure reason.

Examplemay not be null

500

Unexpected server side error.

<select class='api-response-data' aria-label='Media type'><option value='59045b58-dbf9-4507-b676-d86340db201d'>application/json</option>
</select>object  

Generic HTTP error.

idstring    

Machine readable error code.

messagestring    

Human readable error details.