Skip to content

Update OpenAPI troubleshooting for trailing slash tolerance#5462

Open
mintlify[bot] wants to merge 1 commit intomainfrom
mintlify/trailing-slash-fix-1776727640
Open

Update OpenAPI troubleshooting for trailing slash tolerance#5462
mintlify[bot] wants to merge 1 commit intomainfrom
mintlify/trailing-slash-fix-1776727640

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify Bot commented Apr 20, 2026

Summary

  • Updated the API playground troubleshooting page to reflect that trailing slashes in endpoint paths are now handled automatically
  • Removed the outdated trailing slash mismatch example that warned users about blank pages caused by /users/{id}/ vs /users/{id} differences
  • Added a note clarifying that trailing slashes are matched automatically between metadata and OpenAPI specs

Mintlify now resolves OpenAPI endpoints with trailing slash tolerance, so paths like GET /users/{id}/ correctly match /users/{id} in the spec (and vice versa).


Note

Low Risk
Documentation-only update that clarifies OpenAPI operation matching behavior; no runtime code or configuration changes.

Overview
Updates api-playground/troubleshooting.mdx to reflect that OpenAPI operation matching tolerates trailing slashes between page metadata and the spec.

Removes the outdated trailing-slash mismatch example and replaces it with a concise note, while keeping filename-misspelling guidance for resolving blank OpenAPI pages.

Reviewed by Cursor Bugbot for commit c6cd809. Bugbot is set up for automated code reviews on this repo. Configure here.

@mintlify-development
Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
userauth 🟡 Building Apr 20, 2026, 11:28 PM

@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify Bot commented Apr 20, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
mintlify 🟢 Ready View Preview Apr 20, 2026, 11:31 PM

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants