urlThreatSubmission 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.

Represent a threat submission related to a URL.

This resource is used to submit suspected phishing URLs to Microsoft Defender for Office 365. It can also be used to submit false positive cases that should not have been blocked, such as safe URLs.

Inherits from threatSubmission.

Methods

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

Properties

Property Type Description
webUrl String Denotes the webUrl that needs to be submitted.

Relationships

None.

JSON representation

The following is a JSON representation of the resource.

{
  "@odata.type": "#microsoft.graph.security.urlThreatSubmission",
  "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",
  "webUrl": "String"
}