Skip to content

driveitem-restore.md

Latest commit

 

History

History
147 lines (106 loc) · 4.68 KB

driveitem-restore.md

File metadata and controls

147 lines (106 loc) · 4.68 KB
title driveItem: restore
description Restore a deleted driveItem that is currently in the recycle bin.
ms.localizationpriority medium
author learafa
ms.subservice onedrive
doc_type apiPageType
ms.date 04/04/2024

driveItem: restore

Namespace: microsoft.graph

Restore a deleted driveItem that is currently in the recycle bin.

Important

This functionality is currently only available for OneDrive Personal.

[!INCLUDE national-cloud-support]

Permissions

Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions only if your app requires it. For details about delegated and application permissions, see Permission types. To learn more about these permissions, see the permissions reference.

[!INCLUDE permissions-table]

HTTP request

POST /me/drive/items/{item-id}/restore

Request headers

Name Description
Authorization Bearer {token}. Required. Learn more about authentication and authorization.

Request body

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

Parameter Type Description
parentReference ItemReference Optional. Reference to the parent item the deleted item will be restored to.
name String Optional. The new name for the restored item. If this isn't provided, the same name will be used as the original.

Response

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

Examples

The following example shows how to call this API.

Request

The following example shows a request.

HTTP

POST https://graph.microsoft.com/v1.0/me/drive/items/{item-id}/restore
Content-type: application/json

{
  "parentReference": {
    "id": "String",
  },
  "name": "String"
}

C#

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Go

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Java

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

JavaScript

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

PHP

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

PowerShell

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Python

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Response

The following example shows the response.

Note: The response object shown here might be shortened for readability.

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

{
  "id": "1312abc!1231",
  "name": "new-restored-item-name.txt",
  "size": 19121,
  "lastModifiedDateTime": "2017-12-12T10:40:59Z"
}