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)
  • ipList must not be empty (empty list returns 400)

Response

Success Response (200 OK)

{
"status": "SUCCESS",
"deploymentResult": {
"success": true,
"responseTime": 1500,
"detailList": [
{
"envName": "production",
"success": true,
"detail": "Deployed successfully",
"responseTime": 450
}
]
}
}

Error Response (400 Bad Request)

{
"status": "FAILURE",
"resultMessage": "ipList value can not be empty!"
}

or

{
"status": "FAILURE",
"resultMessage": "IP Group (AllowedIPs) is not found!"
}

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