Delete file version

DELETE

/file/version

Auth: JWT Optional

Delete a version from a file's version history.

Request

Authorization

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Query Params

uri

string

optional

URI of the target file.

Example:

cloudreve://my/copy.md

version

string

optional

ID of the version to set as "current version". The version blob must be linked to current file. List of available versions can be retrieved via Get file info.
The version cannot be the currrent version of the file.

Example:

9ewQi2

Header Params

X-Cr-Purchase-Ticket,string,false,1f63aa26-edc0-40ce-950a-cb4d4323158e,Can be used to authenticate to paid share links with a anonymous identity. The ticket value can be obtained after an anonymous user purchase a paid share link

string

optional

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request DELETE '/file/version?uri=cloudreve://my/copy.md&version=9ewQi2' \
--header 'X-Cr-Purchase-Ticket,string,false,1f63aa26-edc0-40ce-950a-cb4d4323158e,Can be used to authenticate to paid share links with a anonymous identity. The ticket value can be obtained after an anonymous user purchase a paid share link;'

Responses

🟢200Success

application/json

Body

code

integer

required

Response code.
0 - Success.

Default:

Example:

msg

string

optional

Human readable error message (if any).

error

string | null

optional

Internal error message, only visable in debug mode.

correlation_id

string <uuid> | null

optional

Correlation ID of the request. Only presented on failed reqeust.

Example:

b4351ecc-ee1a-4455-bc94-2c3dbcc58538

Example

{
    "code": 0,
    "msg": ""
}

Modified at 2025-06-10 08:29:29

Set file version

Create direct links