Batch Confirm Uploads

Confirm multiple uploads in a single request (processed asynchronously).

Maximum 100 confirmations per batch. All uploads must belong to the same bucket.

Returns a task_id to track progress via GET /v1/tasks/.

POST /v1/buckets/{bucket_identifier}/uploads/confirm/batch

Batch Confirm Uploads

cURL

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: <api-key>' \
  --data '
{
  "confirmations": [
    {}
  ]
}
'

200

{
  "task_id": "<string>",
  "confirmations_count": 123,
  "task": {
    "task_id": "<string>",
    "inputs": [
      "batch_xyz789"
    ],
    "outputs": [
      "document_123",
      "document_456"
    ],
    "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
    },
    "error": "Failed to process batch: Object not found",
    "queue_position": 123,
    "estimated_wait_minutes": 123
  },
  "message": "Batch confirmation is being processed in the background."
}

Authorizations

Authorization · string · header · required

Mixpeek API key, sent as Authorization: Bearer mxp_sk_.... Create one in Studio under Settings → API Keys, or with an admin key via POST /v1/organizations/users/{user_email}/api-keys. A missing header returns 403; an invalid or revoked key returns 401.

X-Namespace · string · header · required

Namespace id (ns_...), not the namespace name. This scopes the request rather than authenticating it, and it is required on every operation marked x-mixpeek-namespace-scoped.

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

200

application/json

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, QUEUED, IN_PROGRESS, PROCESSING, COMPLETED, COMPLETED_WITH_ERRORS, FAILED, CANCELED, INTERRUPTED, UNKNOWN, SKIPPED, DRAFT, ACTIVE, ARCHIVED, SUSPENDED, DEACTIVATED

confirmations_count · integer · required

Number of confirmations being processed

task · TaskResponse · object · required

Full task details

Show child attributes

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": "taYOUR_OLD_API_KEY",
  "task_type": "api_buckets_batches_process"
}

message · string · default: Batch confirmation is being processed in the background.

Status message