Purge Image CDN cache - Convertly Docs

POST

api

cdn-purge

Purge Image CDN cache

curl --request POST \
  --url https://convertly.sh/api/cdn-purge \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "urls": [
    "<string>"
  ],
  "tags": [
    "<string>"
  ]
}
'

{
  "ok": true,
  "purged": [
    "<string>"
  ],
  "purgedTags": [
    "<string>"
  ]
}

Authorizations

Authorization

string

header

required

Dashboard-generated Convertly API key. Keys currently begin with cvly_.

Body

application/json

Option 1
Option 2

urls

string<uri>[]

required

Full CDN URLs to evict (exact match including query string).

Maximum array length: 30

Response

CDN cache purged

boolean

required

purged

string<uri>[]

required

purgedTags

string[]

required

Analyze image for focal point, faces, and paletteRuns focal-point detection, face boxes, and palette extraction on a stored file or one-off upload. Results can be persisted in file metadata when analyzing by `fileId`. Use output to seed CDN `fp=x,y` params. Requires a standard API key or dashboard session — not a CDN signing key.

Purge Image CDN cache

curl --request POST \
  --url https://convertly.sh/api/cdn-purge \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "urls": [
    "<string>"
  ],
  "tags": [
    "<string>"
  ]
}
'

{
  "ok": true,
  "purged": [
    "<string>"
  ],
  "purgedTags": [
    "<string>"
  ]
}