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

Introducing the Mintlify Agent to write documentation with AI
Automatically update documentation with context from PRs, Slack threads, or links.
September 29, 2025Han Wang
Co-Founder

We built our coding agent for Slack instead of the terminal
Behind the scenes of why we built our agent for Slack.
September 29, 2025Nick Khami
Engineering
Hahnbee Lee
Co-Founder