Skip to content

File download

Manage the rules that control file download telemetry collection across your organization.

Operations

Retrieve the file download telemetry configuration

Request

Returns your organization's current file download telemetry configuration, including every rule and its settings. Rules are returned in the order they're evaluated, with the highest-priority rule first.

Security
x-api-key
GET
/v1/telemetry/fileDownload/configuration
curl -i -X GET \
  https://api.pushsecurity.com/v1/telemetry/fileDownload/configuration \
  -H 'x-api-key: YOUR_API_KEY_HERE'

Responses

OK

Bodyapplication/json
rulesArray of objects(File Download Telemetry Rule)required

Complete list of File Download Telemetry rules.

globalsobject

Reserved for control-wide settings. Empty for this control.

Example:
{}
Response
{
  "globals": {},
  "rules": [
    {
      "id": "c478966c-f927-411c-b919-179832d3d50c",
      "name": "Collect download telemetry for Engineering",
      "enabled": true,
      "mode": "ON",
      "criteria": {
        "employeeIds": {
          "matches": [ … ]
        },
        "employeeGroups": {
          "matches": [ … ]
        },
        "profileScope": {
          "matches": [ … ]
        }
      }
    }
  ]
}