docs: add comprehensive API reference documentation

[Agolid]

Summary

Adds auto-generated API reference documentation from the existing OpenAPI spec (server/swagger/openapi.json).

Closes #5288

Changes

• Added server/API_REFERENCE/ with 12 markdown files
• 58 API endpoints documented across 9 categories:
  • Authentication
  • Admin
  • Documents
  • Workspaces
  • Workspace Threads
  • System Settings
  • User Management
  • OpenAI Compatible Endpoints
  • Embed
• Includes README, full API Reference, and Data Schemas

Generated with

api-doc-sync from server/swagger/openapi.json (OpenAPI 3.0)

Note

The documentation is placed in server/API_REFERENCE/ to keep it close to the source spec. If you prefer a different location (e.g. docs/), I am happy to move it.

[timothycarambat]

Closing simply because auto-updating this is going to be a super large chore to maintain and being able to just read or use the Swagger docs is exactly what this is for - mainting the MD files is just another chore that will grow stale

[Agolid]

Closing simply because auto-updating this is going to be a super large chore to maintain and being able to just read or use the Swagger docs is exactly what this is for - mainting the MD files is just another chore that will grow stale

Totally fair point! Keeping a separate set of MD docs in sync with the API is indeed a losing battle — the Swagger UI is the right single source of truth here. Appreciate you taking the time to explain the reasoning rather than just silently closing it. Makes total sense. 🤝