Restore deleted item

Restores a recently deleted item from deleted items.

Currently, deleted items functionality is only supported for the group resource. If a group was accidentally deleted, you can fully restore the group including memberships and data.

A recently deleted group will remain available for up to 30 days. After 30 days, the group is permanently deleted.


The following scope is required to execute this API: Group.ReadWrite.All

HTTP request

POST /directory/deleteditems/{id}/restore

Request headers

Name Description
Authorization Bearer <code> Required
Accept application/json

Request body

Do not supply a request body for this method.


If successful, this method returns 200 OK response code and directoryObject object in the response body.



In the request body, supply a JSON representation of directoryObject object.


Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

HTTP/1.1 200 OK
Content-type: application/json