Skip to main content
POST
/
v1
/
buckets
/
{bucket_identifier}
/
uploads
/
confirm
/
batch
Batch Confirm Uploads
curl --request POST \
  --url https://api.mixpeek.com/v1/buckets/{bucket_identifier}/uploads/confirm/batch \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Namespace: <x-namespace>' \
  --data '{
  "confirmations": [
    {
      "etag": "d41d8cd98f00b204e9800998ecf8427e",
      "file_size_bytes": 10485760,
      "upload_id": "upl_abc123"
    },
    {
      "etag": "7f9c12ab56f4e12d80cf8d98fe12c4a9",
      "file_size_bytes": 5242880,
      "upload_id": "upl_def456"
    }
  ]
}'
{
  "task_id": "<string>",
  "status": "PENDING",
  "confirmations_count": 123,
  "task": {
    "additional_data": {
      "batch_id": "btch_xyz789",
      "bucket_id": "bkt_products",
      "collection_ids": [
        "col_tier0",
        "col_tier1",
        "col_tier2"
      ],
      "current_tier": 1,
      "job_id": "ray_job_123",
      "namespace_id": "ns_abc123",
      "object_count": 10000,
      "sample_object_ids": [
        "obj_001",
        "obj_002",
        "obj_003",
        "obj_004",
        "obj_005"
      ],
      "total_tiers": 3
    },
    "description": "Multi-tier batch processing task in progress (tier 1 of 3) with 10k objects",
    "inputs": [
      "batch_xyz789"
    ],
    "status": "IN_PROGRESS",
    "task_id": "2d322a05-3178-4eca-aac6-b82b0a0313aa",
    "task_type": "api_buckets_batches_process"
  },
  "message": "Batch confirmation is being processed in the background."
}

Authorizations

​
Authorization
string
header
required

Bearer token authentication using your API key. Format: 'Bearer your_api_key'. To get an API key, create an account at mixpeek.com/start and generate a key in your account settings.

Headers

​
Authorization
string
required

REQUIRED: Bearer token authentication using your API key. Format: 'Bearer sk_xxxxxxxxxxxxx'. You can create API keys in the Mixpeek dashboard under Organization Settings.

Examples:

"Bearer sk_live_abc123def456"

"Bearer sk_test_xyz789"

​
X-Namespace
string
required

REQUIRED: Namespace identifier for scoping this request. All resources (collections, buckets, taxonomies, etc.) are scoped to a namespace. You can provide either the namespace name or namespace ID. Format: ns_xxxxxxxxxxxxx (ID) or a custom name like 'my-namespace'

Examples:

"ns_abc123def456"

"production"

"my-namespace"

Path Parameters

​
bucket_identifier
string
required

The unique identifier of the bucket

Body

application/json

Request to confirm multiple uploads in batch.

​
confirmations
Confirmations · object[]
required

List of confirmations with upload_id, etag, file_size_bytes

Required array length: 1 - 100 elements

Response

Successful Response

Response from batch confirmation.

​
task_id
string
required

Task ID for tracking batch confirmation progress

​
status
enum<string>
required

Task status

Available options:
PENDING,
IN_PROGRESS,
PROCESSING,
COMPLETED,
COMPLETED_WITH_ERRORS,
FAILED,
CANCELED,
UNKNOWN,
SKIPPED,
DRAFT,
ACTIVE,
ARCHIVED,
SUSPENDED
​
confirmations_count
integer
required

Number of confirmations being processed

​
task
object
required

Full task details

Examples:
{
  "additional_data": {
    "batch_id": "btch_xyz789",
    "bucket_id": "bkt_products",
    "collection_ids": ["col_tier0", "col_tier1", "col_tier2"],
    "current_tier": 1,
    "job_id": "ray_job_123",
    "namespace_id": "ns_abc123",
    "object_count": 10000,
    "sample_object_ids": [
      "obj_001",
      "obj_002",
      "obj_003",
      "obj_004",
      "obj_005"
    ],
    "total_tiers": 3
  },
  "description": "Multi-tier batch processing task in progress (tier 1 of 3) with 10k objects",
  "inputs": ["batch_xyz789"],
  "status": "IN_PROGRESS",
  "task_id": "2d322a05-3178-4eca-aac6-b82b0a0313aa",
  "task_type": "api_buckets_batches_process"
}
{
  "additional_data": {
    "cluster_id": "cl_abc123",
    "job_id": "ray_job_456"
  },
  "description": "Completed clustering task with results",
  "inputs": [
    {
      "collection_ids": ["col_products"],
      "config": { "algorithm": "kmeans", "k": 5 }
    }
  ],
  "outputs": [
    {
      "cluster_id": "cl_abc123",
      "num_clusters": 5,
      "silhouette_score": 0.78
    }
  ],
  "status": "COMPLETED",
  "task_id": "task_cluster_789",
  "task_type": "engine_cluster_build"
}
{
  "additional_data": {
    "bucket_id": "bkt_test",
    "error": "Invalid file format: Expected PDF, got PNG",
    "object_id": "obj_123"
  },
  "description": "Failed object creation task with error",
  "inputs": [
    {
      "bucket_id": "bkt_test",
      "object_id": "obj_123"
    }
  ],
  "status": "FAILED",
  "task_id": "task_failed_123",
  "task_type": "api_buckets_objects_create"
}
{
  "additional_data": {
    "batch_id": "batch_old_123",
    "from_mongodb": true,
    "note": "Retrieved from persistent storage after 24hr Redis expiry"
  },
  "description": "Task retrieved from MongoDB fallback (Redis expired)",
  "inputs": ["batch_old_123"],
  "outputs": ["Processed 500 objects"],
  "status": "COMPLETED",
  "task_id": "task_old_789",
  "task_type": "api_buckets_batches_process"
}
​
message
string
default:Batch confirmation is being processed in the background.

Status message