From 3bca9e48cbba1c7eb72037bf235fcd3ae75815c4 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 28 May 2026 20:17:25 +0000 Subject: [PATCH 1/7] docs: add downloadApiSpec contextual menu option --- ai/contextual-menu.mdx | 4 +++- docs.json | 2 +- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/ai/contextual-menu.mdx b/ai/contextual-menu.mdx index b1a75dbff9..ae9ed46c2b 100644 --- a/ai/contextual-menu.mdx +++ b/ai/contextual-menu.mdx @@ -34,6 +34,7 @@ The contextual menu includes several pre-built options that you can enable by ad | **Connect to Cursor** | `cursor` | Installs your hosted MCP server in Cursor | | **Connect to VS Code** | `vscode` | Installs your hosted MCP server in VS Code | | **Connect to Devin** | `devin-mcp` | Installs your hosted MCP server in Devin | +| **Download API spec** | `downloadApiSpec` | Downloads your deployment's OpenAPI spec. If multiple specs are configured, downloads them as a zip archive. | | **Custom options** | Object | Add custom options to the contextual menu | @@ -64,7 +65,8 @@ Add the `contextual` field to your `docs.json` file and specify which options yo "mcp", "cursor", "vscode", - "devin-mcp" + "devin-mcp", + "downloadApiSpec" ] } } diff --git a/docs.json b/docs.json index 90e6846eb9..ad8366edfb 100644 --- a/docs.json +++ b/docs.json @@ -554,7 +554,7 @@ "contextual": { "options": [ "copy", - "download-spec", + "downloadApiSpec", "chatgpt", "claude", "add-mcp", From 97173995affc47a24e5ec48828a9787024dd2c95 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 28 May 2026 20:18:59 +0000 Subject: [PATCH 2/7] docs: mirror downloadApiSpec option in es and fr translations --- es/ai/contextual-menu.mdx | 4 +++- fr/ai/contextual-menu.mdx | 4 +++- 2 files changed, 6 insertions(+), 2 deletions(-) diff --git a/es/ai/contextual-menu.mdx b/es/ai/contextual-menu.mdx index b7847da170..85bfbcf0fe 100644 --- a/es/ai/contextual-menu.mdx +++ b/es/ai/contextual-menu.mdx @@ -36,6 +36,7 @@ El menú contextual incluye varias opciones preconfiguradas que puedes habilitar | **Conectar con Cursor** | `cursor` | Instala tu servidor MCP alojado en Cursor | | **Conectar con VS Code** | `vscode` | Instala tu servidor MCP alojado en VS Code | | **Conectar con Devin** | `devin-mcp` | Instala tu servidor MCP alojado en Devin | +| **Descargar especificación de API** | `downloadApiSpec` | Descarga la especificación OpenAPI de tu despliegue. Si hay varias especificaciones configuradas, las descarga como un archivo zip. | | **Opciones personalizadas** | Object | Agrega opciones personalizadas al menú contextual | @@ -65,7 +66,8 @@ Añade el campo `contextual` a tu archivo `docs.json` y especifica qué opciones "mcp", "cursor", "vscode", - "devin-mcp" + "devin-mcp", + "downloadApiSpec" ] } } diff --git a/fr/ai/contextual-menu.mdx b/fr/ai/contextual-menu.mdx index 21f6bfb719..6abbaa34ea 100644 --- a/fr/ai/contextual-menu.mdx +++ b/fr/ai/contextual-menu.mdx @@ -36,6 +36,7 @@ Le menu contextuel comprend plusieurs options prédéfinies que vous pouvez acti | **Se connecter à Cursor** | `cursor` | Installe votre serveur MCP hébergé dans Cursor | | **Se connecter à VS Code** | `vscode` | Installe votre serveur MCP hébergé dans VS Code | | **Se connecter à Devin** | `devin-mcp` | Installe votre serveur MCP hébergé dans Devin | +| **Télécharger la spécification d'API** | `downloadApiSpec` | Télécharge la spécification OpenAPI de votre déploiement. Si plusieurs spécifications sont configurées, les télécharge dans une archive zip. | | **Options personnalisées** | Objet | Ajoutez des options personnalisées au menu contextuel | @@ -65,7 +66,8 @@ Ajoutez le champ `contextual` à votre fichier `docs.json` et indiquez les optio "mcp", "cursor", "vscode", - "devin-mcp" + "devin-mcp", + "downloadApiSpec" ] } } From 9eb3046b7c54cc77995511e98cfd092667849c7a Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Fri, 29 May 2026 15:19:19 +0000 Subject: [PATCH 3/7] docs: note downloadApiSpec is gated to API reference pages and auth-aware --- ai/contextual-menu.mdx | 6 +++++- es/ai/contextual-menu.mdx | 6 +++++- fr/ai/contextual-menu.mdx | 6 +++++- 3 files changed, 15 insertions(+), 3 deletions(-) diff --git a/ai/contextual-menu.mdx b/ai/contextual-menu.mdx index ae9ed46c2b..be0936741f 100644 --- a/ai/contextual-menu.mdx +++ b/ai/contextual-menu.mdx @@ -34,7 +34,7 @@ The contextual menu includes several pre-built options that you can enable by ad | **Connect to Cursor** | `cursor` | Installs your hosted MCP server in Cursor | | **Connect to VS Code** | `vscode` | Installs your hosted MCP server in VS Code | | **Connect to Devin** | `devin-mcp` | Installs your hosted MCP server in Devin | -| **Download API spec** | `downloadApiSpec` | Downloads your deployment's OpenAPI spec. If multiple specs are configured, downloads them as a zip archive. | +| **Download API spec** | `downloadApiSpec` | Downloads your deployment's OpenAPI spec. If multiple specs are configured, downloads them as a zip archive. Only appears on API reference pages. | | **Custom options** | Object | Add custom options to the contextual menu | @@ -44,6 +44,10 @@ The contextual menu includes several pre-built options that you can enable by ad /> + + The `downloadApiSpec` option only appears on API reference pages (pages whose frontmatter declares `api`, `openapi`, or `asyncapi`). On deployments with authentication or user authentication enabled, only authenticated viewers can download the spec. + + ## Enable the contextual menu Add the `contextual` field to your `docs.json` file and specify which options you want to include. diff --git a/es/ai/contextual-menu.mdx b/es/ai/contextual-menu.mdx index 85bfbcf0fe..a8907208f2 100644 --- a/es/ai/contextual-menu.mdx +++ b/es/ai/contextual-menu.mdx @@ -36,13 +36,17 @@ El menú contextual incluye varias opciones preconfiguradas que puedes habilitar | **Conectar con Cursor** | `cursor` | Instala tu servidor MCP alojado en Cursor | | **Conectar con VS Code** | `vscode` | Instala tu servidor MCP alojado en VS Code | | **Conectar con Devin** | `devin-mcp` | Instala tu servidor MCP alojado en Devin | -| **Descargar especificación de API** | `downloadApiSpec` | Descarga la especificación OpenAPI de tu despliegue. Si hay varias especificaciones configuradas, las descarga como un archivo zip. | +| **Descargar especificación de API** | `downloadApiSpec` | Descarga la especificación OpenAPI de tu despliegue. Si hay varias especificaciones configuradas, las descarga como un archivo zip. Solo aparece en páginas de referencia de API. | | **Opciones personalizadas** | Object | Agrega opciones personalizadas al menú contextual | El menú contextual expandido que muestra los elementos del menú Copiar página, Ver como Markdown, Abrir en ChatGPT y Abrir en Claude. + + La opción `downloadApiSpec` solo aparece en páginas de referencia de API (páginas cuyo frontmatter declara `api`, `openapi` o `asyncapi`). En despliegues con autenticación o autenticación de usuario habilitada, solo los lectores autenticados pueden descargar la especificación. + +
## Activar el menú contextual
diff --git a/fr/ai/contextual-menu.mdx b/fr/ai/contextual-menu.mdx index 6abbaa34ea..6bf80f8787 100644 --- a/fr/ai/contextual-menu.mdx +++ b/fr/ai/contextual-menu.mdx @@ -36,13 +36,17 @@ Le menu contextuel comprend plusieurs options prédéfinies que vous pouvez acti | **Se connecter à Cursor** | `cursor` | Installe votre serveur MCP hébergé dans Cursor | | **Se connecter à VS Code** | `vscode` | Installe votre serveur MCP hébergé dans VS Code | | **Se connecter à Devin** | `devin-mcp` | Installe votre serveur MCP hébergé dans Devin | -| **Télécharger la spécification d'API** | `downloadApiSpec` | Télécharge la spécification OpenAPI de votre déploiement. Si plusieurs spécifications sont configurées, les télécharge dans une archive zip. | +| **Télécharger la spécification d'API** | `downloadApiSpec` | Télécharge la spécification OpenAPI de votre déploiement. Si plusieurs spécifications sont configurées, les télécharge dans une archive zip. N'apparaît que sur les pages de référence d'API. | | **Options personnalisées** | Objet | Ajoutez des options personnalisées au menu contextuel | Le menu contextuel développé affichant les éléments Copier la page, Afficher en Markdown, Ouvrir dans ChatGPT et Ouvrir dans Claude. + + L'option `downloadApiSpec` n'apparaît que sur les pages de référence d'API (pages dont le frontmatter déclare `api`, `openapi` ou `asyncapi`). Sur les déploiements avec authentification ou authentification utilisateur activée, seuls les lecteurs authentifiés peuvent télécharger la spécification. + +
## Activer le menu contextuel
From f9308dc40bc8666947d084a673fe7fd462d2b6e6 Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Fri, 29 May 2026 10:48:07 -0700 Subject: [PATCH 4/7] Apply suggestion from @ethanpalm --- ai/contextual-menu.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ai/contextual-menu.mdx b/ai/contextual-menu.mdx index be0936741f..77009c32f6 100644 --- a/ai/contextual-menu.mdx +++ b/ai/contextual-menu.mdx @@ -34,7 +34,7 @@ The contextual menu includes several pre-built options that you can enable by ad | **Connect to Cursor** | `cursor` | Installs your hosted MCP server in Cursor | | **Connect to VS Code** | `vscode` | Installs your hosted MCP server in VS Code | | **Connect to Devin** | `devin-mcp` | Installs your hosted MCP server in Devin | -| **Download API spec** | `downloadApiSpec` | Downloads your deployment's OpenAPI spec. If multiple specs are configured, downloads them as a zip archive. Only appears on API reference pages. | +| **Download API spec** | `download-spec` | Downloads your deployment's OpenAPI spec. If there are multiple specs, downloads them as a zip archive. Only appears on API reference pages. | | **Custom options** | Object | Add custom options to the contextual menu | From 34a6be27b0ba7c52b277fac07d5d479ad999ddef Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Fri, 29 May 2026 10:48:32 -0700 Subject: [PATCH 5/7] Apply suggestion from @ethanpalm --- ai/contextual-menu.mdx | 4 ---- 1 file changed, 4 deletions(-) diff --git a/ai/contextual-menu.mdx b/ai/contextual-menu.mdx index 77009c32f6..27346d6675 100644 --- a/ai/contextual-menu.mdx +++ b/ai/contextual-menu.mdx @@ -44,10 +44,6 @@ The contextual menu includes several pre-built options that you can enable by ad /> - - The `downloadApiSpec` option only appears on API reference pages (pages whose frontmatter declares `api`, `openapi`, or `asyncapi`). On deployments with authentication or user authentication enabled, only authenticated viewers can download the spec. - - ## Enable the contextual menu Add the `contextual` field to your `docs.json` file and specify which options you want to include. From adc9dfca32c6302ea7e47080d052fb704d08cc86 Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Fri, 29 May 2026 10:49:06 -0700 Subject: [PATCH 6/7] Apply suggestion from @ethanpalm --- ai/contextual-menu.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ai/contextual-menu.mdx b/ai/contextual-menu.mdx index 27346d6675..31a964a1a5 100644 --- a/ai/contextual-menu.mdx +++ b/ai/contextual-menu.mdx @@ -66,7 +66,7 @@ Add the `contextual` field to your `docs.json` file and specify which options yo "cursor", "vscode", "devin-mcp", - "downloadApiSpec" + "download-spec" ] } } From b6b4943051e8657e6c1b46b694a3b92a1aa66aba Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Fri, 29 May 2026 10:49:28 -0700 Subject: [PATCH 7/7] Apply suggestion from @ethanpalm --- docs.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs.json b/docs.json index ad8366edfb..90e6846eb9 100644 --- a/docs.json +++ b/docs.json @@ -554,7 +554,7 @@ "contextual": { "options": [ "copy", - "downloadApiSpec", + "download-spec", "chatgpt", "claude", "add-mcp",