LICENSE

all content, endpoints, and code provided by this API are licensed under the GNU Affero General Public License v3 (AGPL-3.0).

By accessing or using this API, you agree to comply with the terms of the AGPLv3.

For more details, please read the full license at GNU AGPLv3.

Create file share

POST

/api/share/create

Create a new shareable link for files/folders

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Body Params application/jsonRequired

Example

{
    "paths": [
        "/document.pdf",
        "/folder"
    ],
    "password": "",
    "expiration": "2025-12-31T23:59:59Z"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/share/create' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "paths": [
        "/document.pdf",
        "/folder"
    ],
    "password": "",
    "expiration": "2025-12-31T23:59:59Z"
}'

Responses

🟢200成功

application/json

Share created successfully

Body

Example

{
    "code": 200,
    "message": "success",
    "data": {
        "id": "string",
        "url": "string"
    }
}

🟠403权限不足

Modified at 2025-10-21 05:30:21

Get share by ID

Update share