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

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.

get

/v1/filters/values

Query parameters

filtersstringrequired

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

Example: action,originatingUser,affectedUser,group,attribute

startDatestring

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

endDatestring

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

affectedUserIdstring

"Affected User Id" filter single value restriction

originatingUserIdstring

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

actionIdstring

"Action Id" filter single value restriction

attributestring

"Attribute" filter single value restriction

groupIdstring

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

authorizationRolestring

"Authorization Role" filter single value restriction

streamIdstring

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

policyIdstring

"Policy Id" filter single value restriction

applicationIdstring

"Application Id" filter single value restriction

tempAuthIdstring

"Temporary Authorization Id" filter single value restriction

disclaimerIdstring

"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

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

Success