Update IPs in Group

Endpoint

PUT /apiops/projects/{projectName}/ipGroups/{ipGroupName}/ips/

Authentication

Requires a Personal API Access Token.

Header

Authorization: Bearer YOUR_TOKEN

Request

Headers

Header	Value	Required
Authorization	Bearer {token}	Yes
Content-Type	application/json	Yes

Path Parameters

Parameter	Type	Required	Description
projectName	string	Yes	Project name
ipGroupName	string	Yes	IP Group name

Request Body

Same structure as Add IPs. See Add IPs to Group for field descriptions.

Important Notes

• This endpoint replaces ALL existing IPs with the provided list
• ipList must not be empty (validation error if empty)
• If you want to add IPs without removing existing ones, use Add IPs to Group

Response

Success Response (200 OK)

{
  "status": "SUCCESS",
  "deploymentResult": {
    "success": true,
    "responseTime": 1500,
    "detailList": [
      {
        "envName": "production",
        "success": true,
        "detail": "Deployed successfully",
        "responseTime": 450
      }
    ]
  }
}

Error Response (400 Bad Request)

{
  "status": "FAILURE",
  "resultMessage": "ipList value can not be empty!"
}

or

{
  "status": "FAILURE",
  "resultMessage": "IP Group (AllowedIPs) is not found!"
}

cURL Example

curl -X PUT \
  "https://demo.apinizer.com/apiops/projects/MyProject/ipGroups/AllowedIPs/ips/" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "ipList": [
      "192.168.1.100",
      "10.0.0.0/8"
    ]
  }'

Permissions

• User must have GLOBAL_SETTINGS + MANAGE permission in the project

Notes and Warnings

• Complete Replacement:

  • Replaces ALL existing IPs with the provided list
  • Existing IPs not in the new list are removed

• Non-empty ipList Required:

  • An empty ipList returns 400 (ipList value can not be empty!)
  • To remove all IPs, use Update IP Group with an omitted or empty ipList in the metadata body

Related Documentation

• Add IPs to Group - Add IPs without removing existing ones
• Delete IPs from Group - Remove specific IPs from group