Sign in

v3

latestOpenAPI 3.1.02026-07-3197486526.1 KB
multipartUpload

Request presigned URLs for the remaining chunks

This method generates new presigned URLs for specific chunks that require uploading. Use this endpoint in the following situations:

  • Your initial URLs have expired (URLs expire after one hour).
  • The initial set of presigned URLs does not include URLs for all chunks.
  • You need to retry failed chunk uploads with new URLs. To specify which chunks need URLs, use the start and count parameters. For example, to generate URLs for chunks 21 to 30, use start=21 and count=10. The response will provide new URLs, each with a fresh expiration time of one hour.
post/assets/multipart-uploads/{upload_id}/presigned-urls

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

startinteger required

The index of the first chunk number to generate URLs for. Chunks are numbered from 1.

countinteger required

The number of presigned URLs to generate starting from the index. You can request a maximum of 50 URLs in a single API call.

Response

Additional presigned URLs have been successfully generated.

upload_idstring

The unique identifier of the upload session associated with these URLs.

start_indexinteger

The index of the first chunk number in this set of URLs. Matches the start value from your request.

countinteger

The number of new URLs created. Matches the count value from your request.

generated_atstring date-time

The date and time, in the RFC 3339 format ("YYYY-MM-DDTHH:mm:ssZ"), when these URLs were created. URLs remain valid for 1 hour from this time.

expires_atstring date-time

A string representing the date and time, in RFC 3339 format ("YYYY-MM-DDTHH:mm:ssZ"), when the resource will expire.