Tidalframe API v3

Getting started

Create a zone, point a CNAME at it and request any file to warm the cache.

Purging

Purge by exact path, by prefix or by tag. Requests are idempotent and safe to retry.

curl -X POST https://api.tidalframe.net/v3/zones/$ZONE/purge \
  -H 'Authorization: Bearer $TOKEN' \
  -d '{"prefix": "/img/"}'

Uploading

Send files with a PUT request; the response returns the public path and its checksum.

curl -X PUT https://api.tidalframe.net/v3/zones/$ZONE/files/img/hero.webp \
  -H 'Authorization: Bearer $TOKEN' \
  --data-binary @hero.webp

Errors

Errors are JSON objects with a stable code and a human-readable message.

{
  "error": {"code": "zone_not_found", "message": "No zone with this id"}
}