API reference

All requests go to https://api.regionsync.org over TLS 1.2 or above. Authentication is a project token passed as a bearer credential. Tokens are scoped to a single project and can be rotated without redeploying anything.

Authentication

curl -sS https://api.regionsync.org/v1/status \
  -H "Authorization: Bearer $PROJECT_TOKEN"

Endpoints

POST /v1/purge
Invalidate by path. Accepts up to 500 paths per call, applied network-wide.
POST /v1/purge/tag
Invalidate every object carrying a given surrogate tag.
GET /v1/zones
List configured hostnames and their origin settings.
GET /v1/stats
Bytes served and cache hit ratio per zone and location.
GET /v1/status
Component health as JSON. Used by this status page.

Rate limits

60 requests per minute per project token, measured over a sliding window. Exceeding the limit returns 429 with a Retry-After header. Bulk operations count once per call, not once per item.

Errors

Errors are returned as JSON with a stable code field. The HTTP status carries the class of failure; the code identifies the specific condition.

{
  "error": {
    "code": "token_expired",
    "message": "The project token is no longer valid.",
    "request_id": "7f3c1a9e"
  }
}

Quote request_id when contacting support; it is retained for 30 days.