Sign in

v3

latestOpenAPI 3.1.02026-07-3197486526.1 KB
multipartUpload

Report uploaded chunks

This method reports successfully uploaded chunks to the platform. The platform finalizes the upload after you report all chunks.

For optimal performance, report chunks in batches and in any order.

post/assets/multipart-uploads/{upload_id}

Path parameters

upload_idstring required

The unique identifier of the upload session.

Headers

x-api-keystring required

Your API key.

<Note title="Note"> You can find your API key on the <a href="https://playground.twelvelabs.io/dashboard/api-keys" target="_blank">API Keys</a> page. </Note>

Request body

Response

The completion of this batch has been successfully reported.

urlstring uri

The URL for accessing your asset. The platform returns this field only when all chunks are reported and the upload is complete. If absent, continue uploading and reporting the remaining chunks.

asset_idstring

The unique identifier of this asset.

processed_chunksinteger

The number of chunks accepted from this specific request. This equals the number of chunks in your completed_chunks array minus any duplicates.

duplicate_chunksinteger

The number of chunks in this request that were already reported. Duplicates are ignored and don't affect your upload.

total_completedinteger

The cumulative count of all unique chunks successfully reported across all requests. When this equals total_chunks, the upload is complete.