urlAssessmentRequest resource type

Namespace: microsoft.graph

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.

Used to create and retrieve a URL threat assessment, derived from threatAssessmentRequest.

Methods

Method	Return Type	Description
Create	urlAssessmentRequest	Create a new URL assessment request by posting an urlAssessmentRequest object.
Get	urlAssessmentRequest	Read the properties and relationships of a urlAssessmentRequest object.

Properties

Property	Type	Description
url	String	The URL string.
category	threatCategory	The threat category. Possible values are: spam, phishing, malware.
contentType	threatAssessmentContentType	The content type of the threat assessment. Possible values are: mail, url, file.
createdBy	identitySet	The threat assessment request creator.
createdDateTime	DateTimeOffset	The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.
expectedAssessment	threatExpectedAssessment	The expected assessment from the submitter. Possible values are: block, unblock.
id	String	The threat assessment request ID is a globally unique identifier (GUID).
requestSource	threatAssessmentRequestSource	The source of the threat assessment request. Possible values are: user, administrator.
status	threatAssessmentStatus	The assessment process status. Possible values are: pending, completed.

Relationships

Relationship	Type	Description
results	threatAssessmentResult collection	A collection of threat assessment results. Read-only. By default, a GET /threatAssessmentRequests/{id} doesn't return this property unless you apply $expand on it.

JSON representation

The following JSON representation shows the resource type.

{
  "url": "String",
  "category": "String",
  "contentType": "String",
  "createdBy": {"@odata.type": "microsoft.graph.identitySet"},
  "createdDateTime": "String (timestamp)",
  "expectedAssessment": "String",
  "id": "String (identifier)",
  "requestSource": "String",
  "status": "String"
}