Named Transforms

Named transforms let you save commonly used transformation parameter sets as reusable presets.

Managing Transforms

List Transforms

GET /api/v1/vaults/{vaultId}/transforms

{
  "data": [
    {
      "id": "tf_01abc...",
      "vault_id": "vault_01abc...",
      "name": "thumbnail",
      "params": "w=200&h=200&fit=cover&format=webp&q=80",
      "created_at": "2026-01-15T10:00:00Z"
    }
  ]
}

Create Transform

POST /api/v1/vaults/{vaultId}/transforms
Content-Type: application/json

{
  "name": "thumbnail",
  "params": "w=200&h=200&fit=cover&format=webp&q=80"
}

Transform names must be unique within a vault. The params field is validated against the same rules as URL query parameters.

Delete Transform

DELETE /api/v1/vaults/{vaultId}/transforms/{transformId}

Returns 204 No Content.

Using Named Transforms

Apply a named transform by using the t query parameter:

https://your-vault.imgbt.com/marketing/blog/hero/photo.jpg?t=thumbnail

This applies all the parameters defined in the thumbnail preset. Additional parameters can override preset values:

https://your-vault.imgbt.com/marketing/blog/hero/photo.jpg?t=thumbnail&q=95

Common Presets

Here are some recommended presets to create:

Name	Parameters	Use Case
`thumbnail`	`w=200&h=200&fit=cover&format=webp&q=80`	Grid thumbnails
`og-image`	`w=1200&h=630&fit=cover&format=jpg&q=90`	Social media cards
`hero-desktop`	`w=1920&h=1080&fit=cover&format=webp&q=85`	Hero banners
`avatar`	`w=128&h=128&fit=cover&crop=face&format=webp&q=85`	User avatars
`product`	`w=800&h=800&fit=contain&bg=ffffff&format=webp&q=90`	Product images

Named Transforms

Named Transforms

Managing Transforms

List Transforms

Create Transform

Delete Transform

Using Named Transforms

Common Presets

On this page