groupLifecyclePolicy: removeGroup

Namespace: microsoft.graph

Removes a group from a lifecycle policy.


One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Permission type Permissions (from least to most privileged)
Delegated (work or school account) Directory.ReadWrite.All
Delegated (personal Microsoft account) Not supported.
Application Directory.ReadWrite.All

HTTP request

POST /groupLifecyclePolicies/{id}/removeGroup

Request headers

Name Description
Authorization Bearer {token}. Required.
Content-Type application/json

Request body

In the request body, provide a JSON object with the following parameters.

Parameter Type Description
groupId Guid The id of the group to remove from the policy.


If successful, this method returns 200 OK response code. If the group is removed from the policy, a true value is returned in the response body. Otherwise, a false value is returned in the reponse body.


Content-type: application/json
Content-length: 57

  "groupId": "ffffffff-ffff-ffff-ffff-ffffffffffff"
HTTP/1.1 200 OK
Content-type: application/json
Content-length: 21

  "value": true