From 2327c5323b24d7770abcb7574c4ed8c62de6c400 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Mon, 1 Dec 2025 19:03:01 +0000 Subject: [PATCH 1/3] Update organize/navigation.mdx --- organize/navigation.mdx | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/organize/navigation.mdx b/organize/navigation.mdx index 5574bec3a..5e18678fd 100644 --- a/organize/navigation.mdx +++ b/organize/navigation.mdx @@ -399,6 +399,10 @@ Integrate OpenAPI specifications directly into your navigation structure to auto Set a default OpenAPI specification at any level of your navigation hierarchy. Child elements will inherit this specification unless they define their own specification. + + When you add the `openapi` property to a navigation element (such as an anchor, tab, or group) without specifying any pages, Mintlify automatically generates pages for **all endpoints** defined in your OpenAPI specification. To control which endpoints appear, explicitly list the desired endpoints in the `pages` array. + + ```json { "navigation": { From f4d5d8a8700922052d99a1821221a1b6d5746b95 Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Mon, 1 Dec 2025 11:26:10 -0800 Subject: [PATCH 2/3] move for more info link higher --- organize/navigation.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/organize/navigation.mdx b/organize/navigation.mdx index 5e18678fd..bf939c16e 100644 --- a/organize/navigation.mdx +++ b/organize/navigation.mdx @@ -403,6 +403,8 @@ Set a default OpenAPI specification at any level of your navigation hierarchy. C When you add the `openapi` property to a navigation element (such as an anchor, tab, or group) without specifying any pages, Mintlify automatically generates pages for **all endpoints** defined in your OpenAPI specification. To control which endpoints appear, explicitly list the desired endpoints in the `pages` array. +For more information about referencing OpenAPI endpoints in your docs, see the [OpenAPI setup](/api-playground/openapi-setup). + ```json { "navigation": { @@ -430,8 +432,6 @@ Set a default OpenAPI specification at any level of your navigation hierarchy. C } ``` -For more information about referencing OpenAPI endpoints in your docs, see the [OpenAPI setup](/api-playground/openapi-setup). - ## Versions Partition your navigation into different versions. Versions are selectable from a dropdown menu. From ff711c021324f54aefb40b6f792fb8c94587d3fc Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Mon, 1 Dec 2025 11:27:35 -0800 Subject: [PATCH 3/3] use note --- organize/navigation.mdx | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/organize/navigation.mdx b/organize/navigation.mdx index bf939c16e..18098420f 100644 --- a/organize/navigation.mdx +++ b/organize/navigation.mdx @@ -399,9 +399,11 @@ Integrate OpenAPI specifications directly into your navigation structure to auto Set a default OpenAPI specification at any level of your navigation hierarchy. Child elements will inherit this specification unless they define their own specification. - - When you add the `openapi` property to a navigation element (such as an anchor, tab, or group) without specifying any pages, Mintlify automatically generates pages for **all endpoints** defined in your OpenAPI specification. To control which endpoints appear, explicitly list the desired endpoints in the `pages` array. - + + When you add the `openapi` property to a navigation element (such as an anchor, tab, or group) without specifying any pages, Mintlify automatically generates pages for **all endpoints** defined in your OpenAPI specification. + + To control which endpoints appear, explicitly list the desired endpoints in a `pages` array. + For more information about referencing OpenAPI endpoints in your docs, see the [OpenAPI setup](/api-playground/openapi-setup).