Image resizing

Image settings and usage#

The app's image resizing settings, its limits, this month's transformations and cache hits, the cache against the team's limit, and whether Hobby's free amount is used up (originals are served).

Parameters

• namestringpathrequired

  the app's name

  pattern ^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$ · up to 63 characters

Response

Errors

Example

curl "https://api.ibel.ai/v1/apps/my-api/images" \
  -H "Authorization: Bearer $KEY"

Change image settings#

Change any of enabled, hosts, widths, qualities, formats and ttl_seconds; live within seconds. Errors 400 image_bad_*, 409 image_limit.

Parameters

• namestringpathrequired

  the app's name

  pattern ^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$ · up to 63 characters

Request bodyapplication/json

• enabledboolean
• hostsstring[]

  host names (img.example.com) or wildcards (*.example.com); https only, never addresses

• widthsinteger[]
• qualitiesinteger[]

  0–10 items

• formatsstring[]
• ttl_secondsinteger

  60–2678400

Response

Errors

Example

curl -X PATCH "https://api.ibel.ai/v1/apps/my-api/images" \
  -H "Authorization: Bearer $KEY" \
  -d '{"enabled":true,"hosts":["…"],"widths":[1],"qualities":[1],"formats":["webp"],"ttl_seconds":60}'

Image usage by day#

Per day: transformations (billed per 1,000), cache hits, originals served unchanged, bytes in and out.

Parameters

• namestringpathrequired

  the app's name

  pattern ^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$ · up to 63 characters

• daysintegerquery

  1–90 · default 30

Response

Errors

Example

curl "https://api.ibel.ai/v1/apps/my-api/images/usage" \
  -H "Authorization: Bearer $KEY"

Clear the image cache#

Forget every cached result of the app; each is made, and counted, again on its next request.

Parameters

• namestringpathrequired

  the app's name

  pattern ^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$ · up to 63 characters

Response

Errors

Example

curl -X DELETE "https://api.ibel.ai/v1/apps/my-api/images/cache" \
  -H "Authorization: Bearer $KEY"

The team''s image resizing#

Every app's transformations this month and its cache, and the team's cache against its plan limit.

Response

Errors

Example

curl "https://api.ibel.ai/v1/images" \
  -H "Authorization: Bearer $KEY"