For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Sample appsIntegrationsDiscordPlaygroundDevEx repo
GuidesSDK ReferenceAPI Reference
GuidesSDK ReferenceAPI Reference
  • TwelveLabs API
    • Introduction
    • Authentication
  • API Reference
    • Manage indexes
    • Upload content
      • Direct uploads
      • Multipart uploads
        • POSTCreate a multipart upload session
        • GETRetrieve the status of an upload session
        • GETList incomplete uploads
        • POSTReport uploaded chunks
        • POSTRequest presigned URLs for the remaining chunks
      • Video indexing tasks
    • Index content
    • Manage videos
    • Manage entities
    • Any-to-video search
    • Create embeddings v2
    • Create embeddings v1
    • Analyze and segment videos
    • Error codes
LogoLogo
Sample appsIntegrationsDiscordPlaygroundDevEx repo
API ReferenceUpload contentMultipart uploads

Report uploaded chunks

POST
https://api.twelvelabs.io/v1.3/assets/multipart-uploads/:upload_id
POST
/v1.3/assets/multipart-uploads/:upload_id
$curl -X POST https://api.twelvelabs.io/v1.3/assets/multipart-uploads/507f1f77bcf86cd799439011 \
>     -H "x-api-key: <apiKey>" \
>     -H "Content-Type: application/json" \
>     -d '{
>  "completed_chunks": [
>    {
>      "chunk_index": 1,
>      "proof": "d41d8cd98f00b204e9800998ecf8427e",
>      "proof_type": "etag",
>      "chunk_size": 5242880
>    }
>  ]
>}'
1{
2  "url": "https://cdn.example.com/assets/video.mp4",
3  "asset_id": "507f1f77bcf86cd799439012",
4  "processed_chunks": 5,
5  "duplicate_chunks": 0,
6  "total_completed": 15
7}
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.
Was this page helpful?
Previous

Request presigned URLs for the remaining chunks

Next
Built with

Authentication

x-api-keystring

Your API key.

Note

You can find your API key on the API Keys page.

Path parameters

upload_idstringRequired
The unique identifier of the upload session.

Request

This endpoint expects an object.
completed_chunkslist of objectsRequired
The list of chunks successfully uploaded that you're reporting to the platform. Report only after receiving an ETag.

Response

The completion of this batch has been successfully reported.
urlstringformat: "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.

Errors

400
Bad Request Error
403
Forbidden Error
404
Not Found Error