6c4c23c0b7
Document custom parameter pills via x-mint and api.params.post ( #5545 )
...
Generated-By: mintlify-agent
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-04-27 15:17:51 -07:00
8b893333f5
Document x-group extension and MCP skill resources ( #5299 )
...
* Document x-group extension and MCP skill resources
Generated-By: mintlify-agent
* Apply suggestion from @ethanpalm
---------
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com >
2026-04-15 19:28:12 -07:00
18ff07ab23
Add sidebarTitle to x-mint metadata example ( #5244 )
...
Generated-By: mintlify-agent
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-04-09 11:18:59 -07:00
db3ca0500d
CLI updates ( #5150 )
...
* update skills
* update migration guide
* update API migration guide
* update assistant page
* update analytics page
* update CLI commands
* deprecate openapi-check
* add coming soon
* update docs.json
* add index page
* add install page
* add preview page
* add analytics
* add commands reference
* update links
* delete installation.mdx
* add optional prereq steps
* Add telemetry section to commands reference
Incorporates telemetry content from #5039 which was merged to main after
this branch was created. Documents opt-out flags, env variables, and
config persistence.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com >
* move global flags to top
* vale
* remove `mint upgrade`
* remove unnecessary prereq
* restructure analytics commands
---------
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com >
2026-04-06 10:40:51 -07:00
f8e015ff62
Improve SEO descriptions across 177 pages ( #4993 )
...
* Improve SEO metadata: update descriptions to 130-155 chars across 177 pages
Generated-By: mintlify-agent
* Apply suggestion from @ethanpalm
* Apply suggestions from code review
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com >
* Apply suggestions from code review
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com >
* 💅
---------
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com >
2026-03-31 16:12:58 -07:00
a0ee4ef597
Fix Vale style warnings from recent PRs ( #4900 )
...
* Fix Vale style warnings from recent PRs
Generated-By: mintlify-agent
* alphabetize accept list
* remove unnecessary terms
* combine lists
* alphabetize
* add (?i)
* update wordlist
* remove default vocab
* Apply suggestions from code review
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com >
* Update accept.txt
---------
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com >
2026-03-26 10:18:53 -07:00
b96ab99a5d
Document x-default extension for API playground ( #4781 )
...
* Document x-default extension for security schemes and schema properties
Generated-By: mintlify-agent
* 💅
---------
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com >
2026-03-24 18:51:59 -07:00
5e38e26fba
Add tip about using API trigger with URL-based OpenAPI specs ( #4802 )
...
Generated-By: mintlify-agent
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-03-23 10:18:19 -07:00
6b5350804d
Fix Vale warnings from recent PRs ( #4697 )
...
* Fix Vale warnings from recent PRs
Generated-By: mintlify-agent
* Apply suggestion from @ethanpalm
* Apply suggestion from @ethanpalm
* Apply suggestion from @ethanpalm
* Update accept.txt
* Apply suggestion from @ethanpalm
* Apply suggestion from @ethanpalm
* update vale config
---------
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com >
2026-03-19 10:23:35 -07:00
dbdb1a298b
Fix Vale style warnings across documentation ( #4036 )
...
* Fix Vale style warnings across documentation
Generated-By: mintlify-agent
* Apply suggestion from @ethanpalm
* Apply suggestion from @ethanpalm
* Apply suggestions from code review
* Update guides/automate-agent.mdx
* Update integrations/analytics/adobe.mdx
---------
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com >
2026-03-05 10:11:54 -08:00
3dc3852b7a
SEO descriptions ( #4028 )
...
* Improve SEO descriptions across 47 pages
Curated descriptions from two bot-generated PRs (#3908 , #3949 ),
selecting the best approach for each page:
- Added missing title and description frontmatter to 10 API reference pages
- Benefit-focused descriptions for integration pages (not implementation-heavy)
- Accurate REST-aligned titles for API endpoints (Export, List, Trigger, etc.)
- Expanded short descriptions to 50–160 character range throughout
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com >
* copyedit
* Update custom-domain.mdx
* Fix analytics API page titles to match spec summaries
"Export" was inaccurate — spec uses "Get" for both endpoints.
Also updated descriptions to use "Retrieve" for consistency.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com >
---------
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com >
2026-03-04 16:46:28 -08:00
8f98214405
Document OpenAPI spec download URLs ( #3757 )
...
* Add tip about downloading OpenAPI specs
Generated-By: mintlify-agent
* Move OpenAPI download tip to openapi-setup.mdx
* Replace tip callout with prose
* Apply suggestion from @ethanpalm
---------
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com >
2026-02-24 18:12:35 -08:00
6268d03cc2
style: convert future tense to present tense ( #3717 )
...
* style: convert future tense 'will' to present tense across docs
Generated-By: mintlify-agent
* Apply suggestion from @ethanpalm
* Apply suggestion from @ethanpalm
* Apply suggestion from @ethanpalm
* Apply suggestion from @ethanpalm
* Apply suggestion from @ethanpalm
* Apply suggestion from @ethanpalm
* Apply suggestion from @ethanpalm
* Apply suggestion from @ethanpalm
---------
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com >
2026-02-24 12:05:49 -08:00
4db5914680
Clarify OpenAPI and AsyncAPI version support ( #3148 )
...
* Update api-playground/openapi-setup.mdx
Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
* Update api-playground/openapi-setup.mdx
Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
* Update api-playground/asyncapi-setup.mdx
Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
---------
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-02-05 18:00:39 -08:00
a0c61cbe00
Update api-playground/openapi-setup.mdx ( #3037 )
...
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-02-02 10:27:00 -08:00
1ee69b4bdd
Add documentation for auth playground display mode ( #2989 )
...
* Update api-playground/overview.mdx
Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
* Update api-playground/overview.mdx
Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
* Update api-playground/openapi-setup.mdx
Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
---------
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-01-30 08:59:08 -08:00
3e20041feb
Clarify multiple API specification files ( #2537 )
...
* add asyncapi example
* add examples to settings
* add openAPI examples
* clarify multiple API specs are supported
* editor specific
* Update openapi-setup.mdx
2026-01-05 13:18:31 -08:00
d09a313240
remove mcp section ( #2192 )
2025-12-10 14:59:37 -08:00
30d7e22acf
Flatten "Document APIs" group ( #1752 )
...
* consolidate MDX group into single page
* update nav and redirects
* match filename to title
* revise intro and setup
* update auth section
* remove outdated intro
* copyedit overview
* add link to example endpoint page
* remove asyncapi subdirectory
* 💅
* move MDX content out of OpenAPI setup
* copyedit openapi-setup
* Revert "move MDX content out of OpenAPI setup"
This reverts commit 3baed8e572💅
* update descriptions
* fix title
* add missing keywords
* fix YAML
2025-11-17 15:51:49 -08:00
39c1ae39c3
Clarify OpenAPI multiple documents support and $ref limitations ( #1782 )
...
* Update api-playground/openapi-setup.mdx
* Update api-playground/openapi-setup.mdx
* Update api-playground/openapi-setup.mdx
* Update api-playground/openapi-setup.mdx
* concision
* copyedit
---------
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com >
2025-11-17 13:03:33 -08:00
4c31f3683c
SEO: add keywords to pages ( #1775 )
...
* ai/ keywords
* api/ keywords
* components/ keywords
* create/ keywords
* customize/ keywords
* api-playground/ keywords
* dashboard/ keywords
* deploy/ keywords
* guides/ keywords
* insights/ keywords
* integrations/ keywords
* optimize/ keywords
* organize/ keywords
* root/ keywords
* rm temp files
2025-11-14 14:08:24 -08:00
4b68a8e5ec
Update descriptions for SEO ( #1767 )
...
* add global metatags
* set "indexing": "all"
* update AI group descriptions
* api-playground descriptions
* root level page descriptions
* component descriptions
* create descriptions
* customize descriptions
* dashboard descriptions
* deploy descriptions
* guides descriptions
* insights descriptions
* api-playground
* organize descriptions
* Integrations descriptions
2025-11-13 17:14:39 -08:00
3a87014f2d
Fix missing "s" on components.schemas OpenAPI doc section ( #1630 )
...
it's components.schemas, not components.schema: https://swagger.io/specification/#components-object
2025-10-28 09:43:00 -07:00
654d533b90
Task based IA ( #1353 )
...
* implement task-based IA
* rearrange pages
* tag examples
* add cookbook example
* add a components menu
* rename cookbook to guides
* fix docs.json after adding translations
* prettier docs.json
* move content to Guides
* move GEO page to guides
* draft of ai-native page
* update body with info on reading/distributing
* copy edits
* 💅
* move guides above API reference
* remove CLI sidebarTitle
* update organization
* remove tags
* remove guides icons
* Update ai-native.mdx
* Update ai-native.mdx
* copyedits
* 💅
* even number of cards
* update discovering section
* remove components tab
* remove icons
* remove icon
* add group level icons
* update Get started group
* Update organize group
* update customize group
* update create content group
* shorten URLs
* update API group
* update deploy group
* update optimize and guides groups
* set up redirects
* update links
* add pdf page
* add missing icons
* remove default expanded state
* update docs.json
2025-10-01 11:55:34 -07:00
da88524e74
Add filename in openapi-schema frontmatter docs ( #1347 )
...
* add filename in openapi-schema frontmatter docs
* english is my first language
2025-09-26 11:54:21 -07:00
1cb6eabd93
Fix code sample highlighting ( #1033 )
...
* fix code sample highlighting
* update sample highlighting
2025-08-15 14:41:05 -07:00
b6c9df22fc
MCP tool updates ( #1022 )
...
* update `x-mint: mcp` info
* fix JSON examples
* update MCP
* include `securityRequirement`
* include responseField for mcp object
adds x-mint.mcp.name and x-mint.mcp.description
* update availability
* move troubleshooting to the bottom
* add `mcp` as keyword
* use tabs for installation options
* add VS code MCP install to contextual menu
* make it more clear what contextual menu does
* add tabs for how to connect MCP server to popular tools
* update Mintlify example
* fix VS Code since did it everywhere else
* fix contextual menu label
* update placeholder values
* make buttons look nicer
2025-08-14 16:07:43 -07:00
9ae5f16ce2
Highlighting fix ( #1019 )
2025-08-12 11:25:18 -07:00
a6feb60f64
Openapi nav updates ( #1008 )
...
* add troubleshooting info
* update conceptual info in MDX setup
* add OpenAPI section to navigation page
* update overview steps
* Update info about customizing endpoint pages
* update setup information
* fix typo
* add migration guide
* clarify allowed metadata
* more precise terms
* explain `directory` field
* clarify you can use multiple OpenAPI specs
* navigation reviewer feedback
* troubleshooting reviewer feedback
* overview reviewer feedback
* setup reviewer feedback
* fewer things to troubleshoot
* update auto-populate API pages section
* update JSON example
* update default OpenAPI spec example
* update spec inheritance example
* replace example
* fix overview JSON examples
* update navigation example
* update troubleshooting example
* Update openapi-setup.mdx
* Update migration guide
* update JSON examples
---------
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com >
2025-08-11 17:27:34 -07:00
97b37683e8
add x-mint: mcp ( #1000 )
2025-08-07 10:30:42 -07:00
b64d3c8df0
Capitalize href ( #998 )
2025-08-06 14:28:18 -07:00
6f16b62ce4
Nit about version and deprecated ( #995 )
2025-08-06 13:14:54 -07:00
f632ff1cc0
x-mint (#927 )
...
* add troubleshooting info
* update conceptual info in MDX setup
* add OpenAPI section to navigation page
* update overview steps
* Update info about customizing endpoint pages
* update setup information
* fix typo
* add migration guide
* clarify allowed metadata
* more precise terms
* explain `directory` field
* clarify you can use multiple OpenAPI specs
* navigation reviewer feedback
* troubleshooting reviewer feedback
* overview reviewer feedback
* setup reviewer feedback
* fewer things to troubleshoot
* update auto-populate API pages section
* remove navigation content
* reviewer feedback
2025-08-05 16:42:24 -07:00
8cb398e8f6
Add webhooks section to OpenAPI setup ( #894 )
...
* add webhooks section
* put version requirements in context
2025-07-14 10:28:16 -07:00
2b150e5749
Change titles to sentence case ( #833 )
...
* change titles to sentence case
* make groups sentence case
2025-06-19 10:15:15 -07:00
40d2e2cd2d
Add proper language support for syntax highlighting to all code blocks ( #807 )
...
* Add proper language support for syntax highlighting to all code blocks
* Camel case inline code
2025-06-11 12:38:15 -07:00
6f00cd27e5
API playground docs refresh ( #723 )
...
* add outline
* update overview
* add a quickstart
* update grouping and titles
* Add getting started info to overview
* update info on adding openAPI doc
* remove repeated link
* update info on auto-generating pages
* remove mindsdb image
* update MDX info
* remove files combined into OpenAPI setup
* add redirects
* rewrite MDX intro
* upate steps
* undo reorging MDX content
* create files for customization group
* update `docs.json`
* add content for complex data types
* add content for managing page visibility
* Add SDK examples content
* delete advanced features page
* add description for SDK page
* add info on multiple responses
* fix broken links
* Copilot edits
* Copy edit overview
* Copy edit of OpenAPI setup
* Copyedit customization pages
* consistent heading capitalization
* add reviewer feedback
2025-05-28 11:53:38 -07:00
mintlify[bot]