API and machine access

Stack Insider is primarily a static site. These endpoints exist for discovery (RFC 9727), health checks, and agent-friendly content.

Discovery

• API catalog — GET /.well-known/api-catalog returns application/linkset+json with anchors and service-desc, service-doc, and status links per RFC 9727.
• OpenAPI — /openapi.json describes the public HTTP surface in OpenAPI 3.1.
• LLM-oriented index — /llms.txt lists key URLs for tooling.

Content formats

Many HTML routes have a matching .txt URL (same path with .txt appended) that returns compact plain text. On deployments that run our edge worker, negotiable HTML pages may also return Markdown when Accept: text/markdown is preferred over HTML.

Health

GET /health or HEAD /health returns application/json. The GET response body is a small JSON object with status set to ok, for uptime and synthetic checks.