Complete multipart upload

POST

/api/fs/multipart/complete

Join point: blocks until the upload pipeline reaches a terminal state, mirroring how /fs/put only answers once the driver upload finished. Rejected immediately while chunks are still missing, so an incomplete upload never holds the connection open. On success the session is reclaimed right away. If a CDN cuts the connection early, poll /status until a terminal state.

请求参数

Authorization

JWT Bearer

在 Header 添加参数

Authorization

示例：

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

Header 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/fs/multipart/complete' \
--header 'X-Upload-Id;' \
--header 'Authorization: Bearer <token>'

返回响应

🟢200Success

application/json

Upload finished; data.state is completed and the session is reclaimed

Bodyapplication/json

示例

{
    "code": 200,
    "message": "success",
    "data": {
        "upload_id": "3f2c9e2a-6c4b-4d2e-9a2b-1f0e8c7d5a41",
        "state": "completed",
        "attempt": 0,
        "path": "/uploads/movie.mkv",
        "size": 734003200,
        "chunk_size": 10485760,
        "total_chunks": 70,
        "received": [
            [
                0,
                69
            ]
        ],
        "received_bytes": 734003200,
        "frontier": 70,
        "storage_progress": 100
    }
}

🟠400Incomplete or Failed

🟠401Unauthorized

🟠403Not Owner

🟠404Session Not Found

修改于 2026-07-13 17:33:15

Upload one chunk

Query upload session