ESC
Type to search...

RecordsManagement.Read.All

Export JSON
Export CSV
Copy URL
Print
ApplicationDelegated Full Control All Resources

Allows the application to read any data from Records Management, such as configuration, labels, and policies without the signed in user.

Permission data: April 6, 2026 at 4:06 AM UTC
Delegated Access App-Only Access

Permission Details

Application Permission

Read Records Management configuration, labels and policies

Allows the application to read any data from Records Management, such as configuration, labels, and policies without the signed in user.

Delegated Permission Admin consent required

Read Records Management configuration, labels, and policies

Allows the application to read any data from Records Management, such as configuration, labels, and policies on behalf of the signed-in user.

Properties

Microsoft Graph v1.0 endpoint-derived-docs

Properties is shown from stable Microsoft Graph v1.0 metadata.

Property Type Description
alerts alert collection
alerts_v2 security.alert collection A collection of alerts in Microsoft 365 Defender.
attackSimulation object
cases object
dataSecurityAndGovernance object
id string The unique identifier for an entity. Read-only.
identities object A container for security identities APIs.
incidents security.incident collection A collection of incidents in Microsoft 365 Defender, each of which is a set of correlated alerts and associated metadata that reflects the story of an attack.
labels object
secureScoreControlProfiles secureScoreControlProfile collection
secureScores secureScore collection
subjectRightsRequests subjectRightsRequest collection
threatIntelligence object
triggers object
triggerTypes object

JSON Representation

Microsoft Graph v1.0 endpoint-derived-docs

JSON representation is shown from stable Microsoft Graph v1.0 metadata.

JSON representation
{}

Relationships

Microsoft Graph v1.0 endpoint-derived-docs

Relationships is shown from stable Microsoft Graph v1.0 metadata.

Relationship Type Description
alerts alert collection Read-only. Nullable.
alertsv2 security.alert collection A collection of alerts in Microsoft 365 Defender.
data security and compliance tenantDataSecurityAndGovernance A container for Microsoft Purview data security and compliance APIs.
identities security.identityContainer A container for security identities APIs.
incidents security.incident collection A collection of incidents in Microsoft 365 Defender, each of which is a set of correlated alerts and associated metadata that reflects the story of an attack.
alerts_v2 security.alert collection A collection of alerts in Microsoft 365 Defender.
secureScoreControlProfiles secureScoreControlProfile collection Related secureScoreControlProfiles data exposed by this resource.
secureScores secureScore collection Related secureScores data exposed by this resource.
subjectRightsRequests subjectRightsRequest collection Related subjectRightsRequests data exposed by this resource.
cloudAppSecurityProfiles cloudAppSecurityProfile collection Related cloudAppSecurityProfiles data exposed by this resource.
domainSecurityProfiles domainSecurityProfile collection Related domainSecurityProfiles data exposed by this resource.
fileSecurityProfiles fileSecurityProfile collection Related fileSecurityProfiles data exposed by this resource.
hostSecurityProfiles hostSecurityProfile collection Related hostSecurityProfiles data exposed by this resource.
incidentTasks security.incidentTask collection A collection of tasks associated with security incidents.
ipSecurityProfiles ipSecurityProfile collection Related ipSecurityProfiles data exposed by this resource.
providerTenantSettings providerTenantSetting collection Related providerTenantSettings data exposed by this resource.
securityActions securityAction collection Related securityActions data exposed by this resource.
tiIndicators tiIndicator collection Related tiIndicators data exposed by this resource.
userSecurityProfiles userSecurityProfile collection Related userSecurityProfiles data exposed by this resource.
zones security.zone collection A collection of cloud zones in Microsoft Defender for Cloud that group and manage cloud environments across multiple cloud providers.

Graph Methods

Delegated access App-only access
Exact Microsoft Learn match

Microsoft Graph v1.0 endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

