This host serves the public Relayline API for cache purging and edge configuration — see the endpoint reference below for the available routes.
| Method | Path | Description |
|---|---|---|
| GET | /v2/zones |
List every zone visible to the calling token. |
| GET | /v2/zones/{id} |
Read one zone with its current cache and origin settings. |
| POST | /v2/zones/{id}/purge |
Queue a purge for a list of paths or the whole zone. |
| DELETE | /v2/zones/{id}/rules/{rule} |
Remove a single edge rule from a zone's rule set. |
| GET | /v2/certificates |
List issued edge certificates with their renewal state. |
All routes expect an Authorization: Bearer <token>
header and return application/json. Path segments in braces are
identifiers; unknown identifiers resolve to 404 rather than an empty
object.
{
"id": "zn_4f8c1e7a92",
"hostname": "assets.example.test",
"status": "active",
"created_at": "2026-02-14T09:31:07Z",
"updated_at": "2026-06-30T18:04:22Z",
"cache": {
"mode": "standard",
"edge_ttl": 86400,
"browser_ttl": 3600,
"query_strings": "ignore",
"stale_while_revalidate": true,
"bypass_cookies": ["session", "cart_id"]
},
"origin": {
"host": "origin.example.test",
"port": 443,
"protocol": "https",
"connect_timeout": 5
},
"tls": {
"certificate_id": "crt_91b60d3f",
"min_version": "1.2",
"expires_at": "2026-11-02T00:00:00Z"
},
"regions": ["eu-central", "eu-north", "us-east"],
"purge_queue_depth": 0
}
curl -sS https://api.example.test/v2/zones/zn_4f8c1e7a92 \ -H "Authorization: Bearer <token>" \ -H "Accept: application/json"
Limits are applied per token and per zone, counted over a sliding
window. Every response carries the remaining budget in the
X-RateLimit-Remaining header alongside the window reset time; once the
budget is spent the API answers 429 with a Retry-After value
in seconds. Batched purge bodies count as a single request regardless of how many
paths they contain, so grouping paths is usually cheaper than looping.