Skip to main content

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:
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:
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