From b0c6fa1b898c5a0da1b47c1ac6029d5b55012650 Mon Sep 17 00:00:00 2001 From: royce Date: Thu, 27 Aug 2026 23:24:27 +0000 Subject: [PATCH 1/5] Document x-mint playground expandSections setting Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> --- api-playground/openapi-setup.mdx | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/api-playground/openapi-setup.mdx b/api-playground/openapi-setup.mdx index 665d9024c..93c9b95a9 100644 --- a/api-playground/openapi-setup.mdx +++ b/api-playground/openapi-setup.mdx @@ -311,6 +311,27 @@ Set the URL of the autogenerated endpoint page using `x-mint: href`. When `x-min } ``` +### Collapse playground sections + +Collapse the request sections of the API playground by default using `x-mint: playground` with `expandSections: false` on any operation. When collapsed, readers expand only the sections they want to interact with, like Authorization, Headers, Query, Path, Body, and Server. Sections are expanded by default when `expandSections` is not set. + +```json {6-10} +{ + "paths": { + "/users": { + "get": { + "summary": "Get users", + "x-mint": { + "playground": { + "expandSections": false + } + } + } + } + } +} +``` + ### Parameter pills Annotate parameters in the API reference and playground with custom pill labels using `x-mint.pre` and `x-mint.post` on any schema. Pills defined with `x-mint.pre` render before the parameter name, and pills defined with `x-mint.post` render after it, alongside Mintlify's built-in pills like `required`, `read-only`, and `write-only`. From a9b43fd3fb81e5917ffe023a47361e1674e24eaa Mon Sep 17 00:00:00 2001 From: royce Date: Fri, 28 Aug 2026 17:17:04 +0000 Subject: [PATCH 2/5] Apply review suggestion to expandSections wording Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> --- api-playground/openapi-setup.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-playground/openapi-setup.mdx b/api-playground/openapi-setup.mdx index 93c9b95a9..a01ae456f 100644 --- a/api-playground/openapi-setup.mdx +++ b/api-playground/openapi-setup.mdx @@ -313,7 +313,7 @@ Set the URL of the autogenerated endpoint page using `x-mint: href`. When `x-min ### Collapse playground sections -Collapse the request sections of the API playground by default using `x-mint: playground` with `expandSections: false` on any operation. When collapsed, readers expand only the sections they want to interact with, like Authorization, Headers, Query, Path, Body, and Server. Sections are expanded by default when `expandSections` is not set. +Collapse the request sections of the API playground by default using `x-mint: playground` with `expandSections: false` on any operation. When collapsed, readers expand only the sections they want to interact with, like Authorization, Headers, Query, Path, Body, and Server. If `expandSections` is not set, sections are expanded by default. ```json {6-10} { From 3bbae3d806f0f07694fa63b92eb8e6222162bcd1 Mon Sep 17 00:00:00 2001 From: royce Date: Fri, 28 Aug 2026 23:12:46 +0000 Subject: [PATCH 3/5] Update expandSections docs for nested object field behavior Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> --- api-playground/openapi-setup.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/api-playground/openapi-setup.mdx b/api-playground/openapi-setup.mdx index a01ae456f..fc24f6386 100644 --- a/api-playground/openapi-setup.mdx +++ b/api-playground/openapi-setup.mdx @@ -311,9 +311,9 @@ Set the URL of the autogenerated endpoint page using `x-mint: href`. When `x-min } ``` -### Collapse playground sections +### Collapse playground fields -Collapse the request sections of the API playground by default using `x-mint: playground` with `expandSections: false` on any operation. When collapsed, readers expand only the sections they want to interact with, like Authorization, Headers, Query, Path, Body, and Server. If `expandSections` is not set, sections are expanded by default. +Collapse object-type fields in the API playground by default using `x-mint: playground` with `expandSections: false` on any operation. Request sections like Authorization, Headers, Query, Path, and Body always stay expanded, but object fields nested within them start collapsed so readers expand only the fields they want to interact with. If `expandSections` is not set, object fields are expanded by default. ```json {6-10} { From 80c3329518b165229f0c8b232dd16b6e9df03b37 Mon Sep 17 00:00:00 2001 From: royce Date: Fri, 28 Aug 2026 23:38:59 +0000 Subject: [PATCH 4/5] Clarify that the top-level body object stays expanded Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> --- api-playground/openapi-setup.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-playground/openapi-setup.mdx b/api-playground/openapi-setup.mdx index fc24f6386..5332664fd 100644 --- a/api-playground/openapi-setup.mdx +++ b/api-playground/openapi-setup.mdx @@ -313,7 +313,7 @@ Set the URL of the autogenerated endpoint page using `x-mint: href`. When `x-min ### Collapse playground fields -Collapse object-type fields in the API playground by default using `x-mint: playground` with `expandSections: false` on any operation. Request sections like Authorization, Headers, Query, Path, and Body always stay expanded, but object fields nested within them start collapsed so readers expand only the fields they want to interact with. If `expandSections` is not set, object fields are expanded by default. +Collapse object-type fields in the API playground by default using `x-mint: playground` with `expandSections: false` on any operation. Request sections like Authorization, Headers, Query, Path, and Body always stay expanded, and the top-level body object stays expanded, but object fields nested within them start collapsed so readers expand only the fields they want to interact with. If `expandSections` is not set, object fields are expanded by default. ```json {6-10} { From 8f092cb105c96f46e3bd98622558f8730186f928 Mon Sep 17 00:00:00 2001 From: royce Date: Sat, 29 Aug 2026 00:15:42 +0000 Subject: [PATCH 5/5] Rename playground setting to expand Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> --- api-playground/openapi-setup.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/api-playground/openapi-setup.mdx b/api-playground/openapi-setup.mdx index 5332664fd..571a748be 100644 --- a/api-playground/openapi-setup.mdx +++ b/api-playground/openapi-setup.mdx @@ -313,7 +313,7 @@ Set the URL of the autogenerated endpoint page using `x-mint: href`. When `x-min ### Collapse playground fields -Collapse object-type fields in the API playground by default using `x-mint: playground` with `expandSections: false` on any operation. Request sections like Authorization, Headers, Query, Path, and Body always stay expanded, and the top-level body object stays expanded, but object fields nested within them start collapsed so readers expand only the fields they want to interact with. If `expandSections` is not set, object fields are expanded by default. +Collapse object-type fields in the API playground by default using `x-mint: playground` with `expand: false` on any operation. Request sections like Authorization, Headers, Query, Path, and Body always stay expanded, and the top-level body object stays expanded, but object fields nested within them start collapsed so readers expand only the fields they want to interact with. If `expand` is not set, object fields are expanded by default. ```json {6-10} { @@ -323,7 +323,7 @@ Collapse object-type fields in the API playground by default using `x-mint: play "summary": "Get users", "x-mint": { "playground": { - "expandSections": false + "expand": false } } }