Methods
GET /security/labels/authorities
GET /security/labels/authorities/{authorityTemplateId}
GET /security/labels/categories
GET /security/labels/categories/{categoryTemplateId}
GET /security/labels/categories/{categoryTemplateId}/subcategories
GET /security/labels/categories/{categoryTemplateId}/subcategories/{subcategoryTemplateId}
GET /security/labels/citations
GET /security/labels/citations/{citationTemplateId}
GET /security/labels/departments
GET /security/labels/departments/{departmentTemplateId}
GET /security/labels/filePlanReferences
GET /security/labels/filePlanReferences/{filePlanReferenceTemplateId}
GET /security/labels/retentionLabels
GET /security/labels/retentionLabels/{retentionLabelId}
GET /security/labels/retentionLabels/{retentionLabelId}/descriptors/authorityTemplate
GET /security/labels/retentionLabels/{retentionLabelId}/descriptors/categoryTemplate
GET /security/labels/retentionLabels/{retentionLabelId}/descriptors/citationTemplate
GET /security/labels/retentionLabels/{retentionLabelId}/descriptors/departmentTemplate
GET /security/labels/retentionLabels/{retentionLabelId}/descriptors/filePlanReferenceTemplate
GET /security/labels/retentionLabels/{retentionLabelId}/eventType
GET /security/triggers/retentionEvents
GET /security/triggers/retentionEvents/{retentionEventId}
GET /security/triggers/retentionEvents/{retentionEventId}/labels/{retentionLabelId}
GET /security/triggers/retentionEvents/{retentionEventId}/retentionEventType
GET /security/triggerTypes/retentionEventTypes
GET /security/triggerTypes/retentionEventTypes/{retentionEventTypeId}
Exact Microsoft Learn match

Microsoft Graph beta endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

Methods
GET /security/labels/authorities
GET /security/labels/authorities/{authorityTemplateId}
GET /security/labels/categories
GET /security/labels/categories/{categoryTemplateId}
GET /security/labels/categories/{categoryTemplateId}/subcategories
GET /security/labels/categories/{categoryTemplateId}/subcategories/{subcategoryTemplateId}
GET /security/labels/citations
GET /security/labels/citations/{citationTemplateId}
GET /security/labels/departments
GET /security/labels/departments/{departmentTemplateId}
GET /security/labels/filePlanReferences
GET /security/labels/filePlanReferences/{filePlanReferenceTemplateId}
GET /security/labels/retentionLabels
GET /security/labels/retentionLabels/{retentionLabelId}
GET /security/labels/retentionLabels/{retentionLabelId}/descriptors/authorityTemplate
GET /security/labels/retentionLabels/{retentionLabelId}/descriptors/categoryTemplate
GET /security/labels/retentionLabels/{retentionLabelId}/descriptors/citationTemplate
GET /security/labels/retentionLabels/{retentionLabelId}/descriptors/departmentTemplate
GET /security/labels/retentionLabels/{retentionLabelId}/descriptors/filePlanReferenceTemplate
GET /security/labels/retentionLabels/{retentionLabelId}/eventType
GET /security/triggers/retentionEvents
GET /security/triggers/retentionEvents/{retentionEventId}
GET /security/triggers/retentionEvents/{retentionEventId}/labels/{retentionLabelId}
GET /security/triggers/retentionEvents/{retentionEventId}/retentionEventType
GET /security/triggerTypes/retentionEventTypes
GET /security/triggerTypes/retentionEventTypes/{retentionEventTypeId}
Exact Microsoft Learn PowerShell match

Microsoft Graph PowerShell v1.0 commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.

Commands
Get-MgSecurityLabelAuthority /security/labels/authorities
List authorityTemplates
Get-MgSecurityLabelAuthority /security/labels/authorities/{authorityTemplateId}
Get authorityTemplate
Get-MgSecurityLabelCategory /security/labels/categories
List categoryTemplates
Get-MgSecurityLabelCategory /security/labels/categories/{categoryTemplateId}
Get categoryTemplate
Get-MgSecurityLabelCategorySubcategory /security/labels/categories/{categoryTemplateId}/subcategories
List subcategories
Get-MgSecurityLabelCategorySubcategory /security/labels/categories/{categoryTemplateId}/subcategories/{subcategoryTemplateId}
Get subcategoryTemplate
Get-MgSecurityLabelCitation /security/labels/citations
List citationTemplates
Get-MgSecurityLabelCitation /security/labels/citations/{citationTemplateId}
Get citationTemplate
Get-MgSecurityLabelDepartment /security/labels/departments
List departmentTemplates
Get-MgSecurityLabelDepartment /security/labels/departments/{departmentTemplateId}
Get departmentTemplate
Get-MgSecurityLabelFilePlanReference /security/labels/filePlanReferences
List filePlanReferenceTemplates
Get-MgSecurityLabelFilePlanReference /security/labels/filePlanReferences/{filePlanReferenceTemplateId}
Get filePlanReferenceTemplate
Get-MgSecurityLabelRetentionLabel /security/labels/retentionLabels
List retentionLabels
Get-MgSecurityLabelRetentionLabel /security/labels/retentionLabels/{retentionLabelId}
Get retentionLabel
Get-MgSecurityTriggerRetentionEvent /security/triggers/retentionEvents
List retentionEvents
Get-MgSecurityTriggerRetentionEvent /security/triggers/retentionEvents/{retentionEventId}
Get retentionEvent
Get-MgSecurityTriggerTypeRetentionEventType /security/labels/retentionLabels/{retentionLabelId}/eventType
Get retentionEventType
Get-MgSecurityTriggerTypeRetentionEventType /security/triggerTypes/retentionEventTypes
List retentionEventTypes
Exact Microsoft Learn PowerShell match

