alert resource type (deprecated)

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.

Note

The legacy alerts API is deprecated and will be removed by April 2026. We recommend that you migrate to the new alerts and incidents API.

This resource corresponds to the first generation of alerts in the Microsoft Graph security API, representing potential security issues within a customer's tenant that Microsoft or a partner security solution identifies.

This type of alerts federates calling of supported Azure and Microsoft 365 Defender security providers listed in Use the Microsoft Graph security API. It aggregates common alert data among the different domains to allow applications to unify and streamline management of security issues across all integrated solutions.

To learn more, see the sample queries in Graph Explorer.

Note

This resource is one of the two types of alerts that the beta version of the Microsoft Graph security API offers. For more information, see alerts.

Methods

Method	Return Type	Description
Get alert	alert	Read properties and relationships of an alert object.
Update alert	alert	Update an alert object.
List alerts	alert collection	Get an alert object collection.
Update multiple alerts	alert collection	Update multiple alert objects.

Properties

Property	Type	Description
activityGroupName	String	Name or alias of the activity group (attacker) this alert is attributed to.
assignedTo	String	Name of the analyst the alert is assigned to for triage, investigation, or remediation (supports update).
azureSubscriptionId	String	Azure subscription ID, present if this alert is related to an Azure resource.
azureTenantId	String	Microsoft Entra tenant ID. Required.
category	String	Category of the alert (for example, credentialTheft, ransomware).
closedDateTime	DateTimeOffset	Time at which the alert was closed. 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 (supports update).
cloudAppStates	cloudAppSecurityState collection	Security-related stateful information generated by the provider about the cloud application/s related to this alert.
comments	String collection	Customer-provided comments on alert (for customer alert management) (supports update).
confidence	Int32	Confidence of the detection logic (percentage between 1-100).
createdDateTime	DateTimeOffset	Time at which the alert was created by the alert provider. 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. Required.
description	String	Alert description.
detectionIds	String collection	Set of alerts related to this alert entity (each alert is pushed to the SIEM as a separate record).
eventDateTime	DateTimeOffset	Time at which the event or events that served as the trigger to generate the alert occurred. 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. Required.
feedback	alertFeedback	Analyst feedback on the alert. Possible values are: unknown, truePositive, falsePositive, benignPositive. Supports update.
fileStates	fileSecurityState collection	Security-related stateful information generated by the provider about the file(s) related to this alert.
historyStates	alertHistoryState collection	A collection of alertHistoryStates comprising an audit log of all updates made to an alert.
hostStates	hostSecurityState collection	Security-related stateful information generated by the provider about the host(s) related to this alert.
id	String	Provider-generated GUID/unique identifier. Read-only. Required.
incidentIds	String collection	IDs of incidents related to current alert.
lastModifiedDateTime	DateTimeOffset	Time at which the alert entity was last modified. 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.
malwareStates	malwareState collection	Threat Intelligence pertaining to malware related to this alert.
networkConnections	networkConnection collection	Security-related stateful information generated by the provider about the network connection(s) related to this alert.
processes	process collection	Security-related stateful information generated by the provider about the process or processes related to this alert.
recommendedActions	String collection	Vendor/provider recommended action(s) to take as a result of the alert (for example, isolate machine, enforce2FA, reimage host).
registryKeyStates	registryKeyState collection	Security-related stateful information generated by the provider about the registry keys related to this alert.
securityResources	securityResource collection	Resources related to current alert. For example, for some alerts this can have the Azure Resource value.
severity	alertSeverity	Alert severity - set by vendor/provider. Possible values are: unknown, informational, low, medium, high. Required.
sourceMaterials	String collection	Hyperlinks (URIs) to the source material related to the alert, for example, provider's user interface for alerts or log search.
status	alertStatus	Alert lifecycle status (stage). Possible values are: unknown, newAlert, inProgress, resolved. (supports update). Required.
tags	String collection	User-definable labels that can be applied to an alert and can serve as filter conditions (for example "HVA", "SAW") (supports update).
title	String	Alert title. Required.
triggers	alertTrigger collection	Security-related information about the specific properties that triggered the alert (properties appearing in the alert). Alerts might contain information about multiple users, hosts, files, ip addresses. This field indicates which properties triggered the alert generation.
userStates	userSecurityState collection	Security-related stateful information generated by the provider about the user accounts related to this alert.
vendorInformation	securityVendorInformation	Complex type containing details about the security product/service vendor, provider, and subprovider (for example, vendor=Microsoft; provider=Windows Defender ATP; subProvider=AppLocker). Required.
vulnerabilityStates	vulnerabilityState collection	Threat intelligence pertaining to one or more vulnerabilities related to this alert.

Relationships

None.

JSON representation

The following JSON representation shows the resource type.

{
  "activityGroupName": "String",
  "assignedTo": "String",
  "azureSubscriptionId": "String",
  "azureTenantId": "String",
  "category": "String",
  "closedDateTime": "String (timestamp)",
  "cloudAppStates": [{"@odata.type": "microsoft.graph.cloudAppSecurityState"}],
  "comments": ["String"],
  "confidence": 1024,
  "createdDateTime": "String (timestamp)",
  "description": "String",
  "detectionIds": ["String"],
  "eventDateTime": "String (timestamp)",
  "feedback": "@odata.type: microsoft.graph.alertFeedback",
  "fileStates": [{"@odata.type": "microsoft.graph.fileSecurityState"}],
  "historyStates": [{"@odata.type": "microsoft.graph.alertHistoryState"}],
  "hostStates": [{"@odata.type": "microsoft.graph.hostSecurityState"}],
  "id": "String (identifier)",
  "incidentIds": ["String"],
  "lastModifiedDateTime": "String (timestamp)",
  "malwareStates": [{"@odata.type": "microsoft.graph.malwareState"}],
  "networkConnections": [{"@odata.type": "microsoft.graph.networkConnection"}],
  "processes": [{"@odata.type": "microsoft.graph.process"}],
  "recommendedActions": ["String"],
  "registryKeyStates": [{"@odata.type": "microsoft.graph.registryKeyState"}],
  "securityResources": [{"@odata.type": "microsoft.graph.securityResource"}],
  "severity": "@odata.type: microsoft.graph.alertSeverity",
  "sourceMaterials": ["String"],
  "status": "@odata.type: microsoft.graph.alertStatus",
  "tags": ["String"],
  "title": "String",
  "triggers": [{"@odata.type": "microsoft.graph.alertTrigger"}],
  "userStates": [{"@odata.type": "microsoft.graph.userSecurityState"}],
  "vendorInformation": {"@odata.type": "microsoft.graph.securityVendorInformation"},
  "vulnerabilityStates": [{"@odata.type": "microsoft.graph.vulnerabilityState"}]
}