Use the Microsoft Graph records management APIs

Important

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.

Entities

The records management API includes the following key entities.

Name	Type	Use case
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.