Skip to content

docs(architecture): health endpoint listed as /api/health but actual path is /health #565

Description

@oleksandr-korin

Summary

docs/memory/architecture.md lists the backend health endpoint as /api/health, but the actual served path is /health.

Verification

$ curl -s -o /dev/null -w "%{http_code}\n" http://localhost:8000/health
200
$ curl -s -o /dev/null -w "%{http_code}\n" http://localhost:8000/api/health
404

The OpenAPI spec also confirms /health (no /api/ prefix) is the correct path.

Fix

In docs/memory/architecture.md, update the row under "Auth, Users & MCP" that reads:

| GET | `/api/health` | Health check |

Replace with:

| GET | `/health` | Health check |

(Or move it out of the auth section entirely — it's not auth-related.)

How this surfaced

Caught during local Trinity smoke verification while running PR #553 (issue #67 — design system tokens). The verification used the architecture-documented endpoint and got a 404; falling back to /health worked.

Severity

P3 — pure documentation drift, no functional impact. Worth filing because /validate-architecture should ideally catch this, and it's the kind of thing new contributors would trip over.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions