retentionEventType resource type



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.

Represents a single group for the same type of retention events.

When a retention event is created, it is associated with a specific event type which in turn is associated with a retention label. Only content with that retention label applied will be retained for the specified retention period. For details, see Start retention when an event occurs.


Method Return type Description
List retentionEventTypes collection Get a list of the retentionEventType objects and their properties.
Create retentionEventType Create a new retentionEventType object.
Get retentionEventType Read the properties and relationships of a retentionEventType object.
Update retentionEventType Update the properties of a retentionEventType object.
Delete retentionEventType None Delete a retentionEventType object.


Property Type Description
createdBy microsoft.graph.identitySet The user who created the retentionEventType.
createdDateTime DateTimeOffset The date time when the retentionEventType was created.
description String Optional information about the event type.
displayName String Name of the event type.
id String Represents the unique ID of the user who created the retentionEventType. entity.
lastModifiedBy microsoft.graph.identitySet The user who last modified the retentionEventType.
lastModifiedDateTime DateTimeOffset The latest date time when the retentionEventType was modified.



JSON representation

The following is a JSON representation of the resource.

  "@odata.type": "",
  "id": "String (identifier)",
  "displayName": "String",
  "description": "String",
  "createdBy": {
    "@odata.type": "microsoft.graph.identitySet"
  "createdDateTime": "String (timestamp)",
  "lastModifiedBy": {
    "@odata.type": "microsoft.graph.identitySet"
  "lastModifiedDateTime": "String (timestamp)"