Named Transform Presets

Presets let you save a set of transforms under a name and reference it with t=name. URL params override preset values.

Using presets

# Use a preset
?t=thumbnail

# Preset + override (width from URL, rest from preset)
?t=thumbnail&w=400

# Path-based
/project/t_thumbnail/image.jpg

Creating presets

Via API

curl -X POST https://app.spronta.com/api/images/projects/{id}/presets \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "thumbnail",
    "transforms": {
      "width": 200,
      "height": 200,
      "fit": "cover",
      "gravity": "face",
      "qualityMode": "medium"
    }
  }'

Preset names

• Alphanumeric, hyphens, and underscores only
• Max 64 characters
• Must be unique within a project
• Examples: thumbnail, hero-banner, og_card, product-grid

Managing presets

Method	Endpoint	Description
GET	/api/images/projects/{id}/presets	List all presets
POST	/api/images/projects/{id}/presets	Create a preset
GET	/api/images/projects/{id}/presets/{presetId}	Get a preset
PATCH	/api/images/projects/{id}/presets/{presetId}	Update a preset
DELETE	/api/images/projects/{id}/presets/{presetId}	Delete a preset

Merge behavior

Presets act as defaults. Any parameter explicitly set in the URL overrides the preset value:

# Preset "card" = { width: 600, height: 400, fit: "cover", quality: "medium" }

?t=card              → 600x400 cover, medium quality
?t=card&w=300        → 300x400 cover, medium quality (width overridden)
?t=card&q=high       → 600x400 cover, high quality (quality overridden)

Common presets

Name	Transforms	Use case
thumbnail	w=200 h=200 fit=cover g=face q=medium	Profile pictures, grid items
hero	w=1920 h=800 fit=cover g=auto q=high	Hero banners
og-card	w=1200 h=630 fit=cover q=medium	Open Graph social cards
product	w=800 h=800 fit=contain bg=ffffff q=high	E-commerce product images