How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Microsoft Graph security.labelsRoot API

The security.labelsRoot API from Microsoft Graph — 32 operation(s) for security.labelsroot.

Microsoft Graph security.labelsRoot API is one of 564 APIs that Microsoft Graph publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 60 operations across 32 paths, and defines 41 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against a single base URL, https://graph.microsoft.com/v1.0.

60 operations 32 paths 41 schemas 10 DELETE32 GET10 PATCH8 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://graph.microsoft.com/v1.0
Resource Areas
1

Paths & Operations 60

Across 32 paths, the API surfaces 60 operations — 10 DELETE, 32 GET, 10 PATCH, 8 POST. Each is listed below with its method, path, parameters, and response codes.

security.labelsRoot 60
GET
/security/labels
Microsoft Graph Get labels from security
security.GetLabels 2 params → 2XX4XX5XX
PATCH
/security/labels
Microsoft Graph Update the navigation property labels in security
security.UpdateLabels body → 2XX4XX5XX
DELETE
/security/labels
Microsoft Graph Delete navigation property labels for security
security.DeleteLabels 1 param → 2044XX5XX
GET
/security/labels/authorities
Microsoft Graph List authorityTemplates
security.labels.ListAuthorities 8 params → 2XX4XX5XX
POST
/security/labels/authorities
Microsoft Graph Create authorityTemplate
security.labels.CreateAuthorities body → 2XX4XX5XX
GET
/security/labels/authorities/{authorityTemplate-id}
Microsoft Graph Get authorityTemplate
security.labels.GetAuthorities 3 params → 2XX4XX5XX
PATCH
/security/labels/authorities/{authorityTemplate-id}
Microsoft Graph Update the navigation property authorities in security
security.labels.UpdateAuthorities 1 param body → 2XX4XX5XX
DELETE
/security/labels/authorities/{authorityTemplate-id}
Microsoft Graph Delete authorityTemplate
security.labels.DeleteAuthorities 2 params → 2044XX5XX
GET
/security/labels/authorities/$count
Microsoft Graph Get the number of the resource
security.labels.authorities.GetCount-ecc0 2 params → 2XX4XX5XX
GET
/security/labels/categories
Microsoft Graph List categoryTemplates
security.labels.ListCategories 8 params → 2XX4XX5XX
POST
/security/labels/categories
Microsoft Graph Create categoryTemplate
security.labels.CreateCategories body → 2XX4XX5XX
GET
/security/labels/categories/{categoryTemplate-id}
Microsoft Graph Get categoryTemplate
security.labels.GetCategories 3 params → 2XX4XX5XX
PATCH
/security/labels/categories/{categoryTemplate-id}
Microsoft Graph Update the navigation property categories in security
security.labels.UpdateCategories 1 param body → 2XX4XX5XX
DELETE
/security/labels/categories/{categoryTemplate-id}
Microsoft Graph Delete categoryTemplate
security.labels.DeleteCategories 2 params → 2044XX5XX
GET
/security/labels/categories/{categoryTemplate-id}/subcategories
Microsoft Graph List subcategories
security.labels.categories.ListSubcategories 9 params → 2XX4XX5XX
POST
/security/labels/categories/{categoryTemplate-id}/subcategories
Microsoft Graph Create subcategoryTemplate
security.labels.categories.CreateSubcategories 1 param body → 2XX4XX5XX
GET
/security/labels/categories/{categoryTemplate-id}/subcategories/{subcategoryTemplate-id}
Microsoft Graph Get subcategoryTemplate
security.labels.categories.GetSubcategories 4 params → 2XX4XX5XX
PATCH
/security/labels/categories/{categoryTemplate-id}/subcategories/{subcategoryTemplate-id}
Microsoft Graph Update the navigation property subcategories in security
security.labels.categories.UpdateSubcategories 2 params body → 2XX4XX5XX
DELETE
/security/labels/categories/{categoryTemplate-id}/subcategories/{subcategoryTemplate-id}
Microsoft Graph Delete navigation property subcategories for security
security.labels.categories.DeleteSubcategories 3 params → 2044XX5XX
GET
/security/labels/categories/{categoryTemplate-id}/subcategories/$count
Microsoft Graph Get the number of the resource
security.labels.categories.subcategories.GetCount-ec6d 3 params → 2XX4XX5XX
GET
/security/labels/categories/$count
Microsoft Graph Get the number of the resource
security.labels.categories.GetCount-908b 2 params → 2XX4XX5XX
GET
/security/labels/citations
Microsoft Graph List citationTemplates
security.labels.ListCitations 8 params → 2XX4XX5XX
POST
/security/labels/citations
Microsoft Graph Create citationTemplate
security.labels.CreateCitations body → 2XX4XX5XX
GET
/security/labels/citations/{citationTemplate-id}
Microsoft Graph Get citationTemplate
security.labels.GetCitations 3 params → 2XX4XX5XX
PATCH
/security/labels/citations/{citationTemplate-id}
Microsoft Graph Update the navigation property citations in security
security.labels.UpdateCitations 1 param body → 2XX4XX5XX
DELETE
/security/labels/citations/{citationTemplate-id}
Microsoft Graph Delete citationTemplate
security.labels.DeleteCitations 2 params → 2044XX5XX
GET
/security/labels/citations/$count
Microsoft Graph Get the number of the resource
security.labels.citations.GetCount-15c2 2 params → 2XX4XX5XX
GET
/security/labels/departments
Microsoft Graph List departmentTemplates
security.labels.ListDepartments 8 params → 2XX4XX5XX
POST
/security/labels/departments
Microsoft Graph Create departmentTemplate
security.labels.CreateDepartments body → 2XX4XX5XX
GET
/security/labels/departments/{departmentTemplate-id}
Microsoft Graph Get departmentTemplate
security.labels.GetDepartments 3 params → 2XX4XX5XX
PATCH
/security/labels/departments/{departmentTemplate-id}
Microsoft Graph Update the navigation property departments in security
security.labels.UpdateDepartments 1 param body → 2XX4XX5XX
DELETE
/security/labels/departments/{departmentTemplate-id}
Microsoft Graph Delete departmentTemplate
security.labels.DeleteDepartments 2 params → 2044XX5XX
GET
/security/labels/departments/$count
Microsoft Graph Get the number of the resource
security.labels.departments.GetCount-b983 2 params → 2XX4XX5XX
GET
/security/labels/filePlanReferences
Microsoft Graph List filePlanReferenceTemplates
security.labels.ListFilePlanReferences 8 params → 2XX4XX5XX
POST
/security/labels/filePlanReferences
Microsoft Graph Create filePlanReferenceTemplate
security.labels.CreateFilePlanReferences body → 2XX4XX5XX
GET
/security/labels/filePlanReferences/{filePlanReferenceTemplate-id}
Microsoft Graph Get filePlanReferenceTemplate
security.labels.GetFilePlanReferences 3 params → 2XX4XX5XX
PATCH
/security/labels/filePlanReferences/{filePlanReferenceTemplate-id}
Microsoft Graph Update the navigation property filePlanReferences in security
security.labels.UpdateFilePlanReferences 1 param body → 2XX4XX5XX
DELETE
/security/labels/filePlanReferences/{filePlanReferenceTemplate-id}
Microsoft Graph Delete filePlanReferenceTemplate
security.labels.DeleteFilePlanReferences 2 params → 2044XX5XX
GET
/security/labels/filePlanReferences/$count
Microsoft Graph Get the number of the resource
security.labels.filePlanReferences.GetCount-3c22 2 params → 2XX4XX5XX
GET
/security/labels/retentionLabels
Microsoft Graph List retentionLabels
security.labels.ListRetentionLabels 8 params → 2XX4XX5XX
POST
/security/labels/retentionLabels
Microsoft Graph Create retentionLabel
security.labels.CreateRetentionLabels body → 2XX4XX5XX
GET
/security/labels/retentionLabels/{retentionLabel-id}
Microsoft Graph Get retentionLabels from security
security.labels.GetRetentionLabels 3 params → 2XX4XX5XX
PATCH
/security/labels/retentionLabels/{retentionLabel-id}
Microsoft Graph Update retentionLabel
security.labels.UpdateRetentionLabels 1 param body → 2XX4XX5XX
DELETE
/security/labels/retentionLabels/{retentionLabel-id}
Microsoft Graph Delete retentionLabel
security.labels.DeleteRetentionLabels 2 params → 2044XX5XX
GET
/security/labels/retentionLabels/{retentionLabel-id}/descriptors
Microsoft Graph Get descriptors from security
security.labels.retentionLabels.GetDescriptors 3 params → 2XX4XX5XX
PATCH
/security/labels/retentionLabels/{retentionLabel-id}/descriptors
Microsoft Graph Update the navigation property descriptors in security
security.labels.retentionLabels.UpdateDescriptors 1 param body → 2XX4XX5XX
DELETE
/security/labels/retentionLabels/{retentionLabel-id}/descriptors
Microsoft Graph Delete navigation property descriptors for security
security.labels.retentionLabels.DeleteDescriptors 2 params → 2044XX5XX
GET
/security/labels/retentionLabels/{retentionLabel-id}/descriptors/authorityTemplate
Microsoft Graph Get authorityTemplate from security
security.labels.retentionLabels.descriptors.GetAuthorityTemplate 3 params → 2XX4XX5XX
GET
/security/labels/retentionLabels/{retentionLabel-id}/descriptors/categoryTemplate
Microsoft Graph Get categoryTemplate from security
security.labels.retentionLabels.descriptors.GetCategoryTemplate 3 params → 2XX4XX5XX
GET
/security/labels/retentionLabels/{retentionLabel-id}/descriptors/citationTemplate
Microsoft Graph Get citationTemplate from security
security.labels.retentionLabels.descriptors.GetCitationTemplate 3 params → 2XX4XX5XX
GET
/security/labels/retentionLabels/{retentionLabel-id}/descriptors/departmentTemplate
Microsoft Graph Get departmentTemplate from security
security.labels.retentionLabels.descriptors.GetDepartmentTemplate 3 params → 2XX4XX5XX
GET
/security/labels/retentionLabels/{retentionLabel-id}/descriptors/filePlanReferenceTemplate
Microsoft Graph Get filePlanReferenceTemplate from security
security.labels.retentionLabels.descriptors.GetFilePlanReferenceTemplate 3 params → 2XX4XX5XX
GET
/security/labels/retentionLabels/{retentionLabel-id}/dispositionReviewStages
Microsoft Graph Get dispositionReviewStages from security
security.labels.retentionLabels.ListDispositionReviewStages 9 params → 2XX4XX5XX
POST
/security/labels/retentionLabels/{retentionLabel-id}/dispositionReviewStages
Microsoft Graph Create new navigation property to dispositionReviewStages for security
security.labels.retentionLabels.CreateDispositionReviewStages 1 param body → 2XX4XX5XX
GET
/security/labels/retentionLabels/{retentionLabel-id}/dispositionReviewStages/{dispositionReviewStage-stageNumber}
Microsoft Graph Get dispositionReviewStages from security
security.labels.retentionLabels.GetDispositionReviewStages 4 params → 2XX4XX5XX
PATCH
/security/labels/retentionLabels/{retentionLabel-id}/dispositionReviewStages/{dispositionReviewStage-stageNumber}
Microsoft Graph Update the navigation property dispositionReviewStages in security
security.labels.retentionLabels.UpdateDispositionReviewStages 2 params body → 2XX4XX5XX
DELETE
/security/labels/retentionLabels/{retentionLabel-id}/dispositionReviewStages/{dispositionReviewStage-stageNumber}
Microsoft Graph Delete navigation property dispositionReviewStages for security
security.labels.retentionLabels.DeleteDispositionReviewStages 3 params → 2044XX5XX
GET
/security/labels/retentionLabels/{retentionLabel-id}/dispositionReviewStages/$count
Microsoft Graph Get the number of the resource
security.labels.retentionLabels.dispositionReviewStages.GetCount-48b2 3 params → 2XX4XX5XX
GET
/security/labels/retentionLabels/{retentionLabel-id}/retentionEventType
Microsoft Graph Get retentionEventType from security
security.labels.retentionLabels.GetRetentionEventType 3 params → 2XX4XX5XX
GET
/security/labels/retentionLabels/$count
Microsoft Graph Get the number of the resource
security.labels.retentionLabels.GetCount-3249 2 params → 2XX4XX5XX

