multipartUpload

Request presigned URLs for the remaining chunks

Changed on

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

Request

  • Base URL: https://api.twelvelabs.io/v1.3
  • URL: https://api.twelvelabs.io/v1.3/assets/multipart-uploads/{upload_id}/presigned-urls
  • Auth: API key in header x-api-key

Path parameters

upload_idstring required

The unique identifier of the upload session.

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.

Changes

  • b8591e05c0baRevision changes
    • warning

      deleted the header request parameter x-api-key

    • info

      the endpoint scheme security x-api-key was added to the API

  • 6205c7327cdeRevision changes
    • info

      api operation id get-additional-presigned-urls removed and replaced with multipartUpload_get_additional_presigned_urls