Add documentation for API playground prefill feature

api-playground/overview.mdx

@@ -14,7 +14,7 @@
 
 The playground is automatically generated from your OpenAPI specification or AsyncAPI schema so any updates to your API are automatically reflected in the playground. You can also manually create API reference pages after defining a base URL and authentication method in your `docs.json`.
 
 We recommend generating your API playground from an OpenAPI specification. See [OpenAPI Setup](/api-playground/openapi-setup) for more information on creating your OpenAPI document.
 
 ## Getting started
 
@@ -78,7 +78,7 @@
     <Expandable title="playground" defaultOpen="True">
     <ResponseField name="display" type="&quot;interactive&quot; | &quot;simple&quot; | &quot;none&quot;">
         The display mode of the API playground.
         - `"interactive"`: Display the interactive playground.
         - `"simple"`: Display a copyable endpoint with no playground.
         - `"none"`: Display nothing.
 
@@ -101,6 +101,9 @@
         <ResponseField name="defaults" type="&quot;required&quot; | &quot;all&quot;">
         Whether to show optional parameters in API examples. Defaults to `all`.
     </ResponseField>
+    <ResponseField name="prefill" type="boolean">
+        Whether to prefill the API playground with data from schema examples. When enabled, the playground automatically populates request fields with example values from your OpenAPI specification. Defaults to `false`.
+    </ResponseField>
     </Expandable>
 </ResponseField>
 
@@ -114,13 +117,14 @@
    },
    "examples": {
      "languages": ["curl", "python", "javascript"],
-     "defaults": "required"
+     "defaults": "required",
+     "prefill": true
    }
  }
 }
 ```
 
-This example configures the API playground to be interactive with example code snippets for cURL, Python, and JavaScript. Only required parameters are shown in the code snippets.
+This example configures the API playground to be interactive with example code snippets for cURL, Python, and JavaScript. Only required parameters are shown in the code snippets, and the playground prefills the request body with example values.
 
 ### Custom endpoint pages
 
@@ -132,9 +136,9 @@
 - Add additional content like examples
 - Control playground behavior per page
 
 The `x-mint` extension is recommended so that all of your API documentation is automatically generated from your OpenAPI specification and maintained in one file.
 
 Individual `MDX` pages are recommended for small APIs or when you want to experiment with changes on a per-page basis.
 
 For more information, see [x-mint extension](/api-playground/openapi-setup#x-mint-extension) and [MDX Setup](/api-playground/mdx/configuration).
 

organize/settings.mdx

@@ -217,7 +217,7 @@
           Font weight, such as 400, 700. Variable fonts support precise weights such as 550.
         </ResponseField>
         <ResponseField name="source" type="string (uri)">
           URL to your font source, such as https://mintlify-assets.b-cdn.net/fonts/Hubot-Sans.woff2. [Google Fonts](https://fonts.google.com) are loaded automatically when you specify a Google Font `family` name, so no source URL is needed.
         </ResponseField>
         <ResponseField name="format" type="&quot;woff&quot; | &quot;woff2&quot;">
           Font file format.
@@ -493,7 +493,7 @@
 
   <Expandable title="Interaction">
     <ResponseField name="drilldown" type="boolean">
       Control automatic navigation behavior when selecting navigation groups. Set to `true` to force navigation to the first page when a navigation group is expanded. Set to `false` to prevent navigation and only expand or collapse the group. Leave unset to use the theme's default behavior.
     </ResponseField>
   </Expandable>
 </ResponseField>
@@ -570,7 +570,7 @@
       Destination path to redirect to. Example: `/new-page`
     </ResponseField>
     <ResponseField name="permanent" type="boolean">
       Whether to use a permanent redirect (301). Defaults to `true`.
     </ResponseField>
   </Expandable>
 </ResponseField>
@@ -581,13 +581,13 @@
   <Expandable title="Contextual">
     <ResponseField name="options" type="array of &quot;copy&quot; | &quot;view&quot; | &quot;chatgpt&quot; | &quot;claude&quot; | &quot;perplexity&quot; | &quot;mcp&quot; | &quot;cursor&quot; | &quot;vscode&quot;" required>
       Actions available in the contextual menu. The first option appears as the default.
       - `copy`: Copy the current page as Markdown to the clipboard.
       - `view`: View the current page as Markdown in a new tab.
       - `chatgpt`: Send the current page content to ChatGPT.
       - `claude`: Send the current page content to Claude.
       - `perplexity`: Send the current page content to Perplexity.
       - `mcp`: Copies your MCP server URL to the clipboard.
       - `cursor`: Installs your hosted MCP server in Cursor.
       - `vscode`: Installs your hosted MCP server in VSCode.
 
       <img src="/images/page-context-menu.png" alt="Contextual Menu" className="rounded-xl" />
@@ -600,7 +600,7 @@
   </Expandable>
 </ResponseField>
 
 ### API Configurations
 
 <ResponseField name="api" type="object">
   API documentation and interactive playground settings.
@@ -669,6 +669,9 @@
          <ResponseField name="defaults" type="&quot;required&quot; | &quot;all&quot;">
           Whether to show optional parameters in API examples. Defaults to `all`.
         </ResponseField>
+        <ResponseField name="prefill" type="boolean">
+          Whether to prefill the API playground with data from schema examples. When enabled, the playground automatically populates request fields with example values from your OpenAPI specification. Defaults to `false`.
+        </ResponseField>
       </Expandable>
     </ResponseField>
     <ResponseField name="mdx" type="object">
@@ -696,10 +699,10 @@
   </Expandable>
 </ResponseField>
 
 ### SEO and search
 
 <ResponseField name="seo" type="object">
   SEO indexing configurations.
 
   <Expandable title="Seo">
     <ResponseField name="metatags" type="object">
@@ -935,7 +938,7 @@
       404 "Page not found" error handling.
       <Expandable title="404">
         <ResponseField name="redirect" type="boolean">
           Whether to automatically redirect to the home page when a page is not
           found.
         </ResponseField>
         <ResponseField name="title" type="string">
@@ -1491,7 +1494,7 @@
 
 </CodeGroup>
 
 If you already have the CLI installed, make sure it is up to date:
 
 ```bash
 mint update
@@ -1505,7 +1508,7 @@
 mint upgrade
 ```
 
 This command will create a `docs.json` file from your existing `mint.json`. Review the generated file to ensure all settings are correct.
 </Step>
 <Step title="Delete your mint.json file">
 After verifying your `docs.json` is configured properly, you can safely delete your old `mint.json` file.