{
  "name": "PageSight API",
  "version": "v1",
  "auth": "Authorization: Bearer psk_live_... (make a key in PageSight: Settings, API & AI)",
  "endpoints": [
    "GET /v1/me",
    "GET /v1/sites",
    "GET /v1/registry",
    "GET /v1/sites/{id}/summary",
    "GET /v1/sites/{id}/{sources|pages|bots|behaviour|outcomes|health|people}",
    "GET /v1/sites/{id}/settings",
    "GET /v1/sites/{id}/settings/history?limit=50&before=<time>",
    "POST /v1/sites/{id}/settings/proposals  {\"changes\":{\"site.description\":\"...\"}}  (Idempotency-Key header)",
    "POST /v1/sites/{id}/settings/proposals/{proposal id}/apply  (G0/G1 only; Idempotency-Key header)"
  ],
  "errors": "application/problem+json (RFC 9457); limits in RateLimit and RateLimit-Policy headers; 429 carries Retry-After",
  "mcp": "POST https://api.pagesight.io/mcp"
}