Skip to Content

MC415900: Microsoft Purview | Data Lifecycle Management and Records Management – Microsoft Graph APIs for extensibility (preview)

As a part of our extensibility vision and first release to Microsoft Graph, we are introducing three new APIs for retention labels, events, and event types in the Microsoft Graph beta environment. These APIs will enable you to customize and extend on what we have built in the product so far.

These APIs can be used by compliance admins and developers to manage retention labels in Data Lifecycle and Records Management solutions.

This message is associated with Microsoft 365 Roadmap ID 88276.

The first release of Graph APIs for Microsoft Purview Data Lifecycle Management will enable organizations to create and manage retention labels, events, and event types for event-based retention.

MC415900: Microsoft Purview | Data Lifecycle Management and Records Management – Microsoft Graph APIs for extensibility (preview)

When this will happen

The APIs began rollout to the Microsoft Graph beta environment in mid-July and are now available in preview.

How this will affect your organization

If your organization needs to automate any operation related to retention labels or events, we recommend you achieve this by using the new Graph APIs instead of using PowerShell cmdlets. With Graph, we use REST APIs that support better security, extensibility, and app authentication features.

The three APIs are available under the security node and the endpoints to access them are as follows:

Entity name Endpoints Solution
Labels security/labels/retentionLabels Data Lifecycle Management, Records Management
Events security/triggers/retentionEvents Records Management
Event types security/triggerTypes/retentionEventTypes Records Management

What you need to do to prepare:


Currently, these APIs are supported through delegated permissions only, which are managed through the Graph interface. We are introducing two new permissions which you will need to access these APIs:

  • recordsmanagement.readwrite.all


Access to Data Lifecycle Management and Records Management features varies based on your Microsoft 365 license level. See Microsoft 365 guidance for security & compliance – Service Descriptions | Microsoft Docs for licensing requirement details.

You can find the Data Lifecycle and Records Management solutions in the Microsoft Purview compliance portal.

Learn more

Message ID: MC415900
Published: 19 August 2022
Updated: 19 August 2022
Platform: Developer, US Instances, Web, World tenant

Alex Lim is a certified IT Technical Support Architect with over 15 years of experience in designing, implementing, and troubleshooting complex IT systems and networks. He has worked for leading IT companies, such as Microsoft, IBM, and Cisco, providing technical support and solutions to clients across various industries and sectors. Alex has a bachelor’s degree in computer science from the National University of Singapore and a master’s degree in information security from the Massachusetts Institute of Technology. He is also the author of several best-selling books on IT technical support, such as The IT Technical Support Handbook and Troubleshooting IT Systems and Networks. Alex lives in Bandar, Johore, Malaysia with his wife and two chilrdren. You can reach him at [email protected] or follow him on Website | Twitter | Facebook

    Ads Blocker Image Powered by Code Help Pro

    Your Support Matters...

    We run an independent site that is committed to delivering valuable content, but it comes with its challenges. Many of our readers use ad blockers, causing our advertising revenue to decline. Unlike some websites, we have not implemented paywalls to restrict access. Your support can make a significant difference. If you find this website useful and choose to support us, it would greatly secure our future. We appreciate your help. If you are currently using an ad blocker, please consider disabling it for our site. Thank you for your understanding and support.