Restore from trash bin

POST

/file/restore

Auth: JWT Required

Restore deleted files in trash bin to its original location.

Request

Authorization

Add the parameter

Authorization

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

Example:

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

Body Params application/json

uris

array[string]

required

List of URI of the target files. Filesystem must be trash.

Example

{
    "uris": [
        "cloudreve://trash/ab470e1a-31dc-4794-b749-1a453d7837b2",
        "cloudreve://trash/46ef00c1-d489-43df-a717-8e21d1f52894"
    ]
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/file/restore' \
--header 'Content-Type: application/json' \
--data-raw '{
    "uris": [
        "cloudreve://trash/ab470e1a-31dc-4794-b749-1a453d7837b2",
        "cloudreve://trash/46ef00c1-d489-43df-a717-8e21d1f52894"
    ]
}'

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.

aggregated_error

object | null

optional

Map of multiple error in batch request. The key is the failed resource ID, it could be a file URI or a resource ID, the value is a Response.

Additional properties

object (Response)

optional

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 04:13:52

Create download URL

Delete file