V3 Stream Violations

Gets violations as a result of policy enforcement on streams. Matched terms are decrypted by the Agent.

When a violation occurs during the creation of a stream, there won't be any stream ID (because the stream was not created).

Get violations as a result of policy enforcement on streams.

get

Retrieves DLP v3 signal related violations for a given time range

Query parameters
startTimeinteger · int64Required

Timestamp of the first required violation. This is a long integer value representing milliseconds since Jan 1 1970

endTimeinteger · int64Optional

Timestamp of the last required violation. This is a long integer value representing milliseconds since Jan 1 1970 If unspecified, it will default to current time of the request.

nextstringOptional

Offset of the next chunk of violations. Value is null for the first request.

limitintegerOptional

Max No. of violations to return. If no value is provided, 50 is the default. The maximum supported value is 500.

Header parameters
sessionTokenstringRequired

Session authentication token.

keyManagerTokenstringRequired

Key Manager authentication token.

Responses
200
OK
application/json
get
GET /agent/v3/dlp/violations/stream?startTime=1 HTTP/1.1
Host: youragentURL.symphony.com
sessionToken: text
keyManagerToken: text
Accept: */*

{
  "violations": [
    {
      "violation": {
        "enforcementEventID": "text",
        "entityID": "text",
        "createTime": 1,
        "lastModified": 1,
        "requesterId": 1,
        "details": [
          {}
        ],
        "action": "text",
        "outcome": {
          "type": "text"
        },
        "version": "text",
        "ignoreDLPwarning": true
      },
      "stream": {
        "name": "text",
        "creatorPrettyName": "text",
        "publicRoom": true,
        "crossPod": true,
        "allowExternal": true,
        "creatorId": "text",
        "roomDescription": "text",
        "streamId": "text",
        "state": "text",
        "type": "text",
        "lastDisabled": 1,
        "memberAddUserEnabled": true,
        "active": true,
        "discoverable": true,
        "readOnly": true,
        "copyDisabled": true,
        "externalOwned": true,
        "sendMessageDisabled": true,
        "moderated": true,
        "shareHistoryEnabled": true,
        "diagnostic": "text"
      }
    }
  ],
  "nextOffset": "text"
}

🚧 Required Permissions

Calling this endpoint requires the Expression Filter Policy Management role. See Bot Permissions for a list of roles and associated privileges.

Last updated

Was this helpful?