Ana içeriğe atla

Endpoint

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

Authentication

Requires a Personal API Access Token.
Authorization: Bearer YOUR_TOKEN

Request

Headers

HeaderValueRequired
AuthorizationBearer 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