Claude Code's commit

Author: ethanpalm

api-playground/mdx/configuration.mdx

@@ -68,6 +68,51 @@ To generate pages for API endpoints using `MDX`, configure your API settings in
     playground: 'none'
     ---
     ```
+
+    ## Page-level playground control
+
+    The `playground` frontmatter property allows you to control the API playground functionality on individual pages, overriding any global settings defined in `docs.json`. This is particularly useful for endpoints that don't benefit from interactive testing.
+
+    ### Available options
+
+    - `playground: 'interactive'` - Full interactive playground with request forms and response display
+    - `playground: 'simple'` - Shows a copyable endpoint with no interactive elements
+    - `playground: 'none'` - Completely hides the playground section
+
+    ### Common use cases
+
+    **Webhook endpoints**: Since webhooks are triggered by external systems rather than user requests, an interactive playground isn't useful. Use `playground: 'none'` to focus on documentation:
+
+    ```mdx
+    ---
+    title: 'Order Status Webhook'
+    api: 'POST https://api.yoursite.com/webhooks/order-status'
+    playground: 'none'
+    ---
+
+    This webhook is triggered when an order status changes in our system.
+    Configure your webhook endpoint to receive these notifications.
+    ```
+
+    **Internal or admin endpoints**: For endpoints that shouldn't be tested by regular users:
+
+    ```mdx
+    ---
+    title: 'Admin User Management'
+    api: 'DELETE https://api.yoursite.com/admin/users/{id}'
+    playground: 'simple'
+    ---
+    ```
+
+    **Documentation-heavy endpoints**: When you want to emphasize written documentation over interactive testing:
+
+    ```mdx
+    ---
+    title: 'Complex Analytics Query'
+    api: 'POST https://api.yoursite.com/analytics/query'
+    playground: 'simple'
+    ---
+    ```
 
   </Step>
 

api-playground/overview.mdx

@@ -112,6 +112,7 @@ When you need more control over your API documentation, create individual `MDX`
 - Add additional content like examples
 - Hide specific operations
 - Reorder pages in your navigation
+- Control playground behavior per page (useful for webhooks and admin endpoints)
 
 See [MDX Setup](/api-playground/mdx/configuration) for more information on creating individual pages for your API endpoints.