Skip to content

Update OpenAPI troubleshooting for trailing slash tolerance#5478

Merged
ethanpalm merged 2 commits intomainfrom
mintlify/openapi-trailing-slash-docs-1776811925
Apr 22, 2026
Merged

Update OpenAPI troubleshooting for trailing slash tolerance#5478
ethanpalm merged 2 commits intomainfrom
mintlify/openapi-trailing-slash-docs-1776811925

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify Bot commented Apr 21, 2026

Summary

  • Updated the API playground troubleshooting page to reflect that Mintlify now automatically resolves trailing slash differences between openapi references and OpenAPI spec paths
  • Replaced the trailing slash mismatch example with a more relevant typo example (singular vs plural path), since trailing slashes are no longer a pitfall

Shipped in this release: OpenAPI endpoint resolution now tolerates trailing slash mismatches (e.g., /users/{id}/ matches /users/{id}), fixing a common issue for Django/DRF users.


Note

Low Risk
Low risk documentation-only change that adjusts guidance and examples around OpenAPI endpoint matching behavior.

Overview
Updates api-playground/troubleshooting.mdx to clarify that Mintlify auto-resolves trailing slash differences between openapi references and spec paths, and replaces the prior trailing-slash mismatch example with a more representative path-typo example (singular vs plural).

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

… path resolution

Generated-By: mintlify-agent
@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 21, 2026, 10:53 PM

@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify Bot commented Apr 21, 2026

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

Project Status Preview Updated (UTC)
mintlify 🟢 Ready View Preview Apr 21, 2026, 10:55 PM

Comment thread api-playground/troubleshooting.mdx Outdated
Comment thread api-playground/troubleshooting.mdx Outdated
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
@ethanpalm ethanpalm merged commit 1f5c74a into main Apr 22, 2026
3 checks passed
@ethanpalm ethanpalm deleted the mintlify/openapi-trailing-slash-docs-1776811925 branch April 22, 2026 20:18
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.

1 participant