Skip to content

Commit 7c7f4e8

Browse files
Documentation edits made through Mintlify web editor
1 parent 2b8729c commit 7c7f4e8

File tree

2 files changed

+5
-2
lines changed

2 files changed

+5
-2
lines changed

api-playground/troubleshooting.mdx

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,8 @@ Here's a list of common issues we've seen customers run into:
2525
This is the exact validation package Mintlify uses to validate OpenAPI documents, so if your document
2626
passes validation here, there's a great chance the problem is elsewhere.
2727

28+
For OpenAPI 3.1 and newer specifications, you can also use [Swagger Editor Next](https://editor-next.swagger.io/) as an alternative validator. This tool is specifically designed to handle modern OAS formats that older validators might not fully support, making it particularly useful for validating the latest OpenAPI specifications.
29+
2830
Additionally, Mintlify does not support OpenAPI 2.0. If your document uses this version of the specification,
2931
you could encounter this issue. You can convert your document at [editor.swagger.io](https://editor.swagger.io/) (under Edit \> Convert to OpenAPI 3):
3032

support.mdx

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -62,6 +62,8 @@ export function openSearch(e) {
6262
1. Run `mint openapi-check <openapiFilenameOrUrl>` in your CLI.
6363
2. Validate your OpenAPI spec with [Swagger Editor](https://editor.swagger.io/).
6464

65+
For OpenAPI 3.1 and newer specifications, you can also use the [Next Generation Swagger Editor](https://editor-next.swagger.io/) as an alternative validator. This tool is specifically useful for validating modern OAS formats that older validators might not fully support.
66+
6567
Additionally, Mintlify does not support OpenAPI 2.0. If your document uses OpenAPI 2.0, you may encounter this issue. You can convert your document with [Swagger Editor](https://editor.swagger.io/).
6668

6769
<Frame>
@@ -131,5 +133,4 @@ export function openSearch(e) {
131133

132134
<Info>
133135
We do our best to respond to all requests within 24 hours but delays may occur during busy times.
134-
</Info>
135-
136+
</Info>

0 commit comments

Comments
 (0)