tencent cloud

Smart Media Hosting

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
DocumentationSmart Media HostingBusiness Level API DocumentHistorical Version Operations APIDeleting Earlier Versions

Deleting Earlier Versions

PDF
Focus Mode
Font Size
Last updated: 2026-01-07 14:28:02

Description

Used to delete earlier versions.
Note:
Required permissions: admin, space_admin, or delete_history. For details about the permissions, see Generate Access Token API.

Request

Request Example

POST /api/v1/directory-history/{LibraryId}/{SpaceId}/delete?access_token={AccessToken}

Request Parameter

Request parameters.
Description
Type
Required or Not
LibraryId
Media Library ID, obtained after creating a media library in the media hosting console. See Create Media Library
String
Yes
SpaceId
Space ID. If the media library is in single-tenant mode, this parameter is fixed as a hyphen (-); if the media library is in multi-tenant mode, you must specify this parameter.
String
Yes
AccessToken
Access token, see Generate Access Token
String
Yes

Request Body

application/json, collection of deleted HistoryId.
["1","2","3"]
Request body fields
Request parameters.
Description
Type
Required or Not
HistoryId
History version ID, at a time import up to 100 HistoryIds. To obtain them, see view historical versions list
String
Yes

Response

Response code

Successfully deleted. Return HTTP 204 No Content.

Response Body

This request has no response body.

Error Codes

This request operation has no special error messages. For common error messages, see Error Codes.
Previous Topic: Viewing Historical Versions ListNext Topic: Set the Historical Version to the Latest Version

Help and Support

Was this page helpful?

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

Feedback