| title | driveItem: unarchive |
|---|---|
| description | Unarchive a drive item |
| author | dcun55 |
| ms.date | 01/20/2026 |
| ms.localizationpriority | medium |
| ms.subservice | sharepoint |
| doc_type | apiPageType |
Namespace: microsoft.graph
[!INCLUDE beta-disclaimer]
Unarchive a driveItem.
When unarchiving a single recently archived file, the file is unarchived immediately. Otherwise, the archived file starts the reactivation process.
Note
Unarchiving a driveItem file is not supported when the request includes the Prefer: respond-async header.
When unarchiving a folder using an asynchronous request, a monitor URL is returned in the response. Use the monitor URL to track progress until the operation completes.
Note
Unarchiving a driveItem folder is supported only when the request includes the Prefer: respond-async header
[!INCLUDE national-cloud-support]
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]
POST /drive/root/unarchive
POST /drives/{drivesId}/root/unarchive
POST /shares/{sharesId}/root/unarchive
POST /drives/{drivesId}/items/{driveItemId}/unarchive
POST /drive/items/{driveItemId}/unarchive
POST /shares/{sharesId}/driveItem/unarchive
POST /drive/bundles/{driveItemId}/unarchive
POST /drive/special/{driveItemId}/unarchive
POST /drive/following/{driveItemId}/unarchive| Name | Description |
|---|---|
| Authorization | Bearer {token}. Required. Learn more about authentication and authorization. |
| Prefer | respond-async. Indicates that the request is an async request. Optional. |
Don't supply a request body for this method.
If successful, this action returns a 200 OK response code for a driveItem file. The response body will include the driveItem’s metadata, with the archiveStatus property included under the FileFacet.
Otherwise, if successful, this action returns a 202 Accepted response code, with a monitor URI, for a driveItem folder.
The following example shows a request.
POST https://graph.microsoft.com/beta/drives/b!fMInbiL5dkK51VbATG0ddrCg6AJpEj9Lm4uGj5HgEi4guyuYp4W5SbH4dPfXTbCF/items/014Y52UITTNSVUQI43PZBJMKLAY6LJBUVE/unarchive[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
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
{
"file": {
"archiveStatus": "reactivating",
"hashes": {
"quickXorHash": "Sy2meSLBupGTGjRSLAv3LPpWqwo="
},
"mimeType": "text/plain"
}
}The following example shows a request.
POST https://graph.microsoft.com/beta/drives/b!fMInbiL5dkK51VbATG0ddrCg6AJpEj9Lm4uGj5HgEi4guyuYp4W5SbH4dPfXTbCF/items/014Y52UITTNSVUQI43PZBJMKLAY6LJBUVE/unarchive
Prefer: respond-async[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
The following example shows the response.
Note: The response object shown here might be shortened for readability.
HTTP/1.1 202 Accepted
Location: https://graph.microsoft.com/monitor/4A3407B5-88FC-4504-8B21-0AABD3412717