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
Developers and compliance administrators can use records management APIs to read the label
Employee_departure and look up the associated event type
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.
|Retention event||microsoft.graph.security.retentionEvent||Represents a trigger for event-based retention, where a retention period starts after the event occurs.|
|Retention event type||microsoft.graph.security.retentionEventType||Represents a single group for the same type of retention events.|