Document parameter labels and api.params.post

[mintlify]

Summary

Documents a new feature that lets users add custom labels next to a parameter's type in the API reference and playground.

• Adds a "Parameter labels" section to api-playground/openapi-setup.mdx covering the new x-mint.pre and x-mint.post extensions on OpenAPI schema properties, with an example.
• Documents the new api.params.post setting in organize/settings-api.mdx for surfacing arbitrary OpenAPI fields (including custom x- extensions) as labels on every parameter, with value-type rules and the existing example updated.

Triggering change

Adds support for mapping OpenAPI spec fields onto parameter labels in the playground. Users can configure a list of schema field keys in docs.json to render as labels, or set per-property labels via x-mint.pre / x-mint.post.

---

Note

Low Risk
Low risk documentation-only change describing new parameter label configuration and updating examples; no runtime or security-sensitive code is modified.

Overview
Adds documentation for parameter type labels in the API reference/playground, describing per-property labels via OpenAPI x-mint.pre/x-mint.post (with an example) and noting automatic readOnly/writeOnly labels.

Documents the new docs.json setting api.params.post to surface specified OpenAPI schema fields (including custom x- extensions) as labels across all parameters, and updates the api.params example to include post.

^{Reviewed by Cursor Bugbot for commit 40b7bc5. Bugbot is set up for automated code reviews on this repo. Configure here.}

[mintlify-development]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
userauth	🟢 Ready	View Preview	Apr 27, 2026, 7:16 PM

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
mintlify	🟢 Ready	View Preview	Apr 27, 2026, 7:15 PM

[ethanpalm]

Closing as duplicate of #5545. Both PRs document the same x-mint.pre/x-mint.post and api.params.post parameter label feature. PR #5545 is more comprehensive, including a full api.params.post JSON example and pill ordering details. Please review #5545 instead.