Skip to content

Update OpenAPI docs for trailing slash tolerance#5459

Open
mintlify[bot] wants to merge 1 commit intomainfrom
mintlify/openapi-trailing-slash-docs-1776724898
Open

Update OpenAPI docs for trailing slash tolerance#5459
mintlify[bot] wants to merge 1 commit intomainfrom
mintlify/openapi-trailing-slash-docs-1776724898

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify Bot commented Apr 20, 2026

Summary

Updates documentation to reflect that Mintlify now tolerates trailing slash differences in OpenAPI endpoint references (from mintlify/mint#7171).

  • Removed the trailing slash mismatch warning from the troubleshooting page, replacing it with a note that trailing slashes are now handled gracefully
  • Updated the "exact match" language in the OpenAPI setup page to clarify that trailing slash differences are tolerated
  • Applied equivalent changes to all localized versions (fr, es, zh)

Note

Low Risk
Low risk documentation-only updates clarifying endpoint matching behavior; no code or runtime behavior changes.

Overview
Clarifies OpenAPI endpoint reference matching to note that trailing slashes are tolerated (e.g., /users and /users/), while still preferring exact matches when both variants exist in the spec.

Updates the same guidance in openapi-setup.mdx and troubleshooting.mdx, and applies equivalent wording across localized docs (ES/FR/ZH), removing the prior “must match exactly”/trailing-slash mismatch example in troubleshooting.

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

@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, 10:44 PM

@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, 10:41 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