tencent cloud

Listing Recycle Bin Projects
Download PDF
Last updated: 2026-01-07 14:27:56
Listing Recycle Bin Projects
Last updated: 2026-01-07 14:27:56
Download PDF

Description

List projects in the recycle bin.
Note:
The listing order of directory contents is unsorted by default, and the sorting order is determined by the parameters orderBy and orderByType.

Request

Request Example

GET /api/v1/recycled/{LibraryId}/{SpaceId}?page={Page}&page_size={PageSize}&order_by={OrderBy}&order_by_type={OrderByType}&access_token={AccessToken}&user_id={UserId}

Request Parameter

Request parameters.
Description
Type
Required or Not
LibraryId
Media Library ID, obtain it after creating a media library in the media hosting console. Please refer to Create Media Library
String
Yes
SpaceId
Space ID. If the media library is in single-tenant mode, this parameter is fixed as hyphen (`-`). If the media library is in multi-tenant mode, you must specify this parameter. Please refer to Create Tenant Space
String
No
Marker
Identification for sequential listing with pagination, cannot be used with page and page_size parameters simultaneously
String
No
Limit
Limit for locally listed items when sequentially listing with pagination, cannot be used with page and page_size parameters simultaneously
String
No
Page
Pagination code, default first page, cannot be used with marker and limit parameters simultaneously
String
No
PageSize
Page size, default 20, range [0,1000], cannot be used with marker and limit parameters simultaneously
String
No
OrderBy
Sorting field: name for sort by name, modificationTime for sort by modification time, size for sort by file size, removalTime for sort by deletion time, remainingTime for sort by remaining time
String
No
OrderByType
Sorting method: asc for ascending, desc for descending
String
No
AccessToken
Access token. For Public Read Media Library or tenant space, this parameter is not specified. Otherwise, you must specify this parameter. Please refer to Generate Access Token
String
No
UserId
User identity recognition. When the access token has admin permission and the user identity recognition during token application is empty, it is used to temporarily specify user identity. For details, see Generate Access Token API
String
No

Request Body

This request does not have a request body.

Response

Response code

Successful retrieval, returns HTTP 200 OK.

Response Body

application/json
Response body example:

{
    "totalNum":34562,
    "nextMarker": 1013,
    "contents": [
        {
            "recycledItemId": 312,
            "originalPath": [ "initialize image2.jpg" ],
            "spaceId": "spaceXXX",
            "size": "3178496",
            "previewByDoc": true,
            "previewByCI": true,
            "previewAsIcon": true,
            "fileType": "powerpoint",
            "name": "initialize image2.jpg",
            "type": "file",
            "creationTime": "2021-03-25T10:08:05.000Z",
            "modificationTime": "2021-07-15T12:48:07.000Z",
            "removalTime": "2021-07-16T07:15:36.000Z",
            "remainingTime": 90,
            "authorityList":{
                "canRestore": true,
                "canDelete": true
            },
            "authorityButtonList":{            
                "showViewButton": false,
                "showPreviewButton": false,
                "showDownloadButton": false,
                "showUploadButton": false,
                "showDeleteButton": true,
                "showAuthorizeButton": false,
                "showShareButton": false,
                "showModifyButton": false,
                "showRestoreButton": true
            }
        }
    ]
}
Field description in the response body:
Response Parameters
Description
Type
totalNum
Total number of files and folders in the recycle bin
Int
nextMarker
Sequence identifier for paginated listing
String/Int
contents
Specific content in the directory or album
Array
Specific content in contents:
Parameter
Description
Type
recycledItemId
Recycle Bin id
Number
originalPath
original path
Array
spaceId
Space ID
String
size
File size.
String
previewByDoc
whether WPS can preview
Boolean
previewByCI
whether Wanxiang can preview
Boolean
previewAsIcon
whether the preview image can be used as an icon
Boolean
fileType
File type: Excel, PowerPoint
String
name
Directory or album name or file name
String
spaceId
Space Id
String
type
Entry type:
dir: directory or album
file: file, only used for file type media library
image: image, only used for media type media library
video: video, only used for media type media library
String
creationTime
Indicates the creation time of a directory or album, or the upload time of a file, such as 2020-10-14T10:17:57.953Z
String
modificationTime
Indicates the modification time of a directory or album, such as 2020-10-14T10:17:57.953Z
String
removalTime
Indicates the deletion time of a directory or album, such as 2020-10-14T10:17:57.953Z
String
remainingTime
remaining days, partial days not included
Number
authorityList
Permission to allow operations
Array
authorityButtonList
Permission to allow operations button
Array
authorityList includes the following parameters:
Parameter
Description
Type
canRestore
Resolved
Boolean
canDelete
Can be deleted
Boolean
authorityButtonList includes the following parameters:
Parameter
Description
Type
showViewButton
Show View Button
Boolean
showPreviewButton
Show Preview Button
Boolean
showDownloadButton
Show Download Button
Boolean
showUploadButton
Show Upload Button
Boolean
showDeleteButton
Show Delete Button
Boolean
showAuthorizeButton
Show Authorization Button
Boolean
showShareButton
Show Share Button
Boolean
showModifyButton
Show Modify Button
Boolean
showRestoreButton
Show Recovery Button
Boolean

Error Codes

This request operation has no special error messages. For common error messages, see Error Codes.
Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No

Feedback