Skip to main content
GET
/
cdn
/
v1
/
{deliveryKey}
/
{fileId}
Transform a Convertly Storage image
curl --request GET \
  --url https://convertly.sh/cdn/v1/{deliveryKey}/{fileId}
{
  "error": "<string>",
  "upgradeUrl": "<string>"
}

Path Parameters

​
deliveryKey
string
required

Publishable delivery token starting with cvly_pub_.

​
fileId
string<uuid>
required

Convertly Storage file id. /cdn/v1 does not fetch arbitrary origin URLs.

Query Parameters

​
w
integer
Required range: 16 <= x <= 4000
​
h
integer
Required range: 16 <= x <= 4000
​
fit
enum<string>
default:cover
Available options:
cover,
contain,
fill,
inside,
outside
​
gravity
enum<string>
default:auto
Available options:
auto,
face,
entropy,
center,
top,
right,
bottom,
left
​
format
enum<string>
default:auto
Available options:
auto,
jpeg,
jpg,
png,
webp,
avif
​
q
default:auto
Required range: 20 <= x <= 100
​
preset
string
Pattern: ^[a-z0-9_-]+$
​
s
string

Optional HMAC signature. If present, URL tampering returns 403.

Response

Transformed image bytes