V2 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, note that there won't be any stream ID (because the stream was not created).

Get violations as a result of policy enforcement on streams.

GETyouragentURL.symphony.com/agent/v1/dlp/violations/stream

Query parameters

Header parameters

Response

200204400401403500

OK

Body

application/json

violations*array of V1DLPViolationStream (object)

nextOffsetstring

Offset for the next chunk of violations to be submitted in the next request. Value is null if there are no further violations.

Request

JavaScriptCurlPython

const response = await fetch('youragentURL.symphony.com/agent/v1/dlp/violations/stream', {
    method: 'GET',
    headers: {
      "sessionToken": "text",
      "keyManagerToken": "text"
    },
});
const data = await response.json();

Response

200400401403500

{
  "violations": [
    {
      "violation": {
        "enforcementEventID": "text",
        "entityID": "text",
        "matchedPolicies": [
          {
            "id": "text",
            "version": "text",
            "policyName": "text",
            "type": "text",
            "terms": "text",
            "diagnostic": "text"
          }
        ],
        "action": "text",
        "outcome": {
          "type": "text"
        },
        "contentType": {
          "type": "text"
        },
        "version": "text",
        "ignoreDLPwarning": false
      },
      "stream": {
        "name": "text",
        "creatorPrettyName": "text",
        "publicRoom": false,
        "crossPod": false,
        "allowExternal": false,
        "creatorId": "text",
        "roomDescription": "text",
        "streamId": "text",
        "state": "text",
        "type": "text",
        "memberAddUserEnabled": false,
        "active": false,
        "discoverable": false,
        "readOnly": false,
        "copyDisabled": false,
        "externalOwned": false,
        "sendMessageDisabled": false,
        "moderated": false,
        "shareHistoryEnabled": false,
        "diagnostic": "text"
      }
    }
  ],
  "nextOffset": "text"
}

🚧 Required Permissions

Calling this endpoint requires a ceservice account. For more information, see the Symphony Administration Guide.

See Bot Permissions for a list of roles and associated privileges.