Get deleted item
Retrieve the properties of a recently deleted item in deleted items.
Currently, deleted items functionality is only supported for the application, group and user resources.
Permissions
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.
For applications:
Permission type | Permissions (from least to most privileged) |
---|---|
Delegated (work or school account) | Directory.Read.All, Directory.ReadWrite.All, Directory.AccessAsUser.All |
Delegated (personal Microsoft account) | Not supported. |
Application | Application.ReadWrite.OwnedBy, Application.ReadWrite.All, Directory.Read.All |
For users:
Permission type | Permissions (from least to most privileged) |
---|---|
Delegated (work or school account) | User.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All, Directory AccessAsUser.All |
Delegated (personal Microsoft account) | Not supported. |
Application | User.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All |
For groups:
Permission type | Permissions (from least to most privileged) |
---|---|
Delegated (work or school account) | Group.Read.All, Group.ReadWrite.All, Directory.Read.All, Directory.AccessAsUser.All |
Delegated (personal Microsoft account) | Not supported. |
Application | Group.Read.All, Group.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All |
HTTP request
GET /directory/deletedItems/{id}
Optional query parameters
This method supports the OData Query Parameters to help customize the response.
Request headers
Name | Description |
---|---|
Authorization | Bearer <code> Required |
Accept | application/json |
Request body
Do not supply a request body for this method.
Response
If successful, this method returns a 200 OK
response code and directoryObject object in the response body.
Example
Request
GET https://graph.microsoft.com/v1.0/directory/deletedItems/{object-id}
Response
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
{
"@odata.context":"https://graph.microsoft.com/v1.0/$metadata#directoryObjects/$entity",
"id":"46cc6179-19d0-473e-97ad-6ff84347bbbb",
"displayName":"SampleGroup",
"groupTypes":["Unified"],
"mail":"example@contoso.com",
"mailEnabled":true,
"mailNickname":"Example",
"securityEnabled":false,
"visibility":"Public"
}
Feedback
Loading feedback...