V2 Message Violations

Gets violations as a result of policy enforcement on messages. The message part of this violation is the same as documented in Create Message v4.

Get violations as a result of policy enforcement on messages.

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

Query parameters

Header parameters

Response

200204400401403500

OK

Body

application/json

violations*array of V1DLPViolationMessage (object)

A representation of list of violations due to messages sent by a user of Symphony

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/message', {
    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
      },
      "message": {
        "messageId": "text",
        "parentMessageId": "text",
        "message": "text",
        "data": "text",
        "attachments": [
          {
            "id": "text",
            "name": "text",
            "images": [
              {
                "id": "text",
                "dimension": "text"
              }
            ]
          }
        ],
        "user": {
          "firstName": "text",
          "lastName": "text",
          "displayName": "text",
          "email": "text",
          "username": "text"
        },
        "stream": {
          "streamId": "text",
          "streamType": "text",
          "roomName": "text",
          "members": [
            {
              "firstName": "text",
              "lastName": "text",
              "displayName": "text",
              "email": "text",
              "username": "text"
            }
          ],
          "external": false,
          "crossPod": false
        },
        "externalRecipients": false,
        "diagnostic": "text",
        "userAgent": "text",
        "originalFormat": "text",
        "disclaimer": "text",
        "sid": "fa691cd3-484a-4109-aeb2-57c05b78c95b",
        "replacing": "text",
        "replacedBy": "text",
        "initialMessageId": "text",
        "silent": 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.