Skip to main content

​
Playground

Mintlify generates the BLIPS API Playground from the same OpenAPI 3.1 source as the reference pages. The current state is:
  • the API Reference is ready for browsing
  • interactive Playground pages are generated from the OpenAPI source
  • real public request execution depends on replacing placeholder OpenAPI servers with real public and/or sandbox hosts
  • until those hosts are provided, the docs are previewable but real Try it is not yet enabled

​
What the Playground uses from OpenAPI

  • servers to determine where requests are sent
  • securitySchemes and security to render authentication inputs
  • parameters and requestBody to build request forms
  • responses and examples to display result shapes and sample payloads

​
What still must be finalized

The current public spec is close to ready for generated reference pages, but a full public Try it rollout still depends on:
  • replacing placeholder server values with real BLIPS hosts
  • confirming which hosts should be exposed for sandbox and production
  • deciding whether public docs should allow only sandbox Try it or both environments
  • promoting callback contracts into OpenAPI 3.1 webhooks when webhook documentation is expanded
  1. launch generated API Reference first
  2. verify auth rendering and endpoint forms in the Playground
  3. attach real sandbox servers
  4. expose public Try it flows once request routing and safeguards are confirmed