Skip to content

Update from code changes: document API Playground variables - #6882

Open
mintlify[bot] wants to merge 2 commits into
mainfrom
mintlify/document-api-playground-server-variables
Open

Update from code changes: document API Playground variables#6882
mintlify[bot] wants to merge 2 commits into
mainfrom
mintlify/document-api-playground-server-variables

Conversation

@mintlify

@mintlify mintlify Bot commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

Summary

Documents the new client API for pre-filling OpenAPI API Playground server variables from custom JavaScript.

Changes

  • Covers setting, replacing, clearing, queuing, and live application of runtime server-variable values
  • Explains authentication and tenant-switch use cases, session-only behavior, fallback precedence, and non-secret requirements
  • Adds matching Spanish, French, and Chinese guidance

Context

The triggering source change exposes these methods under window.mintlify.api.playground.

https://github.com/mintlify/mint/pull/9823


Note

Low Risk
Documentation-only changes to MDX; no application or runtime code is modified.

Overview
Documents how custom JavaScript can drive OpenAPI API Playground server variables via window.mintlify.api.playground.setServerVariables and clearServerVariables, including English, Spanish, French, and Chinese updates to Custom scripts.

The new section explains post-load use cases (auth SDK init, tenant changes), that each setServerVariables call replaces the full in-memory override (omitted keys drop off), runtime values beat OpenAPI defaults and saved values, and clear restores configured fallbacks. It also notes pre-init queuing, updates to open and future playgrounds, session-only storage (no localStorage/credentials; refresh clears), and a warning to use non-secret values only.

Page description and keywords are extended to mention API Playground server variables.

Reviewed by Cursor Bugbot for commit 128da93. Bugbot is set up for automated code reviews on this repo. Configure here.

@mintlify

mintlify Bot commented Aug 5, 2026

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated (UTC)
mintlify 🟢 Ready View Preview Aug 5, 2026, 7:30 PM

@mintlify

mintlify Bot commented Aug 5, 2026

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated (UTC)
tomee 🟢 Ready View Preview Aug 5, 2026, 7:31 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant