Create share link

PUT

/share

Create a share link to given file. Only file owner or administrator can create share links.

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

{
    "permissions": {
        "anonymous": "BQ==",
        "everyone": "AQ=="
    },
    "uri": "cloudreve://my/Inspirations",
    "is_private": true,
    "share_view": true,
    "expire": 604800,
    "price": 20
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT '/share' \
--header 'Content-Type: application/json' \
--data-raw '{
    "permissions": {
        "anonymous": "BQ==",
        "everyone": "AQ=="
    },
    "uri": "cloudreve://my/Inspirations",
    "is_private": true,
    "share_view": true,
    "expire": 604800,
    "price": 20
}'

Responses

🟢200Success

application/json

Body

Examples

Private sharePublic share

{
    "code": 0,
    "data": "http://localhost:5173/s/g2guA/gcqzfaze",
    "msg": ""
}

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

Update view setting

Edit share link