Fill gaps from assistant conversations: docs.json location + Auth0 OAuth

[mintlify]

Summary

Fill two recurring gaps surfaced in assistant conversations: readers asking where docs.json lives, and readers asking how to wire Auth0 into Mintlify's OAuth 2.0 support.

Changes

• Add a File location section to organize/settings.mdx so the Global settings page states plainly that docs.json lives at the repo root and points at both edit paths (web editor and local IDE).
• Add help-center/configure-oauth-with-auth0.mdx, a narrow, symptom-named help center page mapping Auth0's endpoints onto Mintlify's OAuth 2.0 fields, redirect-URL registration, groups options, and common Auth0-specific errors. Links back to /deploy/authentication-setup as the canonical setup page instead of duplicating it.
• Register the new page under the Help center group in docs.json.

Context

Recent assistant threads repeatedly asked "where is docs.json?" and "how do I integrate Auth0 for private docs?". The existing OAuth setup covers the mechanics but doesn't map to Auth0's specific endpoints, so the assistant had to infer them per-conversation.

---

Note

Low Risk
Documentation and navigation metadata only; no runtime product, auth, or build logic changes.

Overview
Adds documentation aimed at common support questions: where docs.json lives and how to connect Auth0 to Mintlify’s OAuth 2.0 private-docs flow.

Global settings now opens with a File location section stating that docs.json sits at the repository root (or the documentation directory root in a monorepo in English), with localized equivalents in Spanish, French, and Chinese.

A new Help center article, configure-oauth-with-auth0, maps Auth0 tenant URLs and dashboard fields to Mintlify’s OAuth settings, covers Allowed Callback/Logout URLs, group access via token claims or userinfo, and Auth0-specific troubleshooting. It defers the full setup flow to authentication-setup. The page is registered in docs.json and locale nav files for EN, ES, FR, and ZH.

^{Reviewed by Cursor Bugbot for commit 74df471. Bugbot is set up for automated code reviews on this repo. Configure here.}

[mintlify]

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

Project	Status	Preview	Updated (UTC)
mintlify	🟢 Ready	View Preview	Aug 14, 2026, 4:13 PM

[mintlify]

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

Project	Status	Preview	Updated (UTC)
tomee	🟢 Ready	View Preview	Aug 14, 2026, 4:12 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.