> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mixpeek.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Buckets

<iframe width="600" height="310" src="https://d8ts56gtwtyh1.cloudfront.net/docs/warehouse/buckets.mp4" title="Buckets" frameborder="0" allow="accelerometer; autoplay; muted" allowfullscreen autoplay muted />

Buckets are the warehouse's ingestion layer, where raw files enter before being decomposed into features.

### Manage buckets and objects

* **Create bucket**: Define a JSON-like schema to validate objects. Required for object registration. API parity: [Create Bucket](/api-reference/buckets/create-bucket).
* **View bucket**: Inspect schema, object counts, and metadata. API parity: [Get Bucket](/api-reference/buckets/get-bucket).
* **Update bucket**: Rename or adjust description and metadata. API parity: [Update Bucket](/api-reference/buckets/update-bucket).
* **Delete bucket**: Enqueues a task to remove bucket and objects. Track under Tasks. API parity: [Delete Bucket](/api-reference/buckets/delete-bucket).
* **Add objects**: Register raw inputs and blobs without processing. Use single or batch create. API: [Create Object](/api-reference/bucket-objects/create-object), [Create Objects in Batch](/api-reference/bucket-objects/create-objects-in-batch).
* **Batch flows**: Group object IDs, then submit for processing. Track task status. API: [Create Batch](/api-reference/bucket-batches/create-batch), [Add Objects](/api-reference/bucket-batches/add-objects-to-batch), [Submit Batch](/api-reference/bucket-batches/submit-batch-for-processing).

### Tips

* Object creation does not process files; processing happens when Engine runs extraction based on collections pointing to this bucket.
* Use batch submit for large ingestions to parallelize Engine work and monitor via Tasks in Studio.

<Tabs>
  <Tab title="Bucket lifecycle">
    <Steps>
      <Step title="Create">Define schema and metadata.</Step>
      <Step title="Update">Adjust name, description, metadata.</Step>
      <Step title="Delete">Enqueue task; track in Tasks.</Step>
    </Steps>
  </Tab>

  <Tab title="Objects & batches">
    <Steps>
      <Step title="Register objects">Single or batch registration without processing.</Step>
      <Step title="Create batch">Group object IDs for processing.</Step>
      <Step title="Submit batch">Trigger Engine processing and monitor progress.</Step>
    </Steps>
  </Tab>
</Tabs>

<Callout type="info">
  Processing runs in the Engine and writes to your active namespace; ensure it’s set correctly in the top bar.
</Callout>