Force unlock

DELETE

/file/lock

If a file is locked by other user/application, file mutation might fail with errors like below:

{
    "code": 40073,
    "data": [
        {
            "path": "cloudreve://my/newdfox.docx",
            "token": "cool-lock0a4b4f68",
            "owner": {
                "owner": "bnUn",
                "application": {
                    "type": "viewer",
                    "viewer_id": "af01b85b-f57d-46d2-8ad6-1d9b96548e78"
                }
            },
            "type": 0
        }
    ],
    "msg": "Lock conflict",
    "error": "conflict with locked resource: \"cloudreve://my/newdfox.docx\"",
    "correlation_id": "64210cda-5bd1-4fe1-9102-77b86f768395"
}

The lock token cool-lock0a4b4f68 in above example is only visable to file owners. This method can be used to force unlock files if the file owners wish to do so.

Request

Body Params application/json

Example

{
    "tokens": [
        "string"
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request DELETE '/file/lock' \
--header 'Content-Type: application/json' \
--data-raw '{
    "tokens": [
        "string"
    ]
}'

Responses

🟢200Success

application/json

Body

Example

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

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

Delete file

Patch metadata