API quick start

Everything in the dashboard is available over REST. Base URL: https://api.northgrind.net/v2

Authentication

Pass your API key in the Authorization header. Keys are scoped per zone or account-wide.

curl -H "Authorization: Bearer $NG_KEY" \
  https://api.northgrind.net/v2/zones

Create a zone

curl -X POST -H "Authorization: Bearer $NG_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hostname":"assets.example.com","origin":"https://origin.example.com"}' \
  https://api.northgrind.net/v2/zones

Purge

Purges propagate to all edges in under 800 ms (p95).

curl -X POST -H "Authorization: Bearer $NG_KEY" \
  -d '{"paths":["/static/app.js","/img/*"]}' \
  https://api.northgrind.net/v2/zones/zn_84fa2/purge

Rate limits

600 requests per minute per key. Purge endpoints are limited to 60/min — batch paths into a single call.