Microsoft Graph PowerShell beta commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.

Commands
Get-MgBetaSecurityLabelAuthority /security/labels/authorities
List authorityTemplates
Get-MgBetaSecurityLabelAuthority /security/labels/authorities/{authorityTemplateId}
Get authorityTemplate
Get-MgBetaSecurityLabelCategory /security/labels/categories
List categoryTemplates
Get-MgBetaSecurityLabelCategory /security/labels/categories/{categoryTemplateId}
Get categoryTemplate
Get-MgBetaSecurityLabelCategorySubcategory /security/labels/categories/{categoryTemplateId}/subcategories
List subcategories
Get-MgBetaSecurityLabelCategorySubcategory /security/labels/categories/{categoryTemplateId}/subcategories/{subcategoryTemplateId}
Get subcategoryTemplate
Get-MgBetaSecurityLabelCitation /security/labels/citations
List citationTemplates
Get-MgBetaSecurityLabelCitation /security/labels/citations/{citationTemplateId}
Get citationTemplate
Get-MgBetaSecurityLabelDepartment /security/labels/departments
List departmentTemplates
Get-MgBetaSecurityLabelDepartment /security/labels/departments/{departmentTemplateId}
Get departmentTemplate
Get-MgBetaSecurityLabelFilePlanReference /security/labels/filePlanReferences
List filePlanReferenceTemplates
Get-MgBetaSecurityLabelFilePlanReference /security/labels/filePlanReferences/{filePlanReferenceTemplateId}
Get filePlanReferenceTemplate
Get-MgBetaSecurityLabelRetentionLabel /security/labels/retentionLabels
List retentionLabels
Get-MgBetaSecurityLabelRetentionLabel /security/labels/retentionLabels/{retentionLabelId}
Get retentionLabel
Get-MgBetaSecurityTriggerRetentionEvent /security/triggers/retentionEvents
List retentionEvents
Get-MgBetaSecurityTriggerRetentionEvent /security/triggers/retentionEvents/{retentionEventId}
Get retentionEvent
Get-MgBetaSecurityTriggerTypeRetentionEventType /security/labels/retentionLabels/{retentionLabelId}/eventType
Get retentionEventType
Get-MgBetaSecurityTriggerTypeRetentionEventType /security/triggerTypes/retentionEventTypes
List retentionEventTypes

Code Examples

C# / .NET SDK
Get authorityTemplate
// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Security.Labels.Authorities["{authorityTemplate-id}"].GetAsync();
JavaScript
Get authorityTemplate
const options = {
	authProvider,
};

const client = Client.init(options);

let authorityTemplate = await client.api('/security/labels/authorities/a94af2e3-853b-6fcc-c898-d61d3a6d9efc')
	.get();
PowerShell
Get authorityTemplate
Import-Module Microsoft.Graph.Security

Get-MgSecurityLabelAuthority -AuthorityTemplateId $authorityTemplateId
Python
Get authorityTemplate
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

result = await graph_client.security.labels.authorities.by_authority_template_id('authorityTemplate-id').get()

App Registration

1

Navigate to Azure Portal

Go to App registrations in Microsoft Entra admin center

2

Add API Permission

Select your app → API permissions → Add a permission → Microsoft Graph

3

Select Permission Type

Choose Application permissions or delegated permissions and search for RecordsManagement.Read.All

4

Grant Admin Consent

Application permissions always require admin consent.