Hahnbee Lee
Co-Founder
Share this article

Launch Week III Day 5 introduced OpenAPI automations that seamlessly autogenerate API Reference documentation from OpenAPI specs, eliminating manual labor when APIs change. Users can now add an 'openapi' field to tabs or anchors in mint.json to automatically populate API Playground pages, supporting both local files and hosted URLs for real-time documentation updates.
Launch Week Day 5 brings OpenAPI automations to your documentation 🤖.
When you're constantly shipping changes to your API, it's important to reflect those changes in your documentation ASAP.
Our revamped setup makes autogenerating your API Reference docs seamless, removing the need for any manual labor to reflect changes in production
Getting Started
To auto-populate your API Playground pages, you can now add an openapi field to an object in the tabs or anchors arrays in the mint.json.
Example with Anchors:
{ Â "anchors": [ Â Â { Â Â Â "name": "API Reference", Â Â Â "openapi": "/path/to/openapi.json", Â Â Â "url": "api-reference", Â Â Â "icon": "square-terminal" Â Â } Â ] }

Example with Tabs:
{ Â "tabs": [ Â Â { Â Â Â "name": "API Reference", Â Â Â "openapi": "/path/to/openapi.json", Â Â Â "url": "api-reference" Â Â } Â ] }

We also support this functionality for OpenAPI Specs hosted at a URL. For example:
{ Â "tabs": [ Â Â { Â Â Â "name": "API Reference", Â Â Â "url": "api-reference", Â Â Â "openapi": "https://petstore3.swagger.io/api/v3/openapi.json" Â Â } Â ] }
Next Steps
Try out the feature yourself by updating your CLI:
**`npm i mintlify@latest -g
`**
And adding the following code to your mint.json:
{ Â "tabs": [ Â Â { Â Â Â "name": "API Reference", Â Â Â "url": "api-reference", Â Â Â "openapi": "https://petstore3.swagger.io/api/v3/openapi.json" Â Â } Â ] }
Thanks for tuning into Launch Week III!
Missed our previous launch days? Follow our Twitter/X or join our community to catch up on our exciting feature releases.
More blog posts to read

How we’re making Mintlify documentation more accessible
Learn about recent accessibility improvements and how Mintlify helps you create documentation that works for users regardless of how they access and interact with your site.
October 24, 2025Ethan Palm
Technical Writing

Building an LSP for your docs
Adding an IDE experience to codeblocks in your docs is one of the issues that comes up often for people looking to add more context to code snippets. It's not a deal-breaker, but it can make your docs feel more connected to the functions and methods you're documenting.
October 23, 2025Ricardo Nunez
Engineering
Hahnbee Lee
Co-Founder