API reference

CDN

Zones that cache an origin's content at the edge, with purging.

CDN zones of an organisation

GET/v1/orgs/{org}/cdn

API token or dashboard session

CDN zones of an organisation.

Path parameters

orgstringpathrequired
Organisation slug

Responses

200CdnZone[]

Fields of CdnZone

created_atdate-timerequired
default_ttl_secsintegerrequired
Seconds a response without caching headers is kept. Zero: only responses that ask to be cached are.
hostnamestringrequired
Where the zone is served.
iduuidrequired
namestringrequired
optimize_imagesbooleanrequired
Whether images are resized and re-encoded when the request asks, with ?width=, ?height=, ?quality= and ?format=.
originstringrequired
Where its content comes from.
stale_secsintegerrequired
Seconds a response is still served past its lifetime while a fresh copy is fetched, unless it carries stale-while-revalidate itself.

curl "https://api.infraflow.app/v1/orgs/acme/cdn" \
  -H "Authorization: Bearer $INFRAFLOW_TOKEN"

Response · 200

[
  {
    "created_at": "2026-01-15T09:30:00Z",
    "default_ttl_secs": 0,
    "hostname": "www.example.com",
    "id": "0197b2a4-5c1e-7d3a-9f10-4b6c8e2a1d55",
    "name": "my-app",
    "optimize_images": true,
    "origin": "https://203.0.113.10",
    "stale_secs": 0
  }
]

Create a CDN zone in front of an origin

POST/v1/orgs/{org}/cdn

API token or dashboard session

Create a CDN zone in front of an origin.

Path parameters

orgstringpathrequired
Organisation slug

Request body · application/json

default_ttl_secsinteger
namestringrequired
optimize_imagesboolean
originstringrequired
The site to cache, such as https://www.example.com.
stale_secs

Change a zone's settings

PATCH/v1/orgs/{org}/cdn/{zone}

API token or dashboard session

Change a zone's settings. Changing the origin, or whether images are optimised, also purges the zone: what was cached no longer applies.

Path parameters

orgstringpathrequired
Organisation slug
zonestringpathrequired
Zone name

Request body · application/json

default_ttl_secsinteger | null
optimize_imagesboolean | null
originstring | null

Delete a zone

DELETE/v1/orgs/{org}/cdn/{zone}

API token or dashboard session

Delete a zone. Its hostname stops answering.

Path parameters

orgstringpathrequired
Organisation slug
zonestringpathrequired
Zone name

Responses

204no body
404Problem

curl -X DELETE "https://api.infraflow.app/v1/orgs/acme/cdn/zone" \
  -H "Authorization: Bearer $INFRAFLOW_TOKEN"

Purge a zone: everything cached for it is forgotten at once

POST/v1/orgs/{org}/cdn/{zone}/purge

API token or dashboard session

Purge a zone: everything cached for it is forgotten at once.

Path parameters

orgstringpathrequired
Organisation slug
zonestringpathrequired
Zone name

Responses

204no body
404Problem

curl -X POST "https://api.infraflow.app/v1/orgs/acme/cdn/zone/purge" \
  -H "Authorization: Bearer $INFRAFLOW_TOKEN"

[ { "created_at": "2026-01-15T09:30:00Z", "default_ttl_secs": 0, "hostname": "www.example.com", "id": "0197b2a4-5c1e-7d3a-9f10-4b6c8e2a1d55", "name": "my-app", "optimize_images": true, "origin": "https://203.0.113.10", "stale_secs": 0 } ]