Patch metadata

PATCH

/file/metadata

Modify metadata of the given file.

Request

Authorization

Add the parameter

Authorization

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

Example:

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

Header Params

Body Params application/json

Examples

Set folder icon colorRemove folder color customizationSet tags

{
    "uris": [
        "cloudreve://my/test_folder",
        "cloudreve://my/alit",
        "cloudreve://my/Inspirations"
    ],
    "patches": [
        {
            "key": "customize:icon_color",
            "value": "#d50000",
            "remove": false
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Set folder icon colorRemove folder color customizationSet tags

curl --location --request PATCH '/file/metadata' \
--header 'Content-Type: application/json' \
--data-raw '{
    "uris": [
        "cloudreve://my/test_folder",
        "cloudreve://my/alit",
        "cloudreve://my/Inspirations"
    ],
    "patches": [
        {
            "key": "customize:icon_color",
            "value": "#d50000",
            "remove": false
        }
    ]
}'

Responses

🟢200Success

application/json

Body

Example

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

Modified at 2025-08-12 07:13:02

Force unlock

Mount storage policy