{"name":"FOE Buildings API","version":"1.0.0","endpoints":{"/health":"Liveness check — always 200 if the process is up (no auth)","/ready":"Readiness check — 200 when DB is reachable and data is fresh (no auth)","/status":"Data status and last update info","/buildings":"List all buildings (paginated)","/buildings/{building_id}":"Get specific building","/building-names":"List all building IDs with names","/eras":"List all eras","/events":"List all events","/stats":"Database statistics","/metrics":"Operational metrics (uptime, record count, update history)","/changelog":"Building change history (added/removed/modified)","/data/forgehx":"ForgeHX configuration data","/data/{metadata-dataset}":"Raw game metadata datasets","/data/update-log":"Update history log","/update":"Trigger manual data update (POST)","/update/announce":"Re-post a past update changelog to Discord (POST, admin)","/update/translations":"Trigger manual translation retrieval (POST)","/update/status":"Check update status","/api/v1/catalogue/manifest":"Typed website catalogue manifest","/api/v1/catalogue/buildings":"Paginated typed website catalogue","/api/v1/buildings/{building_id}":"Typed analysis/display building resource","/api/v1/events/{event_id}/buildings":"Typed event building resource","/api/v1/metadata/icons/manifest":"Typed icon asset manifest"},"auth":"Include 'X-API-Key' header for all endpoints except /, /health, and /ready"}