Table of Contents

SecurityAnalyzedMessage.Read.All

Read email metadata and security detection details on behalf of the signed in user.

Merill's Note

For an app to access data in Microsoft Graph, the user or administrator must grant it the permissions it needs. This article lists all the Microsoft Graph APIs and your tenant data that can be accessed by the application (vendor/developer) if you consent to the SecurityAnalyzedMessage.Read.All permission.

If you need to create an audit report of the permissions granted to all the apps in your tenant, you can run the Export-MsIdAppConsentGrantReport command. See How To: Run a quick OAuth app audit of your tenant

Category Application Delegated
Identifier b48f7ac2-044d-4281-b02f-75db744d6f5f 53e6783e-b127-4a35-ab3a-6a52d80a9077
DisplayText Read metadata and detection details for all emails in your organization Read metadata and detection details for emails in your organization
Description Read email metadata and security detection details, without a signed-in user. Read email metadata and security detection details on behalf of the signed in user.
AdminConsentRequired Yes Yes

Graph Methods

Resources

Granting this permission allows the calling application to access (and/or update) the following information in your tenant.

Graph reference: analyzedEmail

Property Type Description
alertIds String collection A collection of values that contain the IDs of any alerts associated with the email.
attachments microsoft.graph.security.analyzedEmailAttachment collection A collection of the attachments in the email.
attachmentsCount Int32 The number of attachments in the email.
authenticationDetails microsoft.graph.security.analyzedEmailAuthenticationDetail The authentication details associated with the email.
bulkComplaintLevel String The bulk complaint level of the email. A higher level is more likely to be spam.
contexts String collection Provides context of the email.
detectionMethods String collection The methods of detection used.
directionality microsoft.graph.security.antispamDirectionality The direction of the emails. The possible values are: unknown, inbound, outbound, intraOrg, unknownFutureValue.
distributionList String The distribution list details to which the email was sent.
emailClusterId String The identifier for the group of similar emails clustered based on heuristic analysis of their content.
exchangeTransportRules microsoft.graph.security.analyzedEmailExchangeTransportRuleInfo collection The name of the Exchange transport rules (ETRs) associated with the email.
id String The ID of an analyzed email.
internetMessageId String A public-facing identifier for the email that is sent. The message ID is in the format specified by RFC2822.
language String The detected language of the email content.
latestDelivery microsoft.graph.security.analyzedEmailDeliveryDetail The latest delivery details of the email.
loggedDateTime DateTimeOffset Date-time when the email record was logged.
networkMessageId String An internal identifier for the email generated by Microsoft 365.
originalDelivery microsoft.graph.security.analyzedEmailDeliveryDetail The original delivery details of the email.
overrideSources String collection An aggregated list of all overrides with source on email.
phishConfidenceLevel String The phish confidence level associated with the email
policy String The action policy that took effect.
policyAction String The action taken on the email based on the configured policy.
recipientEmailAddress String Contains the email address of the recipient.
returnPath String A field that indicates where and how bounced emails are processed.
senderDetail microsoft.graph.security.analyzedEmailSenderDetail Sender details of the email.
sizeInBytes Int32 Size of the email in bytes.
spamConfidenceLevel String Spam confidence of the email.
subject String Subject of the email.
threatTypes microsoft.graph.security.threatType collection Indicates the threat types. The possible values are: unknown, spam, malware, phish, none, unknownFutureValue.
urls microsoft.graph.security.analyzedEmailUrl collection A collection of the URLs in the email.
urlsCount Int32 The number of URLs in the email.