chatMessagePolicyViolation resource type

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Represents a policy violation on a chat message. Policy violations are typically set by a data loss prevention (DLP) application. DLP applications monitor chats for messages that contain data that users aren't supposed to send.

Properties

Property Type Description
dlpAction chatMessagePolicyViolationDlpActionType The action taken by the DLP provider on the message with sensitive content. Supported values are:
  • None
  • NotifySender -- Inform the sender of the violation but allow readers to read the message.
  • BlockAccess -- Block readers from reading the message.
  • BlockAccessExternal -- Block users outside the organization from reading the message, while allowing users within the organization to read the message.
  • justificationText string Justification text provided by the sender of the message when overriding a policy violation.
    policyTip chatMessagePolicyViolationPolicyTip Information to display to the message sender about why the message was flagged as a violation.
    userAction chatMessagePolicyViolationUserActionType Indicates the action taken by the user on a message blocked by the DLP provider. Supported values are:
  • None
  • Override
  • ReportFalsePositive
  • When the DLP provider is updating the message for blocking sensitive content, userAction isn't required.
    verdictDetails chatMessagePolicyViolationVerdictDetailsType Indicates what actions the sender may take in response to the policy violation. Supported values are:
  • None
  • AllowFalsePositiveOverride -- Allows the sender to declare the policyViolation to be an error in the DLP app and its rules, and allow readers to see the message again if it was hidden by dlpAction.
  • AllowOverrideWithoutJustification -- Allows the sender to override the DLP violation and allow readers to see the message again if the dlpAction hides it, without needing to provide an explanation for doing so.
  • AllowOverrideWithJustification -- Allows the sender to override the DLP violation and allow readers to see the message again if the dlpAction hides it, after providing an explanation for doing so.
  • AllowOverrideWithoutJustification and AllowOverrideWithJustification are mutually exclusive.

    JSON representation

    The following JSON representation shows the resource type.

    {
      "dlpAction": "string",
      "justificationText": "string",
      "policyTip": {"@odata.type": "microsoft.graph.chatMessagePolicyViolationPolicyTip"},
      "userAction": "string",
      "verdictDetails": "string"
    }