Deletes a data group Deletes an existing data group by its unique identifier. The data group must not be the sole data group associated with any policy.
Request URL https://{server-hostname}:8383/endpointdlp/api/data-classification/data-group/data-group-details/{dataGroupId}
Scope
Header Authorization: d92d4xxxxxxxxxxxxx15f52
Request Parameters - Request Headers - Path Parameters dataGroupId string Mandatory
Curl
Java
Python
Deluge
PowerShell
Copied!
curl --request DELETE \
--url https://appdomain/endpointdlp/api/data-classification/data-group/data-group-details/{dataGroupId} \
--header 'Accept: application/json' \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52'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/endpointdlp/api/data-classification/data-group/data-group-details/{dataGroupId}"))
.header("Accept", "application/json")
.header("Authorization", " d92d4xxxxxxxxxxxxx15f52")
.method("DELETE", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
import http.client
conn = http.client.HTTPSConnection("appdomain")
headers = {
'Accept': "application/json",
'Authorization': " d92d4xxxxxxxxxxxxx15f52"
}
conn.request("DELETE", "/endpointdlp/api/data-classification/data-group/data-group-details/{dataGroupId}", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
headersMap = Map();
headersMap.put("Accept", "application/json");
response = invokeUrl
[
url: "https://appDomain/endpointdlp/api/data-classification/data-group/data-group-details/{dataGroupId}"
type: DELETE
headers: headersMap
connection: connection_name
]
info response;
$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", " d92d4xxxxxxxxxxxxx15f52")
$response = Invoke-WebRequest -Uri 'https://appdomain/endpointdlp/api/data-classification/data-group/data-group-details/{dataGroupId}' -Method DELETE -Headers $headers▼ Show full
Response Parameters - HTTP code 400 Response Body - application/json JSON object
Hide Sub-Attributes errorCode string
Validation error code returned when the data group is still associated with one or more policies and therefore cannot be deleted
errorMessage string
Reason the data group cannot be deleted (e.g., associated with policies)
- HTTP code 401 Response Body - application/json JSON object
Hide Sub-Attributes errorCode long
Unauthorized error code returned when authentication credentials are missing, expired, or invalid (authentication=required)
errorMsg string
Authentication failure reason
- HTTP code 500 Response Body - application/json JSON object
Hide Sub-Attributes errorCode string
Internal error code returned when deleting a data group fails
errorMessage string
Failure message describing why the data group could not be deleted
Possible Response Codes Sample Response: HTTP 200 Sample Response: HTTP 400 Data group is associated with policies
Copied!
{
"errorMessage": "Cannot delete data group. It is associated with policies",
"errorCode": "INTERNAL_ERROR"
}
▼ Show full
Sample Response: HTTP 401 {
"errorMessage": "User does not have access to delete this data group",
"errorCode": "UAC_UNAUTHORIZED"
}
▼ Show full
Sample Response: HTTP 500 {
"errorMessage": "Exception occurred while deleting DataGroup",
"errorCode": "INTERNAL_ERROR"
}
▼ 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.