Bucket Uploads

Batch Create Uploads

Changed on

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

Request

  • Base URL: https://api.mixpeek.com
  • URL: https://api.mixpeek.com/v1/buckets/{bucket_identifier}/uploads/batch
  • Auth: HTTP bearer and API key in header X-Namespace

Path parameters

bucket_identifierstring required

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"
    }
  ]
}

Changes

  • 61a175e8eb9aRevision changes
    • warning

      removed the optional property from the response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the optional property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

  • 5d4c905106b4Revision changes
    • info

      the endpoint scheme security BearerAuth AND NamespaceHeader was added to the API