Ana içeriğe geç

Delete IPs from Group

Endpoint

DELETE /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

  • Only the specified IPs are removed
  • IPs not in the group are ignored (no error)
  • Empty list will result in no changes

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 DELETE \
"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

  • Selective Removal:

    • Only the specified IPs are removed
    • Other IPs remain in the group
  • Non-existent IPs:

    • IPs not in the group are ignored (no error)
  • IP List Required:

    • ipList must not be empty
    • At least one IP must be specified