Delete multiple IP scopes in a single request Deletes multiple IP scopes identified by their boundary IDs.
Request URL https://{server-hostname}:8383/dcapi/som/ip-scopes
Scope
Header Authorization: d92d4xxxxxxxxxxxxx15f52
Request Parameters - Request Headers Content-Type string Mandatory
- Request Body application/json JSON Object
Hide Sub-Attributes ipScopeIDs array Mandatory
Array of IP scope boundary IDs to delete (maximum 1000 per request), get ip scope's unique identified(boundaryID) from IP Scopes api
Curl
Java
Python
Deluge
PowerShell
Copied!
curl --request DELETE \
--url https://appdomain/dcapi/som/ip-scopes \
--header 'Accept: application/ipScopeDeletedStatus.v1+json' \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/ipScopeDetail.v1+json' \
--data '{"ipScopeIDs":["1","2","3"]}'import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.io.IOException;
import java.net.http.HttpTimeoutException;
public class Main {
public static void main(String[] args) {
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://appdomain/dcapi/som/ip-scopes"))
.header("Content-Type", "application/ipScopeDetail.v1+json")
.header("Accept", "application/ipScopeDeletedStatus.v1+json")
.header("Authorization", " d92d4xxxxxxxxxxxxx15f52")
.method("DELETE", HttpRequest.BodyPublishers.ofString("{\"ipScopeIDs\":[\"1\",\"2\",\"3\"]}"))
.build();
HttpResponse response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
import http.client
conn = http.client.HTTPSConnection("appdomain")
payload = "{\"ipScopeIDs\":[\"1\",\"2\",\"3\"]}"
headers = {
'Content-Type': "application/ipScopeDetail.v1+json",
'Accept': "application/ipScopeDeletedStatus.v1+json",
'Authorization': " d92d4xxxxxxxxxxxxx15f52"
}
conn.request("DELETE", "/dcapi/som/ip-scopes", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
headersMap = Map();
headersMap.put("Content-Type", "application/ipScopeDetail.v1+json");
headersMap.put("Accept", "application/ipScopeDeletedStatus.v1+json");
data=Map();
data_ipScopeIDs=List();
data.put("ipScopeIDs",data_ipScopeIDs);
response = invokeUrl
[
url: "https://appDomain/dcapi/som/ip-scopes"
type: DELETE
headers: headersMap
body: data
connection: connection_name
]
info response;
$headers=@{}
$headers.Add("Content-Type", "application/ipScopeDetail.v1+json")
$headers.Add("Accept", "application/ipScopeDeletedStatus.v1+json")
$headers.Add("Authorization", " d92d4xxxxxxxxxxxxx15f52")
$response = Invoke-WebRequest -Uri 'https://appdomain/dcapi/som/ip-scopes' -Method DELETE -Headers $headers -ContentType 'application/ipScopeDetail.v1+json' -Body '{"ipScopeIDs":["1","2","3"]}'Sample Request Body Delete multiple IP scopes
Copied!
{
"ipScopeIDs": [
"1",
"2",
"3"
]
}
▼ Show full
Response Parameters - HTTP code 200 Response Body - application/json JSON Object
Hide Sub-Attributes deletedIPScopeIDs array
Array of IP scope boundary IDs that were successfully deleted
notDeletedIPScopeIDs array
Array of IP scope boundary IDs that could not be deleted (e.g., invalid ID or already deleted)
message string
Descriptive message providing details about the bulk delete outcome
status boolean
Indicates whether the bulk delete operation completed successfully
- HTTP code 412 Response Body - application/json JSON Object
Hide Sub-Attributes errorCode string
Precondition failed error code identifying the business logic violation
message string
Error message describing the precondition failed while processing request
Possible Response Codes Sample Response: HTTP 200 All IP scopes deleted successfully
Copied!
{
"deletedIPScopeIDs": [
"1",
"2",
"3"
],
"message": "Selected IP scope(s) were successfully deleted.",
"notDeletedIPScopeIDs": [],
"status": true
}
▼ Show full
Some IP scopes could not be deleted
Copied!
{
"deletedIPScopeIDs": [
"1",
"2"
],
"message": "Selected IP scope(s) were successfully deleted.",
"notDeletedIPScopeIDs": [
"123"
],
"status": true
}
▼ Show full
Sample Response: HTTP 412 IP scope IDs list is empty
Copied!
{
"errorCode": "30022",
"message": "Required IP scope parameters are missing",
"statusCode": 412
}
▼ Show full
Duration: 1 minute | Threshold: 30 | Lock period: 5 minutes
Duration - Time window for the threshold. Threshold - Number of API calls allowed within the specified duration. Lock Period - Wait time before consecutive API requests.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.