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.

请求参数

Body 参数application/json

示例

{
    "tokens": [
        "string"
    ]
}

请求示例代码

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"
    ]
}'

返回响应

🟢200Success

application/json

Body

示例

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

修改于 2025-12-07 14:35:40

Delete file

Patch metadata