Import external files

POST

/workflow/import

Create a task to import external physical files to given path of a given user. This method is restricted to users with admin permission only.

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

Example

{
    "src": "/path/to/existing",
    "dst": "/",
    "extract_media_meta": false,
    "user_id": "lpua",
    "recursive": true,
    "policy_id": 1
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/workflow/import' \
--header 'Content-Type: application/json' \
--data-raw '{
    "src": "/path/to/existing",
    "dst": "/",
    "extract_media_meta": false,
    "user_id": "lpua",
    "recursive": true,
    "policy_id": 1
}'

Responses

🟢200Success

application/json

Body

Example

{
    "code": 0,
    "data": {
        "created_at": "2025-05-20T13:07:23.952911+08:00",
        "updated_at": "2025-05-20T13:07:23.952911+08:00",
        "id": "D8wbcA",
        "status": "queued",
        "type": "import",
        "summary": {
            "props": {
                "dst": "cloudreve://lpua@my/%2F",
                "dst_policy_id": "J7uV",
                "failed": 0,
                "src_str": "/not/exist"
            }
        }
    },
    "msg": ""
}

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

Relocate storage policy

Set permission