Product Introduction

Product Overview

Feature Description

Product Strengths

Use Cases

Basic Concept

Purchase Guide

Quick Start

Create Media Library

Initiate request

Service Level API Document

History

Introduction

API Category

Making API Requests

PaaS Service APIs

Official Cloud Disk APIs

Data Types

Error Codes

Business Level API Document

Introduction

Access Token Operation API

Tenant Space Operation API

File Operation API

Directory or Album Operation API

Recycle Bin Operation API

Quota Operation API

Query Task Operation API

Search Operation API

Historical Version Operations API

Directory and File Batch Operation API

Collection Operation API

Error Codes

SDK Documentation

Android SDK

iOS SDK

HarmonyOS SDK

FAQs

Enterprise Network Disk

Product Introduction

Purchase Guide

Quick Start

FAQs

Service Level Agreement

Glossary

Listing Recycle Bin Projects

PDF

Focus Mode

Font Size

Last updated: 2026-01-07 14:27:56

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.

Help and Support

Was this page helpful?

You can also Contact sales or Submit a Ticket for help.

Help us improve! Rate your documentation experience in 5 mins.

Feedback

tencent cloud

Smart Media Hosting

Listing Recycle Bin Projects

Description

Request

Request Example

Request Parameter

Request Body

Response

Response code

Response Body

Error Codes

Help and Support

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

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

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