Pre-fill API Playground with OpenAPI Examples

[dzimiks]

Problem

Currently, when users click "Try it" in the API playground, all input fields are empty, even though the OpenAPI spec includes examples for each endpoint and field. This creates unnecessary friction as developers must manually copy-paste or type example values to test endpoints.

Proposed Solution

Auto-populate the API playground form fields with the example values defined in the OpenAPI specification when users click "Try it".

This should work for:

• Request body examples
• Query parameters with example values
• Header parameters with examples

Expected Behavior

1. User navigates to an endpoint
2. User clicks "Try it"
3. Form fields are automatically populated with the examples from the OpenAPI spec
4. User can immediately send the request or modify values as needed

Current vs Expected

Current: Empty form fields requiring manual input
Expected: Pre-filled form with working examples, allowing instant testing

Benefits

• Faster developer onboarding and API exploration
• Reduced friction in testing endpoints
• Better developer experience matching the quality of the documentation examples

This feature would significantly improve the developer experience by enabling immediate API testing without manual data entry.

[kum0r]

Came here to add exactly this to the feedback. This is especially an acute problem when the request is big and complicated. I'll upvote this with a +1

[dzimiks]

I accidentally discovered that Mintlify's team has already implemented this feature, but only for the default field.
If I add a default field to a schema property, it will be used in the API modal. This means you need to implement this small fix:

1. Use the default field to pre-populate the modal
2. If it doesn't exist, use the example field for the same purpose
3. If neither exists, leave the field empty

[adriencohen]

This workaround doesn't work for the code samples shown on the side of the endpoint page. It would be great to have it supported there as well. In "Try it" I was also only able to make it work by defining a default, which goes against the OpenAPI specification. It should always work with example if the field is required.