Create file

POST

/file/create

Auth: JWT Optional

Create a new file with given URI and props. If ancestor folders does not existed for given uri, they will be created automatically.

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

Create new empty fileSave share link to a shortcutCreate a new folder

{
    "type": "file",
    "uri": "cloudreve://my/Inspirations/new.txt",
    "err_on_conflict": true
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Create new empty fileSave share link to a shortcutCreate a new folder

curl --location --request POST '/file/create' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "type": "file",
    "uri": "cloudreve://my/Inspirations/new.txt",
    "err_on_conflict": true
}'

Responses

🟢200Success

application/json

Body

Example

{
    "code": 0,
    "data": {
        "type": 1,
        "id": "d08Wy1Hx",
        "name": "Q3",
        "permission": null,
        "created_at": "2025-05-24T14:24:27+08:00",
        "updated_at": "2025-05-24T14:24:27+08:00",
        "size": 0,
        "metadata": null,
        "path": "cloudreve://my/Inspirations/Q3",
        "capability": "39/9",
        "owned": true,
        "primary_entity": "zOie"
    },
    "msg": ""
}

Modified at 2025-08-12 07:15:19

Create viewer session

Rename file