Health and docs APIs

Liveness probe, plus the read-only docs feed that powers this site.

GET /api/health

curl https://www.mnueron.com/api/health

Returns:

{ "ok": true, "service": "mnueron", "ts": 1737070000000 }

No DB call, no auth, no cookies. Use as a liveness probe.

GET /api/docs/sections

Returns the public docs tree — every section and its published pages. Used by this site's sidebar.

{
  "sections": [
    {
      "id": "...",
      "slug": "api-reference",
      "title": "API reference",
      "description": "Every Mnueron HTTP endpoint…",
      "pages": [
        { "id": "...", "slug": "overview", "title": "API overview",
          "description": "...", "sort_order": 10 }
      ]
    }
  ]
}

GET /api/docs/:section/:slug

Returns a single rendered doc page (the same one you're reading right now).

{
  "section": { "id": "...", "slug": "api-reference", "title": "API reference" },
  "page": { "id": "...", "slug": "overview", "title": "API overview",
            "content_md": "# …", "description": "…", "updated_at": "..." }
}

GET /api/docs/search?q=...

Postgres FTS over published doc pages. Returns top-10 hits with snippets:

{
  "hits": [
    { "section_slug": "api-reference", "slug": "search-memories",
      "title": "Search memories", "rank": 0.32, "preview": "…relevance-ordered hits…" }
  ]
}

No auth — these endpoints are public so the docs site can render for unauthenticated visitors.

Last updated 2026-05-24edit