Get distinct values of a list of filters

This endpoint returns the possible distinct values for each of the filter names provided in the "filters" parameter.

The scope of the filter values is restricted with the same type of filters we use to restrict the list of Audit Trail Events we retrieve in the /audits endpoint. Beware that a given filter may be included, rather in the list of filters, rather included in the filter restrictions.E.g: we can search the distinct "action" values, or we can search for the values of other filters for a given "action=sentMessage"

Get distinct values of a list of filters

get

This operation returns the possible distinct values for each of the filter names provided in the "filters" parameter. The scope of the filter values is restricted with the same type of filters we use to restrict the list of Audit Trail Events we retrieve in the /audits endpoint. Beware that a given filter may be included, rather in the list of filters, rather included in the filter restrictions. E.g: we can search the distinct "action" values, or we can search for the values of other filters for a given "action=sentMessage". This operation returns only audits for the categories the requester is entitled to.

Query parameters

filtersstringrequired

Names of the filters for which we want to retrieve their distinct values

Example: action,originatingUser,affectedUser,group,attribute

startDatestringoptional

start range date restriction. Date must be formatted the following way: yyyy-MM-dd'T'HH:mm:ss.SSS'Z'

endDatestringoptional

end range date restriction. Date must be formatted the following way: yyyy-MM-dd'T'HH:mm:ss.SSS'Z'

categoriesstringrequired

List of Audit Trail categories restriction

Example: login,malwarescan

affectedUserIdstringoptional

"Affected User Id" filter single value restriction

originatingUserIdstringoptional

"Originating User Id" filter single value restriction (a.k.a. "Performed by)"

actionIdstringoptional

"Action Id" filter single value restriction

attributestringoptional

"Attribute" filter single value restriction

groupIdstringoptional

"Group Id" filter single value restriction (used by Info barrier, Role Scope...)

authorizationRolestringoptional

"Authorization Role" filter single value restriction

streamIdstringoptional

"Stream Id" filter single value restriction (using either Base64 or Base64URL encoding)

policyIdstringoptional

"Policy Id" filter single value restriction

applicationIdstringoptional

"Application Id" filter single value restriction

tempAuthIdstringoptional

"Temporary Authorization Id" filter single value restriction

disclaimerIdstringoptional

"Disclaimer Id" filter single value restriction

Responses

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'youraudittrailURL.symphony.com/at2/v1/filters/values?filters=action%2CoriginatingUser%2CaffectedUser%2Cgroup%2Cattribute&categories=login%2Cmalwarescan'

200

400

401

404

200

[
  {
    "values": [
      "values",
      "values"
    ],
    "name": "name",
    "complexValues": [
      null,
      null
    ]
  }
]

Success