Microsoft Graph: Security and compliance
Alerts and incidents from Microsoft Defender, advanced hunting queries, eDiscovery cases, threat intelligence, secure scores, information protection and…
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Alerts and incidents from Microsoft Defender, advanced hunting queries, eDiscovery cases, threat intelligence, secure scores, information protection and subject rights requests.
This listing is one area of Microsoft Graph, the single REST API for Microsoft 365, Outlook, OneDrive, Teams and Microsoft Entra ID. It holds 400 of the area's requests, the most direct ones first, generated from Microsoft's own OpenAPI description of Graph v1.0. The other areas (mail, calendar, files, Teams, users and more) are listed separately on the Microsoft page.
Get an access token
- Sign in to the Microsoft Entra admin center and open App registrations > New registration. For a quick test, the Graph Explorer signs you in and shows a token without registering anything.
- Under API permissions, add the Microsoft Graph permissions this area needs, for example:
SecurityAlert.Read.All,SecurityIncident.ReadWrite.All,ThreatHunting.Read.All,eDiscovery.ReadWrite.All. Delegated permissions act as the signed-in user; application permissions act as the app itself and need an administrator's consent. - Under Certificates & secrets, create a client secret (keep it out of shared collections).
- Get a token from
https://login.microsoftonline.com/ /oauth2/v2.0/token: the authorization-code flow for a user, orgrant_type=client_credentialswithscope=https://graph.microsoft.com/.defaultfor an app. Send it asAuthorization: Bearer.
Using these requests
- Base URL:
https://graph.microsoft.com/v1.0./me/...paths act on the signed-in user; with an application token use/users/{id or userPrincipalName}/...instead. - Shape responses with OData query parameters:
$select(fields),$filter,$orderby,$top,$expandand$search(some need theConsistencyLevel: eventualheader). Long lists are paged: follow@odata.nextLink. - Combine up to 20 requests in one call with
POST /$batch.
Common errors
| Status | Code | What to do |
|---|---|---|
| 401 | InvalidAuthenticationToken | The token is missing, expired or for another resource: get a new one for https://graph.microsoft.com. |
| 403 | Authorization_RequestDenied / ErrorAccessDenied | Add the permission listed in the request's docs and grant consent. |
| 404 | ResourceNotFound / itemNotFound | Check the id; ids from another user or tenant are not found. |
| 429 | TooManyRequests | Throttled: wait the Retry-After seconds, then retry. |
Docs: Security and compliance overview · Permissions reference · Throttling
Endpoints 400
Privacy
- GETGet privacy
/privacy - PATCHUpdate privacy
/privacy
Security
- GETGet security
/security - PATCHUpdate security
/security - POSTCreate security.run hunting query
/security/microsoft.graph.security.runHuntingQueryQueries a specified set of event, activity, or entity data supported by Microsoft 365 Defender to proactively look for specific threats in your environment.…
Data policy operations
- GETList data policy operations
/dataPolicyOperationsRetrieve the properties of a dataPolicyOperation object. - POSTCreate data policy operation
/dataPolicyOperations - GETGet data policy operation
/dataPolicyOperations/:dataPolicyOperation-idRetrieve the properties of a dataPolicyOperation object. - DELETEDelete data policy operation
/dataPolicyOperations/:dataPolicyOperation-id - PATCHUpdate data policy operation
/dataPolicyOperations/:dataPolicyOperation-id
Information protection
- GETGet information protection
/informationProtection - PATCHUpdate information protection
/informationProtection
Security: cases
- GETList cases
/security/cases - DELETEDelete cases
/security/cases - PATCHUpdate cases
/security/cases - GETList ediscovery cases
/security/cases/ediscoveryCasesGet a list of the ediscoveryCase objects and their properties. - POSTCreate ediscovery case
/security/cases/ediscoveryCasesCreate a new ediscoveryCase object. - GETGet ediscovery case
/security/cases/ediscoveryCases/:ediscoveryCase-idRead the properties and relationships of an ediscoveryCase object. - DELETEDelete ediscovery case
/security/cases/ediscoveryCases/:ediscoveryCase-idDelete an ediscoveryCase object. - PATCHUpdate ediscovery case
/security/cases/ediscoveryCases/:ediscoveryCase-idUpdate the properties of an ediscoveryCase object. - GETList tags
/security/cases/ediscoveryCases/:ediscoveryCase-id/tagsGet a list of eDiscoveryReviewTag objects and their properties. - POSTCreate tag
/security/cases/ediscoveryCases/:ediscoveryCase-id/tagsCreate a new ediscoveryReviewTag object. - GETList searches
/security/cases/ediscoveryCases/:ediscoveryCase-id/searchesGet the list of ediscoverySearch resources from an eDiscoveryCase object. - POSTCreate search
/security/cases/ediscoveryCases/:ediscoveryCase-id/searchesCreate a new ediscoverySearch object. - GETGet settings
/security/cases/ediscoveryCases/:ediscoveryCase-id/settingsRead the properties and relationships of an ediscoveryCaseSettings object. - DELETEDelete settings
/security/cases/ediscoveryCases/:ediscoveryCase-id/settings - PATCHUpdate settings
/security/cases/ediscoveryCases/:ediscoveryCase-id/settingsUpdate the properties of an ediscoveryCaseSettings object. - GETList custodians
/security/cases/ediscoveryCases/:ediscoveryCase-id/custodiansGet a list of the custodian objects and their properties. - POSTCreate custodian
/security/cases/ediscoveryCases/:ediscoveryCase-id/custodiansCreate a new ediscoveryCustodian object. After the custodian object is created, you will need to create the custodian's userSource to reference their mailbox… - GETList operations
/security/cases/ediscoveryCases/:ediscoveryCase-id/operationsGet a list of the caseOperation objects and their properties. - POSTCreate operation
/security/cases/ediscoveryCases/:ediscoveryCase-id/operations - GETList review sets
/security/cases/ediscoveryCases/:ediscoveryCase-id/reviewSetsGet a list of ediscoveryReviewSet objects associated with an eDiscovery case. - POSTCreate review set
/security/cases/ediscoveryCases/:ediscoveryCase-id/reviewSetsCreate a new ediscoveryReviewSet object. - GETList case members
/security/cases/ediscoveryCases/:ediscoveryCase-id/caseMembersGet a list of ediscoveryCaseMember objects for an ediscoveryCase. - POSTCreate case member
/security/cases/ediscoveryCases/:ediscoveryCase-id/caseMembersAdd an ediscoveryCaseMember to an ediscoveryCase. The ediscoveryCaseMember can be one of two types: a user or a role group.
Security: rules
- GETList rules
/security/rulesContainer for the security rules configured in Microsoft Defender XDR, including custom detection rules. - DELETEDelete rules
/security/rules - PATCHUpdate rules
/security/rules - GETList detection rules
/security/rules/detectionRulesGet a list of detectionRule objects and their properties. - POSTCreate detection rule
/security/rules/detectionRulesCreate a new detectionRule object. - GETGet detection rule
/security/rules/detectionRules/:detectionRule-idThe custom detection rules configured for the tenant. - DELETEDelete detection rule
/security/rules/detectionRules/:detectionRule-idDelete a detectionRule object. - PATCHUpdate detection rule
/security/rules/detectionRules/:detectionRule-id
Security: alerts
- GETList alerts
/security/alertsDeprecated. Retrieve a list of alert objects. - POSTCreate alert
/security/alertsDeprecated. - GETGet alert
/security/alerts/:alert-idDeprecated. Retrieve the properties and relationships of an alert object. - PATCHUpdate alert
/security/alerts/:alert-idDeprecated. Update an editable alert property within any integrated solution to keep alert status and assignments in sync across solutions. This method…
Security: labels
- GETList labels
/security/labels - DELETEDelete labels
/security/labels - PATCHUpdate labels
/security/labels - GETList citations
/security/labels/citationsGet a list of the citationTemplate objects and their properties. - POSTCreate citation
/security/labels/citationsCreate a new citationTemplate object. - GETList categories
/security/labels/categoriesGet a list of the categoryTemplate objects and their properties. - POSTCreate category
/security/labels/categoriesCreate a new categoryTemplate object. - GETList authorities
/security/labels/authoritiesGet a list of the authorityTemplate objects and their properties. - POSTCreate authority
/security/labels/authoritiesCreate a new authorityTemplate object. - GETList departments
/security/labels/departmentsGet a list of the departmentTemplate objects and their properties. - POSTCreate department
/security/labels/departmentsCreate a new departmentTemplate object. - GETList retention labels
/security/labels/retentionLabelsGet a list of the retentionLabel objects and their properties. - POSTCreate retention label
/security/labels/retentionLabelsCreate a new retentionLabel object. To create a disposition review stage, include the actionAfterRetentionPeriod property in the request body with one of the… - GETList file plan references
/security/labels/filePlanReferencesGet a list of the filePlanReferenceTemplate objects and their properties. - POSTCreate file plan reference
/security/labels/filePlanReferencesCreate a new filePlanReferenceTemplate object. - GETGet citation
/security/labels/citations/:citationTemplate-idRead the properties and relationships of a citationTemplate object. - DELETEDelete citation
/security/labels/citations/:citationTemplate-idDelete a citationTemplate object. - PATCHUpdate citation
/security/labels/citations/:citationTemplate-id - GETGet category
/security/labels/categories/:categoryTemplate-idRead the properties and relationships of a categoryTemplate object. - DELETEDelete category
/security/labels/categories/:categoryTemplate-idDelete a categoryTemplate object. - PATCHUpdate category
/security/labels/categories/:categoryTemplate-id - GETGet authority
/security/labels/authorities/:authorityTemplate-idRead the properties and relationships of a authorityTemplate object. - DELETEDelete authority
/security/labels/authorities/:authorityTemplate-idDelete a authorityTemplate object. - PATCHUpdate authority
/security/labels/authorities/:authorityTemplate-id - GETGet department
/security/labels/departments/:departmentTemplate-idRead the properties and relationships of a departmentTemplate object. - DELETEDelete department
/security/labels/departments/:departmentTemplate-idDelete a departmentTemplate object. - PATCHUpdate department
/security/labels/departments/:departmentTemplate-id - GETGet retention label
/security/labels/retentionLabels/:retentionLabel-idRead the properties and relationships of a retentionLabel object. - DELETEDelete retention label
/security/labels/retentionLabels/:retentionLabel-idDelete a retentionLabel object. - PATCHUpdate retention label
/security/labels/retentionLabels/:retentionLabel-idUpdate the properties of a retentionLabel object. To update a disposition review stage, include the actionAfterRetentionPeriod property in the request body… - GETGet file plan reference
/security/labels/filePlanReferences/:filePlanReferenceTemplate-idRead the properties and relationships of a filePlanReferenceTemplate object. - DELETEDelete file plan reference
/security/labels/filePlanReferences/:filePlanReferenceTemplate-idDelete a filePlanReferenceTemplate object. - PATCHUpdate file plan reference
/security/labels/filePlanReferences/:filePlanReferenceTemplate-id - GETList subcategories
/security/labels/categories/:categoryTemplate-id/subcategoriesGet a list of subcategories subcategoryTemplate associated with a category template. - POSTCreate subcategory
/security/labels/categories/:categoryTemplate-id/subcategoriesCreate a new subcategoryTemplate object. - GETList descriptors
/security/labels/retentionLabels/:retentionLabel-id/descriptorsRepresents out-of-the-box values that provide more options to improve the manageability and organization of the content you need to label. - DELETEDelete descriptors
/security/labels/retentionLabels/:retentionLabel-id/descriptors - PATCHUpdate descriptors
/security/labels/retentionLabels/:retentionLabel-id/descriptors - GETGet retention event type
/security/labels/retentionLabels/:retentionLabel-id/retentionEventTypeRepresents the type associated with a retention event.
Security: audit log
- GETGet audit log
/security/auditLogThe entry point for the audit log query API. - DELETEDelete audit log
/security/auditLog - PATCHUpdate audit log
/security/auditLog - GETList queries
/security/auditLog/queriesGet a list of auditLogQuery objects and their properties. - POSTCreate query
/security/auditLog/queriesCreate a new auditLogQuery object. - GETGet query
/security/auditLog/queries/:auditLogQuery-idRead the properties and relationships of an auditLogQuery object. - DELETEDelete query
/security/auditLog/queries/:auditLogQuery-id - GETList records
/security/auditLog/queries/:auditLogQuery-id/recordsThe collection of audit log records retrieved by the query.
Security: triggers
- GETList triggers
/security/triggers - DELETEDelete triggers
/security/triggers - PATCHUpdate triggers
/security/triggers - GETList retention events
/security/triggers/retentionEventsGet a list of the retentionEvent objects and their properties. - POSTCreate retention event
/security/triggers/retentionEventsCreate a new retentionEvent object. - GETGet retention event
/security/triggers/retentionEvents/:retentionEvent-idRead the properties and relationships of a retentionEvent object. - DELETEDelete retention event
/security/triggers/retentionEvents/:retentionEvent-idDelete a retentionEvent object. - PATCHUpdate retention event
/security/triggers/retentionEvents/:retentionEvent-id - GETGet retention event type
/security/triggers/retentionEvents/:retentionEvent-id/retentionEventTypeSpecifies the event that will start the retention period for labels that use this event type when an event is created.
Security: alerts_v2
- GETGet alerts_v2
/security/alerts_v2Get a list of alert resources created to track suspicious activities in an organization. This operation lets you filter and sort through alerts to create an… - POSTCreate alerts_v2
/security/alerts_v2 - POSTCreate security.move alert
/security/alerts_v2/microsoft.graph.security.moveAlertsMove one or more alert resources to a new or existing incident. - GETGet alerts_v2
/security/alerts_v2/:alert-idGet the properties and relationships of an alert object. - DELETEDelete alerts_v2
/security/alerts_v2/:alert-id - PATCHUpdate alerts_v2
/security/alerts_v2/:alert-idUpdate the properties of an alert object in an organization based on the specified alert id property. - POSTCreate comment
/security/alerts_v2/:alert-id/commentsCreate a comment for an existing alert based on the specified alert id property.
Security: incidents
- GETList incidents
/security/incidentsGet a list of incident objects that Microsoft 365 Defender created to track attacks in an organization. Attacks are typically inflicted on different types of… - POSTCreate incident
/security/incidents - POSTCreate security.merge incident
/security/incidents/microsoft.graph.security.mergeIncidentsMerge multiple incident resources into a single incident. - GETGet incident
/security/incidents/:incident-idRetrieve the properties and relationships of an incident object. Attacks are typically inflicted on different types of entities, such as devices, users, and… - DELETEDelete incident
/security/incidents/:incident-id - PATCHUpdate incident
/security/incidents/:incident-idUpdate the properties of an incident object. - GETList alerts
/security/incidents/:incident-id/alertsThe list of related alerts. Supports $expand. - GETGet alert
/security/incidents/:incident-id/alerts/:alert-idThe list of related alerts. Supports $expand.
Security: identities
- GETList identities
/security/identitiesA container for security identities APIs. - DELETEDelete identities
/security/identities - PATCHUpdate identities
/security/identities - GETList sensors
/security/identities/sensorsGet a list of sensor objects and their properties. - POSTCreate sensor
/security/identities/sensors - GETGet settings
/security/identities/settingsRepresents a container for security identities settings APIs. - DELETEDelete settings
/security/identities/settings - PATCHUpdate settings
/security/identities/settings - GETList health issues
/security/identities/healthIssuesGet a list of healthIssue objects and their properties. - POSTCreate health issue
/security/identities/healthIssues - GETList identity accounts
/security/identities/identityAccountsGet a list of the identityAccounts objects and their properties. - POSTCreate identity account
/security/identities/identityAccounts - GETList sensor candidates
/security/identities/sensorCandidatesGet a list of the sensorCandidate objects and their properties. - POSTCreate sensor candidate
/security/identities/sensorCandidates - GETGet sensor candidate activation configuration
/security/identities/sensorCandidateActivationConfigurationRead the properties and relationships of microsoft.graph.security.sensorCandidateActivationConfiguration object. - DELETEDelete sensor candidate activation configuration
/security/identities/sensorCandidateActivationConfiguration - PATCHUpdate sensor candidate activation configuration
/security/identities/sensorCandidateActivationConfiguration - GETGet auto auditing configuration
/security/identities/settings/autoAuditingConfigurationGet the properties and relationships of microsoft.graph.security.autoAuditingConfiguration object. - DELETEDelete auto auditing configuration
/security/identities/settings/autoAuditingConfiguration - PATCHUpdate auto auditing configuration
/security/identities/settings/autoAuditingConfigurationUpdate the properties of an autoAuditingConfiguration object. - POSTCreate security.activate
/security/identities/sensorCandidates/microsoft.graph.security.activateActivate Microsoft Defender for Identity sensors. - GETSecurity.get deployment access key (sensor)
/security/identities/sensors/microsoft.graph.security.getDeploymentAccessKey()Get the deployment access key for Microsoft Defender for Identity that is required to install sensors associated with the workspace. - GETSecurity.get deployment package uri (sensor)
/security/identities/sensors/microsoft.graph.security.getDeploymentPackageUri()Get the sensor deployment package URL and version. You can use this URL to download the installer to install the sensor on a server. - POSTCreate security.regenerate deployment access key
/security/identities/sensors/microsoft.graph.security.regenerateDeploymentAccessKeyGenerate a new deployment access key that can be used to install a sensor associated with the workspace. - GETGet sensor
/security/identities/sensors/:sensor-idRead the properties and relationships of a sensor object. - DELETEDelete sensor
/security/identities/sensors/:sensor-idDelete a sensor object. - PATCHUpdate sensor
/security/identities/sensors/:sensor-idUpdate the properties of a sensor object. - GETGet health issue
/security/identities/healthIssues/:healthIssue-idRead the properties and relationships of a healthIssue object. - DELETEDelete health issue
/security/identities/healthIssues/:healthIssue-id - PATCHUpdate health issue
/security/identities/healthIssues/:healthIssue-idUpdate the properties of a healthIssue object. - GETGet sensor candidate
/security/identities/sensorCandidates/:sensorCandidate-idRepresents Microsoft Defender for Identity sensors that are ready to be activated. - DELETEDelete sensor candidate
/security/identities/sensorCandidates/:sensorCandidate-id - PATCHUpdate sensor candidate
/security/identities/sensorCandidates/:sensorCandidate-id - GETGet identity account
/security/identities/identityAccounts/:identityAccounts-idRead the properties and relationships of a single identity security account object. This allows retrieving information about available identity accounts. - DELETEDelete identity account
/security/identities/identityAccounts/:identityAccounts-id - PATCHUpdate identity account
/security/identities/identityAccounts/:identityAccounts-id - GETList health issues
/security/identities/sensors/:sensor-id/healthIssuesRepresents potential issues within a customer's Microsoft Defender for Identity configuration that Microsoft Defender for Identity identified related to the…
Security: secure scores
- GETList secure scores
/security/secureScoresRetrieve a list of secureScore objects. - POSTCreate secure score
/security/secureScores - GETGet secure score
/security/secureScores/:secureScore-idRetrieve the properties and relationships of a secureScore object. - DELETEDelete secure score
/security/secureScores/:secureScore-id - PATCHUpdate secure score
/security/secureScores/:secureScore-id
Security: trigger types
- GETList trigger types
/security/triggerTypes - DELETEDelete trigger types
/security/triggerTypes - PATCHUpdate trigger types
/security/triggerTypes - GETList retention event types
/security/triggerTypes/retentionEventTypesGet a list of the retentionEventType objects and their properties. - POSTCreate retention event type
/security/triggerTypes/retentionEventTypesCreate a new retentionEventType object. - GETGet retention event type
/security/triggerTypes/retentionEventTypes/:retentionEventType-idRead the properties and relationships of a retentionEventType object. - DELETEDelete retention event type
/security/triggerTypes/retentionEventTypes/:retentionEventType-idDelete a retentionEventType object. - PATCHUpdate retention event type
/security/triggerTypes/retentionEventTypes/:retentionEventType-id
Security: collaboration
- GETGet collaboration
/security/collaboration - DELETEDelete collaboration
/security/collaboration - PATCHUpdate collaboration
/security/collaboration - GETList analyzed emails
/security/collaboration/analyzedEmailsGet a list of analyzedEmail objects and their properties. This API allows Security Operations teams to have direct access to hunt (query) for threats, IOCs,… - POSTCreate analyzed email
/security/collaboration/analyzedEmails - POSTCreate security.remediate
/security/collaboration/analyzedEmails/microsoft.graph.security.remediateRemove a potential threat from end users' mailboxes. Remediation means to take prescribed action against a threat. This API can trigger email purge actions… - GETGet analyzed email
/security/collaboration/analyzedEmails/:analyzedEmail-idRead the properties and relationships of an analyzedEmail object. - DELETEDelete analyzed email
/security/collaboration/analyzedEmails/:analyzedEmail-id - PATCHUpdate analyzed email
/security/collaboration/analyzedEmails/:analyzedEmail-id
Security: attack simulation
- GETGet attack simulation
/security/attackSimulation - DELETEDelete attack simulation
/security/attackSimulation - PATCHUpdate attack simulation
/security/attackSimulation - GETList payloads
/security/attackSimulation/payloadsGet a list of payloads for attack simulation campaigns. This operation expects the mandatory parameter source to filter and query the respective data source. - POSTCreate payload
/security/attackSimulation/payloads - GETList trainings
/security/attackSimulation/trainingsGet a list of the training objects and their properties. - POSTCreate training
/security/attackSimulation/trainings - GETList login pages
/security/attackSimulation/loginPagesGet a list of the loginPage objects and their properties. - POSTCreate login page
/security/attackSimulation/loginPages - GETList operations
/security/attackSimulation/operationsGet an attack simulation operation to track a long-running operation request for a tenant. - POSTCreate operation
/security/attackSimulation/operations - GETList simulations
/security/attackSimulation/simulationsGet a list of attack simulation campaigns for a tenant. - POSTCreate simulation
/security/attackSimulation/simulationsCreate an attack simulation campaign for a tenant. - GETList landing pages
/security/attackSimulation/landingPagesGet a list of the landingPage objects and their properties. - POSTCreate landing page
/security/attackSimulation/landingPages - GETList end user notifications
/security/attackSimulation/endUserNotificationsGet a list of endUserNotification objects and their properties. - POSTCreate end user notification
/security/attackSimulation/endUserNotifications - GETList simulation automations
/security/attackSimulation/simulationAutomationsGet a list of attack simulation automations for a tenant. - POSTCreate simulation automation
/security/attackSimulation/simulationAutomations - GETGet payload
/security/attackSimulation/payloads/:payload-idGet an attack simulation campaign payload for a tenant. - DELETEDelete payload
/security/attackSimulation/payloads/:payload-id - PATCHUpdate payload
/security/attackSimulation/payloads/:payload-id - GETGet training
/security/attackSimulation/trainings/:training-idGet an attack simulation training for a tenant. - DELETEDelete training
/security/attackSimulation/trainings/:training-id - PATCHUpdate training
/security/attackSimulation/trainings/:training-id - GETGet login page
/security/attackSimulation/loginPages/:loginPage-idGet a loginPage associated with an attack simulation campaign for a tenant. Login pages are shown to users in attack simulations that use credential harvest… - DELETEDelete login page
/security/attackSimulation/loginPages/:loginPage-id - PATCHUpdate login page
/security/attackSimulation/loginPages/:loginPage-id - GETGet simulation
/security/attackSimulation/simulations/:simulation-idGet an attack simulation campaign for a tenant. - DELETEDelete simulation
/security/attackSimulation/simulations/:simulation-idDelete an attack simulation campaign for a tenant. - PATCHUpdate simulation
/security/attackSimulation/simulations/:simulation-idUpdate an attack simulation campaign for a tenant. You can only update simulations that are in draft status. - GETGet landing page
/security/attackSimulation/landingPages/:landingPage-idGet a landingPage associated with an attack simulation campaign for a tenant. - DELETEDelete landing page
/security/attackSimulation/landingPages/:landingPage-id - PATCHUpdate landing page
/security/attackSimulation/landingPages/:landingPage-id - GETGet operation
/security/attackSimulation/operations/:attackSimulationOperation-idGet an attack simulation operation to track a long-running operation request for a tenant. - DELETEDelete operation
/security/attackSimulation/operations/:attackSimulationOperation-id - PATCHUpdate operation
/security/attackSimulation/operations/:attackSimulationOperation-id - GETGet end user notification
/security/attackSimulation/endUserNotifications/:endUserNotification-idRepresents an end user's notification for an attack simulation training. - DELETEDelete end user notification
/security/attackSimulation/endUserNotifications/:endUserNotification-id - PATCHUpdate end user notification
/security/attackSimulation/endUserNotifications/:endUserNotification-id - GETGet simulation automation
/security/attackSimulation/simulationAutomations/:simulationAutomation-idGet an attack simulation automation for a tenant. - DELETEDelete simulation automation
/security/attackSimulation/simulationAutomations/:simulationAutomation-id - PATCHUpdate simulation automation
/security/attackSimulation/simulationAutomations/:simulationAutomation-id - GETGet payload
/security/attackSimulation/simulations/:simulation-id/payloadThe payload associated with a simulation during its creation. - GETList details
/security/attackSimulation/landingPages/:landingPage-id/detailsThe detail information for a landing page associated with a simulation during its creation. - POSTCreate detail
/security/attackSimulation/landingPages/:landingPage-id/details - GETGet login page
/security/attackSimulation/simulations/:simulation-id/loginPageThe login page associated with a simulation during its creation. - GETGet landing page
/security/attackSimulation/simulations/:simulation-id/landingPageThe landing page associated with a simulation during its creation. - GETList language details
/security/attackSimulation/trainings/:training-id/languageDetailsGet the language details about an attack simulation training for a tenant. - POSTCreate language detail
/security/attackSimulation/trainings/:training-id/languageDetails
Security: threat intelligence
- GETGet threat intelligence
/security/threatIntelligence - DELETEDelete threat intelligence
/security/threatIntelligence - PATCHUpdate threat intelligence
/security/threatIntelligence - GETList hosts
/security/threatIntelligence/hostsRead the properties and relationships of a host object. The host resource is the abstract base type that returns an implementation. A host can be of one of… - POSTCreate host
/security/threatIntelligence/hosts - GETList articles
/security/threatIntelligence/articlesGet a list of article objects, including their properties and relationships. - POSTCreate article
/security/threatIntelligence/articles - GETList host pairs
/security/threatIntelligence/hostPairsRead the properties and relationships of a hostPair object. - POSTCreate host pair
/security/threatIntelligence/hostPairs - GETList host ports
/security/threatIntelligence/hostPortsRead the properties and relationships of a hostPort object. - POSTCreate host port
/security/threatIntelligence/hostPorts - GETList subdomains
/security/threatIntelligence/subdomainsRead the properties and relationships of a subdomain object. - POSTCreate subdomain
/security/threatIntelligence/subdomains - GETList host cookies
/security/threatIntelligence/hostCookiesRead the properties and relationships of a hostCookie object. - POSTCreate host cooky
/security/threatIntelligence/hostCookies - GETList host trackers
/security/threatIntelligence/hostTrackersRead the properties and relationships of a hostTracker object. - POSTCreate host tracker
/security/threatIntelligence/hostTrackers - GETList whois records
/security/threatIntelligence/whoisRecordsGet a list of whoisRecord objects. - POSTCreate whois record
/security/threatIntelligence/whoisRecords - GETList intel profiles
/security/threatIntelligence/intelProfilesGet a list of the intelligenceProfile objects and their properties. - POSTCreate intel profile
/security/threatIntelligence/intelProfiles - GETList host components
/security/threatIntelligence/hostComponentsRead the properties and relationships of a hostComponent object. - POSTCreate host component
/security/threatIntelligence/hostComponents - GETList ssl certificates
/security/threatIntelligence/sslCertificatesGet a list of sslCertificate objects and their properties. - POSTCreate ssl certificate
/security/threatIntelligence/sslCertificates - GETList vulnerabilities
/security/threatIntelligence/vulnerabilitiesRead the properties and relationships of a vulnerability object. - POSTCreate vulnerability
/security/threatIntelligence/vulnerabilities - GETList article indicators
/security/threatIntelligence/articleIndicatorsRead the properties and relationships of an articleIndicator object. - POSTCreate article indicator
/security/threatIntelligence/articleIndicators - GETList passive dns records
/security/threatIntelligence/passiveDnsRecordsRead the properties and relationships of a passiveDnsRecord object. - POSTCreate passive dns record
/security/threatIntelligence/passiveDnsRecords - GETList host ssl certificates
/security/threatIntelligence/hostSslCertificatesGet the properties and relationships of a hostSslCertificate object. - POSTCreate host ssl certificate
/security/threatIntelligence/hostSslCertificates - GETList whois history records
/security/threatIntelligence/whoisHistoryRecordsRetrieve details about whoisHistoryRecord objects.Note: List retrieval is not yet supported. - POSTCreate whois history record
/security/threatIntelligence/whoisHistoryRecords - GETList intelligence profile indicators
/security/threatIntelligence/intelligenceProfileIndicatorsRead the properties and relationships of a intelligenceProfileIndicator object. - POSTCreate intelligence profile indicator
/security/threatIntelligence/intelligenceProfileIndicators - GETGet host
/security/threatIntelligence/hosts/:host-idRead the properties and relationships of a host object. The host resource is the abstract base type that returns an implementation. A host can be of one of… - DELETEDelete host
/security/threatIntelligence/hosts/:host-id - PATCHUpdate host
/security/threatIntelligence/hosts/:host-id - GETGet article
/security/threatIntelligence/articles/:article-idRead the properties and relationships of an article object. - DELETEDelete article
/security/threatIntelligence/articles/:article-id - PATCHUpdate article
/security/threatIntelligence/articles/:article-id - GETGet host pair
/security/threatIntelligence/hostPairs/:hostPair-idRead the properties and relationships of a hostPair object. - DELETEDelete host pair
/security/threatIntelligence/hostPairs/:hostPair-id - PATCHUpdate host pair
/security/threatIntelligence/hostPairs/:hostPair-id - GETGet host port
/security/threatIntelligence/hostPorts/:hostPort-idRead the properties and relationships of a hostPort object. - DELETEDelete host port
/security/threatIntelligence/hostPorts/:hostPort-id - PATCHUpdate host port
/security/threatIntelligence/hostPorts/:hostPort-id - GETGet subdomain
/security/threatIntelligence/subdomains/:subdomain-idRead the properties and relationships of a subdomain object. - DELETEDelete subdomain
/security/threatIntelligence/subdomains/:subdomain-id - PATCHUpdate subdomain
/security/threatIntelligence/subdomains/:subdomain-id - GETGet host cooky
/security/threatIntelligence/hostCookies/:hostCookie-idRead the properties and relationships of a hostCookie object. - DELETEDelete host cooky
/security/threatIntelligence/hostCookies/:hostCookie-id - PATCHUpdate host cooky
/security/threatIntelligence/hostCookies/:hostCookie-id - GETGet host tracker
/security/threatIntelligence/hostTrackers/:hostTracker-idRead the properties and relationships of a hostTracker object. - DELETEDelete host tracker
/security/threatIntelligence/hostTrackers/:hostTracker-id - PATCHUpdate host tracker
/security/threatIntelligence/hostTrackers/:hostTracker-id - GETGet whois record
/security/threatIntelligence/whoisRecords/:whoisRecord-idGet the specified whoisRecord resource. Specify the desired whoisRecord in one of the following two ways: Identify a host and get its current whoisRecord.… - DELETEDelete whois record
/security/threatIntelligence/whoisRecords/:whoisRecord-id - PATCHUpdate whois record
/security/threatIntelligence/whoisRecords/:whoisRecord-id - GETGet host component
/security/threatIntelligence/hostComponents/:hostComponent-idRead the properties and relationships of a hostComponent object. - DELETEDelete host component
/security/threatIntelligence/hostComponents/:hostComponent-id - PATCHUpdate host component
/security/threatIntelligence/hostComponents/:hostComponent-id - GETGet vulnerability
/security/threatIntelligence/vulnerabilities/:vulnerability-idRead the properties and relationships of a vulnerability object. - DELETEDelete vulnerability
/security/threatIntelligence/vulnerabilities/:vulnerability-id - PATCHUpdate vulnerability
/security/threatIntelligence/vulnerabilities/:vulnerability-id - GETGet ssl certificate
/security/threatIntelligence/sslCertificates/:sslCertificate-idGet the properties and relationships of an sslCertificate object. - DELETEDelete ssl certificate
/security/threatIntelligence/sslCertificates/:sslCertificate-id - PATCHUpdate ssl certificate
/security/threatIntelligence/sslCertificates/:sslCertificate-id - GETGet intel profile
/security/threatIntelligence/intelProfiles/:intelligenceProfile-idRead the properties and relationships of a intelligenceProfile object. - DELETEDelete intel profile
/security/threatIntelligence/intelProfiles/:intelligenceProfile-id - PATCHUpdate intel profile
/security/threatIntelligence/intelProfiles/:intelligenceProfile-id
Showing 300 of 400 endpoints. Fork the collection to see all of them.
API details
- Base URL
https://graph.microsoft.com/v1.0- Authentication
- OAuth 2.0 (authorization code, client credentials flows)
- Operations
- 400 operations on 198 pathsGET 188POST 73PATCH 71DELETE 68
19 marked deprecated - Main resources
- Security: threat intelligence 114Security: attack simulation 50Security: labels 39Security: identities 37Security: cases 23Privacy: subject rights requests 15Security: data security and governance 15Security: subject rights requests 14Security: collaboration 9Security: triggers 9
- Description format
- OpenAPI 3.0.4, API version
v1.0 - Links
- Documentation · OpenAPI document
How to test the Microsoft Graph: Security and compliance in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Microsoft Graph: Security and compliance collection, without the publisher's secrets.
- Add your credentialsThis API uses OAuth 2.0 (authorization code, client credentials flows). Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “Get privacy” (GET /privacy), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Microsoft Graph: Security and compliance?
Alerts and incidents from Microsoft Defender, advanced hunting queries, eDiscovery cases, threat intelligence, secure scores, information protection and… It is listed under Identity & security and has 400 endpoints.
Who publishes the Microsoft Graph: Security and compliance?
It is listed from Microsoft's public API description (an OpenAPI document), not published by Microsoft on Swastik Codes. Anyone who controls microsoft.com can claim the profile by adding a DNS TXT record.
What is the base URL of the Microsoft Graph: Security and compliance?
Requests go to https://graph.microsoft.com/v1.0. Endpoint paths are added to this base URL.
How do I authenticate with the Microsoft Graph: Security and compliance?
With OAuth 2.0 (authorization code, client credentials flows).
How many endpoints does the Microsoft Graph: Security and compliance have?
400 operations on 198 paths (188 GET, 73 POST, 71 PATCH, 68 DELETE). The largest groups are Security: threat intelligence, Security: attack simulation, Security: labels, Security: identities.
Is forking the Microsoft Graph: Security and compliance free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.