Uploads in Mixpeek mean registering objects that reference one or more blobs (files or JSON). Creating an object does not trigger processing; it simply records the object so downstream collections can process it later.
Overview
- What you create: An object inside a bucket, composed of one or more blobs.
- Where files live: Provide blob data as a URL or inline JSON, matching your bucket schema.
- Processing: Object creation does not start processing; use batches or collection pipelines to process.
Create a single object
- API: Create Object
- Method: POST
- Path:
/v1/buckets/{bucket_identifier}/objects
- Reference: API Reference
Create multiple objects (batch)
- API: Create Objects in Batch
- Method: POST
- Path:
/v1/buckets/{bucket_identifier}/objects/batch
- Reference: API Reference
Batching primer
Use batches to organize object processing into an asynchronous job. See the full guide at Batching.Tips
- Match your schema: Blob
property
andtype
must match your bucket schema. - Use prefixes:
key_prefix
helps organize downstream documents. - Metadata propagates: Object
metadata
is attached to downstream documents. - Deduplication: Set
skip_duplicates
to avoid re-registering identical blobs.