fileThreatSubmission resource type

Namespace: microsoft.graph.security

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 threat submission related to a file. It's used to submit suspected malware email attachments to Microsoft Defender for Office 365. It could also be used to submit false positive cases that shouldn't have been blocked by Microsoft Defender for Office 365, for example, a safe email attachment.

Currently, file threat submission is routed to Microsoft Defender for Office 365. In future, it may be routed to Microsoft Defender for Endpoint. This is a unified interface for file threat submission no matter where it's routed to.

This is an abstract type. Inherits from threatSubmission.

Methods

Method Return type Description
List fileThreatSubmissions microsoft.graph.security.fileThreatSubmission collection Get a list of the fileThreatSubmission objects and their properties.
Create fileThreatSubmission microsoft.graph.security.fileThreatSubmission Create a new fileThreatSubmission object.
Get fileThreatSubmission microsoft.graph.security.fileThreatSubmission Read the properties and relationships of a fileThreatSubmission object.

Properties

Property Type Description
fileName String It specifies the file name to be submitted.

Relationships

None.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.security.fileThreatSubmission",
  "id": "String (identifier)",
  "tenantId": "String",
  "createdDateTime": "String (timestamp)",
  "contentType": "String",
  "category": "String",
  "source": "String",
  "createdBy": {
    "@odata.type": "microsoft.graph.security.submissionUserIdentity"
  },
  "status": "String",
  "result": {
    "@odata.type": "microsoft.graph.security.submissionResult"
  },
  "adminReview": {
    "@odata.type": "microsoft.graph.security.submissionAdminReview"
  },
  "clientSource": "String",
  "fileName": "String"
}