Skip to main content

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.

Uploads Endpoints

Endpoints for uploading and managing files and images.

Upload Image

Upload an image to be served via CDN.
POST /api/v1/{project}/upload
X-Api-Key
string
required
Your API key
Content-Type
string
required
multipart/form-data

Request

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

Response

{
  "id": "img_abc123",
  "url": "https://api.cubestack.app/api/v1/img/img_abc123"
}

Image Variants

Uploaded images are available in multiple sizes:
VariantDescription
thumbnailSmall preview (150px)
mediumMedium size (600px)
fullFull resolution
Access variants by appending the variant name:
https://api.cubestack.app/api/v1/img/{image_id}/{variant}