Update IPs in Group

Overview

Replaces all IP addresses in an IP Group with the provided list. This completely replaces the existing IP list.

Endpoint

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

Authentication

Requires a Personal API Access Token.

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
  • If you want to add IPs without removing existing ones, use Add IPs endpoint
  • Empty list will remove all IPs from the group

Response

Success Response (200 OK)

{
  "success": true
}

Error Response (400 Bad Request)

{
  "error": "bad_request",
  "error_description": "ipList value can not be empty!"
}

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"
    ]
  }'

Notes and Warnings

  • Complete Replacement:
    • Replaces ALL existing IPs with the provided list
    • Existing IPs not in the new list are removed
  • Empty List:
    • Empty list will remove all IPs from the group
  • Use Add IPs for Addition:
    • If you want to add IPs without removing existing ones, use Add IPs endpoint