Rate limits & errors

Rate limits

Each endpoint is rate-limited. Defaults:

Exceeding a limit returns 429 Too Many Requests. Spread bursts out or batch where you can.

These are the current SnowAnalytics service defaults. If your integration needs higher limits, contact [email protected].

The authenticated endpoints return a JSON error envelope:

{
  "status": "error",
  "error": {
    "code": 400,
    "message": "Invalid event name"
  }
}

Common status codes across the APIs:

Status	Meaning
`400 Bad Request`	The request was malformed or a field failed validation.
`401 Unauthorized`	Missing or invalid API key.
`403 Forbidden`	The key lacks the scope the endpoint needs, or the site is locked.
`404 Not Found`	No matching site (for `/api/flake`).
`429 Too Many Requests`	Rate limit exceeded.

/api/flake responds with status codes only (204 on success, with no body), since it's called by the browser snippet.