Delete IPs from Group

Overview

Removes specific IP addresses or CIDR ranges from an IP Group. Only the specified IPs are removed; other IPs remain in the group.

Endpoint

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

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

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