Use the Microsoft Graph records management APIs


APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

The Microsoft Purview Records Management APIs help organizations manage retention and deletion of data to meet their legal obligations and compliance regulations. The APIs increase efficiency by enabling the regular disposition of items that no longer have to be retained.

The records management solution is a part of the Microsoft Purview compliance portal.

Trigger events for an existing label

When an employee leaves a company, information is updated in the HR management system. From the leave date, confidential documents need to be retained for a period for seven years. These documents have the label Employee_departure applied.

Developers and compliance administrators can use records management APIs to read the label Employee_departure and look up the associated event type Event-employee_departure.

Compliance admins can use records management APIs to create an event for the associated event type. The retention period for the confidential documents starts after the creation of this event.


The records management API includes the following key entities.

Name Type Use case
Retention event Represents a trigger for event-based retention, where a retention period starts after the event occurs.
Retention event type Represents a single group for the same type of retention events.