Public API discovery

The public site exposes a small read-only API surface for discovery and health checks. These endpoints are public and do not require OAuth, OIDC, or agent registration.

Discovery resources

/.well-known/api-catalog returns the linkset used for automated API discovery.
/api/openapi.json publishes an OpenAPI 3.1 description of the public endpoints.
/api/health returns a 200 JSON health response for status checks.
/auth.md documents that the public site does not currently require authentication.

Endpoints

Path	Method	Purpose
`/api/health`	`GET`	Health and availability check for automated clients.
`/api/og?stack=...`	`GET`	Generates the PNG social preview used for stack share links.

Links

View API catalog View OpenAPI description View health endpoint View auth metadata