Ana içeriğe geç

Update IPs in Group

Endpoint

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

Authentication

Requires a Personal API Access Token.

Authorization: Bearer YOUR_TOKEN

Request

Headers

HeaderValueRequired
AuthorizationBearer {token}Yes
Content-Typeapplication/jsonYes

Path Parameters

ParameterTypeRequiredDescription
projectNamestringYesProject name
ipGroupNamestringYesIP 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"
]
}'

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
  • 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