Skip to main content
POST
/
api
/
v1
/
settings
/
presets
curl -X POST https://api.img-src.io/api/v1/settings/presets \
  -H "Authorization: Bearer imgsrc_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "thumbnail",
    "description": "200x200 thumbnail with cover fit",
    "params": {
      "w": 200,
      "h": 200,
      "fit": "cover",
      "format": "webp"
    }
  }'

{
  "id": "preset_abc123",
  "name": "thumbnail",
  "description": "200x200 thumbnail with cover fit",
  "params": {
    "w": 200,
    "h": 200,
    "fit": "cover",
    "format": "webp"
  },
  "created_at": 1704067200,
  "updated_at": 1704067200
}
This endpoint requires a Pro plan subscription.
curl -X POST https://api.img-src.io/api/v1/settings/presets \
  -H "Authorization: Bearer imgsrc_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "thumbnail",
    "description": "200x200 thumbnail with cover fit",
    "params": {
      "w": 200,
      "h": 200,
      "fit": "cover",
      "format": "webp"
    }
  }'

{
  "id": "preset_abc123",
  "name": "thumbnail",
  "description": "200x200 thumbnail with cover fit",
  "params": {
    "w": 200,
    "h": 200,
    "fit": "cover",
    "format": "webp"
  },
  "created_at": 1704067200,
  "updated_at": 1704067200
}

​
Parameters

NameTypeRequiredDescription
namestringYesPreset name (alphanumeric, hyphens, underscores)
descriptionstringNoHuman-readable description
paramsobjectYesTransformation parameters

​
Available Params

ParamTypeDescription
wintegerWidth in pixels
hintegerHeight in pixels
fitstringFit mode: cover, contain, fill, scale-down
qintegerQuality (1-100)
formatstringOutput format: webp, avif, jpeg, png