Skip to main content

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}