You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
If the text box that appears below has a green border, your document has passed validation.
47
-
This is the exact validation package Mintlify uses to validate OpenAPI documents, so if your document
48
-
passes validation here, there's a great chance the problem is elsewhere.
53
+
1. Run `mintlify openapi-check <openapiFilenameOrUrl>` in your CLI
54
+
2. Check the spec for errors with [this validator](https://editor.swagger.io/)
49
55
50
56
Additionally, Mintlify does not support OpenAPI 2.0. If your document uses this version of the specification,
51
-
you could encounter this issue. You can convert your document at [editor.swagger.io](https://editor.swagger.io/) (under Edit \> Convert to OpenAPI 3):
57
+
you could encounter this issue. You can convert your document at [editor.swagger.io](https://editor.swagger.io/)
52
58
53
59
<Frame>
54
60

@@ -91,7 +97,7 @@ description: "We're here to help you get the most out of Mintlify"
91
97
requests, then all of these requests will fail. To fix this, configure your reverse proxy to
92
98
allow `POST` requests to the `/api/request` path.
93
99
94
-
Alternatively, if your reverse proxy prevents you from accepting `POST` requests, you can configure Mintlify to send requests directly to your backend with the `api.playground.proxy` setting in the `docs.json`, as described [here](/settings/global#api-configurations). This will
100
+
Alternatively, if your reverse proxy prevents you from accepting `POST` requests, you can configure Mintlify to send requests directly to your backend with the `api.playground.proxy` setting in the `docs.json`, as described [here](/core-concepts/settings#param-proxy). This will
95
101
likely require you to configure CORS on your server, as these requests will now come directly
96
102
from your users' browsers.
97
103
</Accordion>
@@ -102,32 +108,17 @@ description: "We're here to help you get the most out of Mintlify"
102
108
Check to see if you have `/api` in the URL. This is a reserved folder in production environments, which produces a 404 error.
0 commit comments