From 358488d48f18123d5813c83c7f3dedff816342ac Mon Sep 17 00:00:00 2001
From: Pierre Brisorgueil <pierrebrisorgueil@me.com>
Date: Mon, 13 Apr 2026 12:31:29 +0200
Subject: [PATCH] docs(api): hide models sidebar in Scalar reference
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Pass `hideModels: true` to the Scalar apiReference middleware so the
public `/api/docs` no longer exposes the internal Models tree
(Mongoose-derived shapes, error envelopes, intermediate DTOs). Schemas
are still documented inline on each endpoint — the Models section just
leaks implementation detail without helping API consumers.

Stack-side default — every downstream project benefits without extra
config.

Closes #3458
---
 lib/services/express.js | 1 +
 1 file changed, 1 insertion(+)

diff --git a/lib/services/express.js b/lib/services/express.js
index d4d9eeded..7bcd37187 100644
--- a/lib/services/express.js
+++ b/lib/services/express.js
@@ -92,6 +92,7 @@ const initSwagger = (app) => {
       '/api/docs',
       apiReference({
         spec: { content: spec },
+        hideModels: true,
       }),
     );
   }