mintlify · mintlify · Jul 27, 2026 · Jul 27, 2026
diff --git a/es/deploy/cloudflare.mdx b/es/deploy/cloudflare.mdx
@@ -82,8 +82,12 @@ async function handleRequest(request) {
       return await fetch(request);
     }
 
-    // If the request is to the docs subpath
-    if (/^\/docs/.test(urlObject.pathname)) {
+    // If the request is to the docs subpath or a Mintlify asset or API path
+    if (
+      /^\/docs/.test(urlObject.pathname) ||
+      /^\/mintlify-assets\//.test(urlObject.pathname) ||
+      /^\/_mintlify\//.test(urlObject.pathname)
+    ) {
       // Then Proxy to Mintlify
       const DOCS_URL = "[SUBDOMAIN].mintlify.site";
       const CUSTOM_URL = "[YOUR_DOMAIN]";
@@ -108,6 +112,12 @@ async function handleRequest(request) {
 }
 ```
 
+<Warning>
+  Además de tu subruta, tu Worker debe hacer proxy de `/mintlify-assets/*`, que sirve el CSS, JavaScript y favicons de tu documentación, y `/_mintlify/*`, que gestiona las solicitudes del playground de API.
+
+  Si diriges el tráfico a tu Worker con patrones de ruta en lugar de un dominio personalizado, añade rutas para `yoursite.com/mintlify-assets/*` y `yoursite.com/_mintlify/*` junto con la ruta de tu subruta. Estas rutas deben originarse desde la raíz de tu dominio, no desde tu subruta.
+</Warning>
+
 Haz clic en **Deploy** y espera a que se propaguen los cambios.
 
 <Propagating />
@@ -174,8 +184,12 @@ Si usas Webflow para alojar tu sitio principal y quieres servir la documentació
       return await fetch(request);
     }
 
-    // If the request is to the docs subpath
-    if (/^\/docs/.test(urlObject.pathname)) {
+    // If the request is to the docs subpath or a Mintlify asset or API path
+    if (
+      /^\/docs/.test(urlObject.pathname) ||
+      /^\/mintlify-assets\//.test(urlObject.pathname) ||
+      /^\/_mintlify\//.test(urlObject.pathname)
+    ) {
       // Proxy to Mintlify
       const DOCS_URL = "[SUBDOMAIN].mintlify.site";
       const CUSTOM_URL = "[YOUR_DOMAIN]";

diff --git a/es/deploy/route53-cloudfront.mdx b/es/deploy/route53-cloudfront.mdx
@@ -28,10 +28,11 @@ Dirige el tráfico a estas rutas con una política de caché **CachingDisabled**
 - `/.well-known/vercel/*` - Obligatorio para la verificación del dominio
 - `/docs/*` - Obligatorio para el enrutamiento por subruta
 - `/docs/` - Obligatorio para el enrutamiento por subruta
+- `/_mintlify/*` - Obligatorio para las solicitudes del playground de API
 
-Dirige el tráfico a esta ruta con una política de caché **CachingEnabled**:
+Dirige el tráfico a estas rutas con una política de caché **CachingEnabled**:
 
-- `/mintlify-assets/_next/static/*`
+- `/mintlify-assets/*` - Obligatorio para CSS, JavaScript y favicons
 - `Default (*)`	- La página de inicio de tu sitio web
 
 Todos los comportamientos (Behaviors) deben tener una **origin request policy** de `AllViewerExceptHostHeader`.
@@ -167,13 +168,26 @@ Esta configuración debe coincidir exactamente con el comportamiento de tu subru
 - Establece "Viewer protocol policy" en **Redirect HTTP to HTTPS**.
 - Establece "Allowed HTTP methods" en **GET, HEAD, OPTIONS, PUT, POST, PATCH, DELETE**.
 
-<div id="mintlify-assets_nextstatic">
-  ### `/mintlify-assets/_next/static/*`
+<div id="mintlify-assets">
+  ### `/mintlify-assets/*`
 </div>
 
-- Establece la "política de caché" en **CachingOptimized**
- - Establece la "política de solicitud de origen" en **AllViewerExceptHostHeader**
- - Establece la "política de protocolo del visor" en **Redirect HTTP to HTTPS**
+Crea un comportamiento con un **Path pattern** de `/mintlify-assets/*` con **Origin and origin groups** apuntando a la URL `.mintlify.site`. Esta ruta sirve el CSS, JavaScript y favicons de tu documentación desde la raíz de tu dominio.
+
+ - Establece "Cache policy" en **CachingOptimized**.
+ - Establece "Origin request policy" en **AllViewerExceptHostHeader**.
+ - Establece "Viewer protocol policy" en **Redirect HTTP to HTTPS**.
+
+<div id="_mintlify">
+  ### `/_mintlify/*`
+</div>
+
+Crea un comportamiento con un **Path pattern** de `/_mintlify/*` con **Origin and origin groups** apuntando a la URL `.mintlify.site`. Esta ruta gestiona las solicitudes del playground de API desde la raíz de tu dominio.
+
+- Establece "Cache policy" en **CachingDisabled**.
+- Establece "Origin request policy" en **AllViewerExceptHostHeader**.
+- Establece "Viewer protocol policy" en **Redirect HTTP to HTTPS**.
+- Establece "Allowed HTTP methods" en **GET, HEAD, OPTIONS, PUT, POST, PATCH, DELETE**.
 
 <div id="default">
   ### `Default (*)`

diff --git a/fr/deploy/cloudflare.mdx b/fr/deploy/cloudflare.mdx
@@ -82,8 +82,12 @@ async function handleRequest(request) {
       return await fetch(request);
     }
 
-    // Si la requête concerne le sous-chemin docs
-    if (/^\/docs/.test(urlObject.pathname)) {
+    // Si la requête concerne le sous-chemin docs, une ressource Mintlify ou un chemin d'API
+    if (
+      /^\/docs/.test(urlObject.pathname) ||
+      /^\/mintlify-assets\//.test(urlObject.pathname) ||
+      /^\/_mintlify\//.test(urlObject.pathname)
+    ) {
       // Alors rediriger via proxy vers Mintlify
       const DOCS_URL = "[SUBDOMAIN].mintlify.site";
       const CUSTOM_URL = "[YOUR_DOMAIN]";
@@ -108,6 +112,12 @@ async function handleRequest(request) {
 }
 ```
 
+<Warning>
+  En plus de votre sous-chemin, votre Worker doit proxyfier `/mintlify-assets/*`, qui sert le CSS, le JavaScript et les favicons de votre documentation, ainsi que `/_mintlify/*`, qui gère les requêtes du playground d'API.
+
+  Si vous routez le trafic vers votre Worker avec des modèles de route au lieu d'un domaine personnalisé, ajoutez des routes pour `yoursite.com/mintlify-assets/*` et `yoursite.com/_mintlify/*` en plus de la route de votre sous-chemin. Ces chemins doivent partir de la racine de votre domaine, pas de votre sous-chemin.
+</Warning>
+
 Cliquez sur **Deploy** et attendez que les modifications se propagent.
 
 <Propagating />
@@ -175,8 +185,12 @@ Si vous utilisez Webflow pour héberger votre site principal et que vous souhait
       return await fetch(request);
     }
 
-    // Si la requête concerne le sous-chemin docs
-    if (/^\/docs/.test(urlObject.pathname)) {
+    // Si la requête concerne le sous-chemin docs, une ressource Mintlify ou un chemin d'API
+    if (
+      /^\/docs/.test(urlObject.pathname) ||
+      /^\/mintlify-assets\//.test(urlObject.pathname) ||
+      /^\/_mintlify\//.test(urlObject.pathname)
+    ) {
       // Proxy vers Mintlify
       const DOCS_URL = "[SUBDOMAIN].mintlify.site";
       const CUSTOM_URL = "[YOUR_DOMAIN]";

diff --git a/fr/deploy/route53-cloudfront.mdx b/fr/deploy/route53-cloudfront.mdx
@@ -28,10 +28,11 @@ Dirigez le trafic vers ces chemins avec une stratégie de mise en cache (**Cache
 - `/.well-known/vercel/*` - Requis pour la vérification du domaine
 - `/docs/*` - Requis pour le routage par sous-chemin
 - `/docs/` - Requis pour le routage par sous-chemin
+- `/_mintlify/*` - Requis pour les requêtes du playground d'API
 
-Dirigez le trafic vers ce chemin avec une stratégie de mise en cache (**Cache Policy**) de **CachingEnabled** :
+Dirigez le trafic vers ces chemins avec une stratégie de mise en cache (**Cache Policy**) de **CachingEnabled** :
 
-- `/mintlify-assets/_next/static/*`
+- `/mintlify-assets/*` - Requis pour le CSS, le JavaScript et les favicons
 - `Default (*)` - La page d'accueil de votre site web
 
 Tous les Behaviors doivent avoir une **origin request policy** de `AllViewerExceptHostHeader`.
@@ -167,13 +168,26 @@ Ces paramètres doivent correspondre exactement au comportement de votre sous-ch
 - Définissez "Viewer protocol policy" sur **Redirect HTTP to HTTPS**.
 - Définissez "Allowed HTTP methods" sur **GET, HEAD, OPTIONS, PUT, POST, PATCH, DELETE**.
 
-<div id="mintlify-assets_nextstatic">
-  ### `/mintlify-assets/_next/static/*`
+<div id="mintlify-assets">
+  ### `/mintlify-assets/*`
 </div>
 
-- Définissez la « Cache policy » sur **CachingOptimized**
- - Définissez la « Origin request policy » sur **AllViewerExceptHostHeader**
- - Définissez la « Viewer protocol policy » sur **Redirect HTTP to HTTPS**
+Créez un comportement avec un **Path pattern** de `/mintlify-assets/*` et des **Origin and origin groups** pointant vers l'URL `.mintlify.site`. Ce chemin sert le CSS, le JavaScript et les favicons de votre documentation depuis la racine de votre domaine.
+
+ - Définissez « Cache policy » sur **CachingOptimized**.
+ - Définissez « Origin request policy » sur **AllViewerExceptHostHeader**.
+ - Définissez « Viewer protocol policy » sur **Redirect HTTP to HTTPS**.
+
+<div id="_mintlify">
+  ### `/_mintlify/*`
+</div>
+
+Créez un comportement avec un **Path pattern** de `/_mintlify/*` et des **Origin and origin groups** pointant vers l'URL `.mintlify.site`. Ce chemin gère les requêtes du playground d'API depuis la racine de votre domaine.
+
+- Définissez « Cache policy » sur **CachingDisabled**.
+- Définissez « Origin request policy » sur **AllViewerExceptHostHeader**.
+- Définissez « Viewer protocol policy » sur **Redirect HTTP to HTTPS**.
+- Définissez « Allowed HTTP methods » sur **GET, HEAD, OPTIONS, PUT, POST, PATCH, DELETE**.
 
 <div id="default">
   ### `Default (*)`

diff --git a/zh/deploy/cloudflare.mdx b/zh/deploy/cloudflare.mdx
@@ -82,8 +82,12 @@ async function handleRequest(request) {
       return await fetch(request);
     }
 
-    // 如果请求是 docs 子路径
-    if (/^\/docs/.test(urlObject.pathname)) {
+    // 如果请求是 docs 子路径、Mintlify 静态资源或 API 路径
+    if (
+      /^\/docs/.test(urlObject.pathname) ||
+      /^\/mintlify-assets\//.test(urlObject.pathname) ||
+      /^\/_mintlify\//.test(urlObject.pathname)
+    ) {
       // 然后代理到 Mintlify
       const DOCS_URL = "[SUBDOMAIN].mintlify.site";
       const CUSTOM_URL = "[YOUR_DOMAIN]";
@@ -108,6 +112,12 @@ async function handleRequest(request) {
 }
 ```
 
+<Warning>
+  除了你的子路径外，你的 Worker 还必须代理 `/mintlify-assets/*`（用于提供文档的 CSS、JavaScript 和 favicon）以及 `/_mintlify/*`（用于处理 API playground 请求）。
+
+  如果你使用路由模式而非自定义域将流量路由到 Worker，请在子路径路由的基础上，为 `yoursite.com/mintlify-assets/*` 和 `yoursite.com/_mintlify/*` 添加路由。这些路径必须源自你域名的根路径，而不是子路径。
+</Warning>
+
 点击 **Deploy**，然后等待更改生效。
 
 <Propagating />
@@ -175,8 +185,12 @@ async function handleRequest(request) {
       return await fetch(request);
     }
 
-    // 如果请求是文档子路径
-    if (/^\/docs/.test(urlObject.pathname)) {
+    // 如果请求是 docs 子路径、Mintlify 静态资源或 API 路径
+    if (
+      /^\/docs/.test(urlObject.pathname) ||
+      /^\/mintlify-assets\//.test(urlObject.pathname) ||
+      /^\/_mintlify\//.test(urlObject.pathname)
+    ) {
       // 代理到 Mintlify
       const DOCS_URL = "[SUBDOMAIN].mintlify.site";
       const CUSTOM_URL = "[YOUR_DOMAIN]";

diff --git a/zh/deploy/route53-cloudfront.mdx b/zh/deploy/route53-cloudfront.mdx
@@ -28,10 +28,11 @@ import SubpathSetupSteps from "/snippets/zh/subpath-setup-steps.mdx";
 - `/.well-known/vercel/*` - 用于域名验证
 - `/docs/*` - 用于子路径路由
 - `/docs/` - 用于子路径路由
+- `/_mintlify/*` - 用于 API playground 请求
 
 将流量路由到以下路径，并将缓存策略（Cache Policy）设置为 **CachingEnabled**：
 
-- `/mintlify-assets/_next/static/*`
+- `/mintlify-assets/*` - 用于 CSS、JavaScript 和 favicon
 - `Default (*)` - 你的网站着陆页
 
 所有 Behaviors 都必须将 **origin request policy** 设置为 `AllViewerExceptHostHeader`。
@@ -167,13 +168,26 @@ CloudFront 中的行为用于控制子路径逻辑。总体而言，我们希望
 - 将 "Viewer protocol policy" 设置为 **Redirect HTTP to HTTPS**
 - 将 "Allowed HTTP methods" 设置为 **GET, HEAD, OPTIONS, PUT, POST, PATCH, DELETE**
 
-<div id="mintlify-assets_nextstatic">
-  ### `/mintlify-assets/_next/static/*`
+<div id="mintlify-assets">
+  ### `/mintlify-assets/*`
 </div>
 
-- 将“Cache policy”设置为 **CachingOptimized**
- - 将“Origin request policy”设置为 **AllViewerExceptHostHeader**
- - 将“Viewer protocol policy”设置为 **Redirect HTTP to HTTPS**
+创建一个行为，在 **Path pattern** 中填写 `/mintlify-assets/*`，并将 **Origin and origin groups** 指向 `.mintlify.site` 的 URL。此路径从你域名的根路径提供文档的 CSS、JavaScript 和 favicon。
+
+ - 将 "Cache policy" 设置为 **CachingOptimized**。
+ - 将 "Origin request policy" 设置为 **AllViewerExceptHostHeader**。
+ - 将 "Viewer protocol policy" 设置为 **Redirect HTTP to HTTPS**。
+
+<div id="_mintlify">
+  ### `/_mintlify/*`
+</div>
+
+创建一个行为，在 **Path pattern** 中填写 `/_mintlify/*`，并将 **Origin and origin groups** 指向 `.mintlify.site` 的 URL。此路径从你域名的根路径处理 API playground 请求。
+
+- 将 "Cache policy" 设置为 **CachingDisabled**。
+- 将 "Origin request policy" 设置为 **AllViewerExceptHostHeader**。
+- 将 "Viewer protocol policy" 设置为 **Redirect HTTP to HTTPS**。
+- 将 "Allowed HTTP methods" 设置为 **GET, HEAD, OPTIONS, PUT, POST, PATCH, DELETE**。
 
 <div id="default">
   ### `Default (*)`