REST API call to retrieve the list of reviewer groups

You can retrieve (GET) the list of reviewer groups for the specified incident nature.

https://<epo_server_name:port>/rest/dlp/incidents/revgroups/list?incidentNature={n}

Where

epo_server_name:port is the server IP address and port number.
incidentNature={n} n can be 1, 2, or 3 for incidents of different data vectors (incident nature). Based on the value of n specified, reviewer groups set for different data vectors are retrieved.

Parameter name	Description	Required	Values
Authorization	User credentials for ePO - On-prem.	Required
incidentNature={n}	Incidents generated for data-in-use/motion and data-at-rest can have the same incident IDs. Specify n to differentiate the incident nature. Based on the data vectors, {n} can be: 1 = Incidents generated for data-in-use/motion 2 = Reserved for data-at-rest - Endpoint Discovery incidents and can be used when support for Endpoint Discovery custom attributes is added into the product 3 = Incidents generated for data-at-rest - Network	Required	Number

Using these sample API calls, you can retrieve the list of reviewer groups that are set for incidents generated for data-in-use/motion.

Sample GET request URL

https://172.27.108.53:8443/rest/dlp/incidents/revgroups/list?incidentNature=1

Sample cURL command

curl -k -v -X GET 'https://ePO-url:ePO-port/rest/dlp/incidents/revgroups/list?incidentNature=1' -u '<user>:<password>'

The response to this API call returns the list of assigned reviewer groups for the specified incident nature.

Element	Description	Data type
revgroups	List of reviewer groups for the specified incident nature. The default reviewer groups available in User Management → Permission Sets are: Global Reviewer Group Admin Group Reviewer Executive Reviewer You can create more reviewer groups as needed and assign users.	string

Element

Description

Data type

revgroups

List of reviewer groups for the specified incident nature. The default reviewer groups available in User Management → Permission Sets are:

You can create more reviewer groups as needed and assign users.

string

{
    "1": "Global Reviewer",
    "2": "Group Admin",
    "3": "Group Reviewer",
    "4": "Executive Reviewer"
}

List of HTTP status codes returned for the query.

Code	Description
200 OK	The response returns the list of reviewer groups.
400 Bad Request	incidentNature is missing or has a non-numeric value.
404 Not Found	Incorrect ePO - On-prem URL.
500 Internal Server Error	An error on the server side that failed the request. See the ePO - On-prem `orion.log` file for more details about the error.