Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Namespace: microsoft.graph
Caution
The recent API is deprecated and will stop returning data after November, 2027.
List a set of items recently used by the signed-in user. This collection includes items that are in the user's drive and items they have access to from other drives.
This API is available in the following national cloud deployments.
| Global service | US Government L4 | US Government L5 (DOD) | China operated by 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
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.
| Permission type | Least privileged permissions | Higher privileged permissions |
|---|---|---|
| Delegated (work or school account) | Files.Read | Files.Read.All, Files.ReadWrite, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All |
| Delegated (personal Microsoft account) | Files.Read | Files.Read.All, Files.ReadWrite, Files.ReadWrite.All |
| Application | Not supported. | Not supported. |
HTTP request
GET /me/drive/recent
Request headers
| Name | Description |
|---|---|
| Authorization | Bearer {token}. Required. Learn more about authentication and authorization. |
Response
This method returns a collection of DriveItem resources for items that the owner of the drive has recently accessed.
Examples
Request
GET /me/drive/recent
Response
HTTP/1.1 200 OK
Content-Type: application/json
{
"value": [
{
"id": "1312abc!1231",
"remoteItem":
{
"id": "1991210caf!192",
"name": "March Proposal.docx",
"file": { },
"size": 19121,
"parentReference": {
"driveId": "1991210caf",
"id": "1991210caf!104"
}
},
"fileSystemInfo": {
"lastAccessedDateTime": "2017-02-20T19:13:00Z"
}
},
{
"id": "1312def!9943",
"name": "Vacation.jpg",
"file": { },
"size": 37810,
"parentReference": {
"driveId": "1312def",
"id": "1312def!123"
},
"fileSystemInfo": {
"lastAccessedDateTime": "2017-02-20T16:43:21Z"
}
}
]
}
Remarks
Some driveItems returned from the recent action includes the remoteItem facet that indicates that items are from another drive. To access the original driveItem object, you need to make a request using the information provided in remoteItem in the following format:
GET /drives/{remoteItem-driveId}/items/{remoteItem-id}