Skip to main content
GET
/
api
/
v1
/
settings
/
presets
curl https://api.img-src.io/api/v1/settings/presets \
  -H "Authorization: Bearer imgsrc_YOUR_API_KEY"

{
  "presets": [
    {
      "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
    },
    {
      "id": "preset_def456",
      "name": "hero",
      "description": "Hero image for landing pages",
      "params": {
        "w": 1920,
        "h": 1080,
        "fit": "cover",
        "q": 90
      },
      "created_at": 1704067200,
      "updated_at": 1704067200
    }
  ],
  "total": 2
}
This endpoint requires a Pro plan subscription.
Presets are saved transformation configurations that can be applied via URL parameter. 
curl https://api.img-src.io/api/v1/settings/presets \
  -H "Authorization: Bearer imgsrc_YOUR_API_KEY"

{
  "presets": [
    {
      "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
    },
    {
      "id": "preset_def456",
      "name": "hero",
      "description": "Hero image for landing pages",
      "params": {
        "w": 1920,
        "h": 1080,
        "fit": "cover",
        "q": 90
      },
      "created_at": 1704067200,
      "updated_at": 1704067200
    }
  ],
  "total": 2
}

​
Using Presets

Once created, presets can be applied via the p: parameter: 
<img src="https://img-src.io/i/username/photo.jpg?p:thumbnail" />