Schemas 41

The contract defines 41 schemas that model the data the API accepts and returns. The most detailed are microsoft.graph.ODataErrors.MainError (5 properties), microsoft.graph.identitySet (4 properties), microsoft.graph.ODataErrors.InnerError (4 properties), microsoft.graph.identity (3 properties). Each schema is shown below with its type and property counts.

ODataCountResponse
integer
microsoft.graph.ODataErrors.ErrorDetails
object
3 properties 2 required
microsoft.graph.security.filePlanReferenceTemplateCollectionResponse
object
microsoft.graph.security.filePlanAuthority
microsoft.graph.security.authorityTemplateCollectionResponse
object
microsoft.graph.security.departmentTemplateCollectionResponse
object
microsoft.graph.security.actionAfterRetentionPeriod
string
microsoft.graph.identity
object
3 properties 1 required
microsoft.graph.security.filePlanDepartment
microsoft.graph.security.citationTemplate
microsoft.graph.ODataErrors.InnerError
object
4 properties 1 required
microsoft.graph.security.filePlanDescriptor
microsoft.graph.security.retentionDuration
object
1 property 1 required
microsoft.graph.security.categoryTemplate
microsoft.graph.security.retentionLabelCollectionResponse
object
microsoft.graph.security.filePlanAppliedCategory
microsoft.graph.security.behaviorDuringRetentionPeriod
string
microsoft.graph.security.retentionEventType
microsoft.graph.security.filePlanCitation
microsoft.graph.security.departmentTemplate
microsoft.graph.security.defaultRecordBehavior
string
microsoft.graph.security.retentionLabel
microsoft.graph.security.filePlanSubcategory
microsoft.graph.security.filePlanReference
microsoft.graph.security.categoryTemplateCollectionResponse
object
microsoft.graph.security.authorityTemplate
microsoft.graph.security.labelsRoot
microsoft.graph.ODataErrors.MainError
object
5 properties 2 required
microsoft.graph.security.subcategoryTemplateCollectionResponse
object
microsoft.graph.security.filePlanReferenceTemplate
microsoft.graph.security.dispositionReviewStage
microsoft.graph.security.filePlanDescriptorBase
object
2 properties 1 required
microsoft.graph.security.filePlanDescriptorTemplate
microsoft.graph.security.subcategoryTemplate
microsoft.graph.security.dispositionReviewStageCollectionResponse
object
microsoft.graph.security.citationTemplateCollectionResponse
object
BaseCollectionPaginationCountResponse
object
2 properties
microsoft.graph.ODataErrors.ODataError
object
1 property 1 required
microsoft.graph.identitySet
object
4 properties 1 required
microsoft.graph.security.retentionTrigger
string
microsoft.graph.entity
object
2 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

microsoft-graph-security-labelsroot-api-openapi.yml Raw ↑

Other APIs Microsoft Graph publishes across the network.

Microsoft Graph Admin.admin API
Microsoft Graph admin.adminMicrosoft365Apps API
Microsoft Graph admin.adminReportSettings API
Microsoft Graph Admin Consent Policy API
Microsoft Graph Admin.edge API
Microsoft Graph admin.peopleAdminSettings API
Microsoft Graph admin.serviceAnnouncement API
Microsoft Graph Admin.sharepoint API
Microsoft Graph Administration API
Microsoft Graph Administrative Units API
Microsoft Graph Agreement Acceptances API
Microsoft Graph Agreement File Localizations API
Where this information came from

This is an independent, third-party profile of Microsoft Graph security.labelsRoot API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.