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

# Upload Data

> Learn how to bulk upload data to CubeStack.

# Upload Data

Import data into your cubes using the API or the admin interface.

## Upload via Admin UI

1. Navigate to your cube
2. Click **Import**
3. Select a CSV or JSON file
4. Map columns to your cube schema
5. Review and confirm the import

## Upload via API

Create records programmatically:

```bash theme={null}
curl -X POST "https://api.cubestack.app/api/v1/{project}/{cube}" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Product A",
    "price": 29.99,
    "description": "A great product"
  }'
```

## Upload Images

Upload images using multipart form data:

```bash theme={null}
curl -X POST "https://api.cubestack.app/api/v1/{project}/upload" \
  -H "X-Api-Key: your-api-key" \
  -F "file=@photo.jpg"
```

The response includes the image URL you can reference in your records.

## Tips

* Validate your data before importing to avoid errors
* Use the API for large imports that exceed the admin UI file size limit
* Image uploads are processed asynchronously — allow a moment for CDN propagation