Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 9 additions & 4 deletions api-playground/troubleshooting.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -33,13 +33,18 @@ If your API pages aren't displaying correctly, check these common configuration
</Accordion>
<Accordion title="One of my OpenAPI pages is completely blank">
This is usually caused by a misspelled `openapi` field in the page metadata. Make sure
the HTTP method and path match the HTTP method and path in the OpenAPI document exactly.
the HTTP method and path match the HTTP method and path in the OpenAPI document.

<Note>
Mintlify automatically resolves trailing slash differences between your `openapi` reference
and the OpenAPI specification. For example, `GET /users/{id}/` matches a specification path of `/users/{id}`.
</Note>

Here's an example of how things might go wrong:

```mdx get-user.mdx
---
openapi: "GET /users/{id}/"
openapi: "GET /user/{id}"
---
```

Expand All @@ -49,8 +54,8 @@ If your API pages aren't displaying correctly, check these common configuration
get: ...
```

Notice that the path in the `openapi` field has a trailing slash, whereas the path in the OpenAPI
document does not.
Notice that the path in the `openapi` field says `/user/{id}` (singular), whereas the path in the OpenAPI
document is `/users/{id}` (plural).

Another common issue is a misspelled filename. If you are specifying a particular OpenAPI document
in the `openapi` field, ensure the filename is correct. For example, if you have two OpenAPI
Expand Down
Loading