Skip to content

feat: add OpenAPI-powered API reference with EU/US server selector#131

Merged
dangrondahl merged 1 commit intomainfrom
add_fastapi_playground
Apr 7, 2026
Merged

feat: add OpenAPI-powered API reference with EU/US server selector#131
dangrondahl merged 1 commit intomainfrom
add_fastapi_playground

Conversation

@dangrondahl
Copy link
Copy Markdown
Contributor

@dangrondahl dangrondahl commented Apr 7, 2026

Summary

  • Replace manual MDX endpoint pages with auto-generated API reference from the FastAPI OpenAPI 3.1.0 spec (76 endpoints)
  • Add EU/US server selector dropdown in the API playground (app.kosli.com / app.us.kosli.com)
  • Add Mintlify agent workflow to sync api-reference/openapi.json with new kosli-dev/server releases

Replace manual MDX endpoint pages with auto-generated pages from the
FastAPI OpenAPI 3.1.0 spec covering all 76 endpoints. Adds a server
dropdown for EU (app.kosli.com) and US (app.us.kosli.com) regions.
Includes a Mintlify agent workflow to keep the spec in sync with
kosli-dev/server releases.
@dangrondahl dangrondahl requested a review from a team as a code owner April 7, 2026 13:58
@mintlify
Copy link
Copy Markdown
Contributor

mintlify bot commented Apr 7, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
kosli 🟢 Ready View Preview Apr 7, 2026, 1:59 PM

@dangrondahl
Copy link
Copy Markdown
Contributor Author

When FastAPI is fully released, we can probably just point to the endpoint instead of maintaining the file locally.

Copy link
Copy Markdown
Contributor

@mbevc1 mbevc1 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice 🚀

@dangrondahl dangrondahl merged commit 337cc01 into main Apr 7, 2026
5 checks passed
@dangrondahl dangrondahl deleted the add_fastapi_playground branch April 7, 2026 15:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants