Sign in

v5

latestOpenAPI 3.1.02026-08-025631,1012.8 MB
Bucket Uploads

Batch Create Uploads

Generate multiple presigned URLs in a single request.

All uploads belong to the same bucket (from path parameter).
Maximum 100 uploads per batch.

Shared metadata is merged with individual upload metadata (individual takes precedence).
post/v1/buckets/{bucket_identifier}/uploads/batch

Path parameters

bucket_identifierstring required

The unique identifier of the bucket

The unique identifier of the bucket

Request body

shared_metadataobject nullable

Metadata to apply to all uploads (merged with individual metadata)

shared_object_metadataobject nullable

Object metadata to apply to all uploads (merged with individual)

Example request

{
  "shared_metadata": {
    "campaign": "summer_2024"
  },
  "shared_object_metadata": {
    "category": "marketing"
  },
  "uploads": [
    {
      "blob_property": "video",
      "content_type": "video/mp4",
      "filename": "video1.mp4"
    },
    {
      "blob_property": "thumbnail",
      "content_type": "image/jpeg",
      "filename": "thumbnail1.jpg"
    }
  ]
}

Response

Successful Response

totalinteger required

Total number of uploads created

Example response

{
  "total": 2,
  "uploads": [
    {
      "filename": "video1.mp4",
      "presigned_url": "https://s3.amazonaws.com/...",
      "status": "PENDING",
      "upload_id": "upl_abc123"
    }
  ]
}