api.md

API Reference

All authenticated endpoints require:

Authorization: Bearer <JWT_TOKEN>

---

Authentication

Method	Endpoint	Description
POST	/api/auth/register	Create account
POST	/api/auth/login	Login
GET	/api/auth/me	Get current user
POST	/api/auth/logout	Logout
GET	/api/auth/steam	Initiate Steam OAuth
GET	/api/auth/steam/callback	Steam OAuth callback

---

User

Method	Endpoint	Description
GET	/api/user/profile	Get user profile
PUT	/api/user/profile	Update profile
GET	/api/user/library	Get all games
GET	/api/user/sessions	Get session data
GET	/api/user/activity	Get daily activity (heatmap)
POST	/api/user/connect-ra	Connect RetroAchievements
POST	/api/user/disconnect-ra	Disconnect RetroAchievements
POST	/api/user/disconnect-steam	Disconnect Steam
POST	/api/user/toggle-emulator	Toggle emulator (PCSX2, RPCS3, PPSSPP, RetroArch)

---

Steam

Method	Endpoint	Description
POST	/api/steam/sync	Sync Steam library
GET	/api/steam/library/:steamId	Get Steam games

---

RetroArch

Method	Endpoint	Description
GET	/api/retroarch/instances	Preview detected games without syncing
POST	/api/retroarch/sync	Sync all RetroArch games into library

---

RetroAchievements

Method	Endpoint	Description
POST	/api/retroachievements/sync-library	Sync RA library

---

HLTB

Method	Endpoint	Description
GET	/api/hltb/steam/:appId	Get HLTB data by Steam appId
GET	/api/hltb/name/:gameName	Get HLTB data by name (fallback)

---

Minecraft

Method	Endpoint	Description
GET	/api/minecraft/instances	List Prism Launcher instances
POST	/api/minecraft/add	Add world to library

---

Wishlist

Method	Endpoint	Description
GET	/api/wishlist	Get wishlist
POST	/api/wishlist	Add game
POST	/api/wishlist/item	Add game (alias)
PATCH	/api/wishlist/item/:id	Update item
DELETE	/api/wishlist/item/:id	Delete item
GET	/api/wishlist/recommendations	Get recommendations

---

Recommendations

Method	Endpoint	Description
POST	/api/recommendations/:userId/optimize	Run knapsack optimization

---

Journal

Method	Endpoint	Description
GET	/api/journal	Get all entries
POST	/api/journal	Create entry
PUT	/api/journal/:id	Update entry

---

Emulators

Method	Endpoint	Description
POST	/api/pcsx2/sync	Sync PCSX2 library
POST	/api/rpcs3/sync	Sync RPCS3 library
POST	/api/ppsspp/sync	Sync PPSSPP library