List deleted items (directory objects) owned by a user

Namespace: microsoft.graph

Retrieve a list of recently deleted application and group objects owned by the specified user.

This API returns up to 1,000 deleted objects owned by the user, sorted by ID, and doesn't support pagination.

Permissions

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)	Group.Read.All, Group.ReadWrite.All
Delegated (personal Microsoft account)	Not supported.
Application	Group.Read.All, Group.ReadWrite.All

HTTP request

POST /directory/deletedItems/getUserOwnedObjects

Request headers

Name	Description
Authorization	Bearer {token}. Required.

Request body

The request body requires the following parameters:

Parameter	Type	Description
userId	String	ID of the owner.
type	String	Type of owned objects to return; Group and Application are currently the only supported values.

Response

Successful requests return 200 OK response codes; the response object includes directory (deleted items) properties.

Example

Request

Here is an example of the request.

HTTP

POST https://graph.microsoft.com/v1.0/directory/deletedItems/getUserOwnedObjects
Content-type: application/json

{
  "userId":"55ac777c-109e-4022-b58c-470c8fcb6892",
  "type":"Group"
}

C#

// Code snippets are only available for the latest version. Current version is 5.x

var graphClient = new GraphServiceClient(requestAdapter);

var requestBody = new Microsoft.Graph.DirectoryNamespace.DeletedItems.Item.DeletedItem
{
	AdditionalData = new Dictionary<string, object>
	{
		{
			"userId" , "55ac777c-109e-4022-b58c-470c8fcb6892"
		},
		{
			"type" , "Group"
		},
	},
};
await graphClient.Directory.DeletedItems["{directoryObject-id}"].PostAsync(requestBody);

For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.

Go

import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  graphmodels "github.com/microsoftgraph/msgraph-sdk-go/Directory/DeletedItems/Item"
	  //other-imports
)

graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)


requestBody := graphmodels.NewDeletedItem()
additionalData := map[string]interface{}{
	"userId" : "55ac777c-109e-4022-b58c-470c8fcb6892", 
	"type" : "Group", 
}
requestBody.SetAdditionalData(additionalData)

graphClient.Directory().DeletedItems().ByDeletedItemId("directoryObject-id").Post(context.Background(), requestBody, nil)

For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

const directoryObject = {
  userId: '55ac777c-109e-4022-b58c-470c8fcb6892',
  type: 'Group'
};

await client.api('/directory/deletedItems/getUserOwnedObjects')
	.post(directoryObject);

For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.

PHP

<?php

// THIS SNIPPET IS A PREVIEW FOR THE KIOTA BASED SDK. NON-PRODUCTION USE ONLY
$graphServiceClient = new GraphServiceClient($requestAdapter);

$requestBody = new DeletedItem();
$additionalData = [
		'userId' => '55ac777c-109e-4022-b58c-470c8fcb6892', 
		'type' => 'Group', 
];
$requestBody->setAdditionalData($additionalData);




$graphServiceClient->directory()->deletedItems()->byDeletedItemId('directoryObject-id')->post($requestBody);

For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.

Response

Here is an example of the response. Note: This response object may be truncated for brevity. All supported properties are returned from actual calls.

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

{
  "value": [
    {
      "@odata.type": "#microsoft.graph.group",
      "id": "bfa7033a-7367-4644-85f5-95aaf385cbd7",
      "deletedDateTime": "2018-04-01T12:39:16Z",
      "classification": null,
      "createdDateTime": "2017-03-22T12:39:16Z",
      "description": null,
      "displayName": "Test",
      "groupTypes": [
        "Unified"
      ],
      "mail": "Test@contoso.com",
      "mailEnabled": true,
      "mailNickname": "Test",
      "membershipRule": null,
      "membershipRuleProcessingState": null,
      "preferredDataLocation": null,
      "preferredLanguage": null,
      "proxyAddresses": [
        "SMTP:Test@contoso.com"
      ],
      "renewedDateTime": "2017-09-22T22:30:39Z",
      "securityEnabled": false,
      "theme": null,
      "visibility": "Public"
    }
  ]
}