Deletes a data group

Open in ChatGPT Open in ChatGPT to ask questions about this page
Open in Claude Open in Claude to ask questions about this page
Copy as MarkdownCopy this page as markdown to use with AI assistants
View as Markdown Open this page as markdown in a new tab

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

EndpointDLP.DELETECopied!

Header

Authorization: d92d4xxxxxxxxxxxxx15f52

Request Parameters

- Request Headers

AcceptstringMandatory
application/jsonapplication/jsonCopied!

- Path Parameters

dataGroupIdstringMandatory

Unique identifier of the data group. Fetch from Get All Data Groups

Sample Request

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'
Show full

Response Parameters

- HTTP code 400

Response Body - application/json
JSON object
Hide Sub-Attributes
errorCodestring

Validation error code returned when the data group is still associated with one or more policies and therefore cannot be deleted

errorMessagestring

Reason the data group cannot be deleted (e.g., associated with policies)

- HTTP code 401

Response Body - application/json
JSON object
Hide Sub-Attributes
errorCodelong

Unauthorized error code returned when authentication credentials are missing, expired, or invalid (authentication=required)

errorMsgstring

Authentication failure reason

- HTTP code 500

Response Body - application/json
JSON object
Hide Sub-Attributes
errorCodestring

Internal error code returned when deleting a data group fails

errorMessagestring

Failure message describing why the data group could not be deleted

Possible Response Codes

200HTTP code
400HTTP code
401HTTP code
500HTTP code

Sample Response: HTTP 200

Copied!
200 OK
Show full

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

User unauthorized

Copied!
  {
    "errorMessage": "User does not have access to delete this data group",
    "errorCode": "UAC_UNAUTHORIZED"
  }
                
Show full

Sample Response: HTTP 500

Internal server error

Copied!
  {
    "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.