Kestrelstream API v2
Base URL https://api.kestrelstream.net/v2
Getting started
Create a zone, point a CNAME at it and request any file to warm the cache.
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"}
}Limits
Default limits are generous; write to us if a launch needs more.
| Resource | Default |
|---|---|
| Requests per second | 500 |
| Max file size | 25 GB |
| Purge requests per minute | 300 |
Purging
Purge by exact path, by prefix or by tag. Requests are idempotent and safe to retry.
curl -X POST https://api.kestrelstream.net/v2/zones/$ZONE/purge \
-H 'Authorization: Bearer $TOKEN' \
-d '{"prefix": "/img/"}'