groupLifecyclePolicy resource type

Namespace: microsoft.graph


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 lifecycle policy for a Microsoft 365 group. A group lifecycle policy allows administrators to set an expiration period for groups. For example, after 180 days, a group expires. When a group reaches its expiration, owners of the group are required to renew their group within a time interval defined by the administrator.

  • Once renewed, the group expiration is extended by the number of days defined in the policy and the group's expirationDateTime property defines the new expiration date.
  • If the group is not renewed, it expires and is deleted. The group can be restored within a period of 30 days from deletion.


Method Return Type Description
Get groupLifecyclePolicy groupLifecyclePolicy Read properties and relationships of a groupLifecyclePolicy object.
List groupLifecyclePolicies groupLifecyclePolicy collection List all the groupLifecyclePolicies.
Update groupLifecyclePolicy groupLifecyclePolicy Update a groupLifecyclePolicy object.
Delete groupLifecyclePolicy None Delete a groupLifecyclePolicy object.
Add a group to a groupLifecyclePolicy None Add a group to a lifecycle policy
Remove a group from a groupLifecyclePolicy None Remove a group to a lifecycle policy.
Renew a group None Renew a group's expiration date.


Property Type Description
alternateNotificationEmails String List of email address to send notifications for groups without owners. Multiple email address can be defined by separating email address with a semicolon.
groupLifetimeInDays Int32 Number of days before a group expires and needs to be renewed. Once renewed, the group expiration is extended by the number of days defined.
id String A unique identifier for a policy. Read-only.
managedGroupTypes String The group type for which the expiration policy applies. Possible values are All, Selected or None.



JSON representation

Here is a JSON representation of the resource.

  "alternateNotificationEmails": "String",
  "groupLifetimeInDays": 180,
  "id": "String (identifier)",
  "managedGroupTypes": "String"