Skip to main content
GET
/
cdn
/
v1
/
{deliveryKey}
/
o
/
{originSlug}
/
{originPath}
Transform an origin-source image
curl --request GET \
  --url https://convertly.sh/cdn/v1/{deliveryKey}/o/{originSlug}/{originPath}
{
  "error": "<string>",
  "upgradeUrl": "<string>"
}

Path Parameters

​
deliveryKey
string
required

Publishable delivery token starting with cvly_pub_.

​
originSlug
string
required
Pattern: ^[a-z0-9][a-z0-9_-]{0,62}$
​
originPath
string
required

Path under the configured origin source. May contain slashes.

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