Retrieve a file from the trash 

Retrieve a file from the recycle bin.

This method returns the Atom document of the file. If you want to retrieve a feed, see Getting a feed of the files in the recycle bin.

See Authenticating requests for information about how to authenticate the request. The requestor must have permission to access the specified file.

Table 1. Atom API request details

Method URI Output representation Description
GET /basic/api/userlibrary/{userid}/recyclebin/{document-id}/entry file Atom document Returns a file from the specified user's recycle bin.
GET /basic/api/myuserlibrary/recyclebin/{document-id}/entry file Atom document Returns a file from your recycle bin.

You can use this input parameters with the GET request.

Table 2. Input parameters

Parameter Description
acls Specifies whether or not the permissions for each user should be displayed for each entry in the returned Atom document. This parameter takes a Boolean value of either true or false. By default, the permission information is not returned.




An Atom entry document representing the file.

Returned HTTP headers

HTTP/1.1 200 OK

Content-Type: application/atom+xml

Error codes

Parent topic

Work with files in the trash