Skip to main content

​
BLIPS Developers

BLIPS is split into three developer-facing surfaces:
  • blips.network/developers is the public entry layer inside the main website.
  • docs.blips.network is the formal Mintlify docs site for API Reference and Playground.
  • blips.network/demo is the guided product demo and MVP walkthrough runtime.
This docs source is designed so the API Reference and Playground can be generated from a canonical OpenAPI 3.1 file while non-endpoint content remains easy to maintain in MDX.

​
What lives in this docs site

  • Quickstart and authentication guidance
  • Operational pages such as errors and webhooks
  • Auto-generated API Reference pages from openapi/blips-public-reference.yaml
  • Demo access notes and scenario documentation

​
What still has to be finalized before public launch

  • Replace the placeholder servers value in the OpenAPI file with the real BLIPS public hostnames
  • Promote webhook callback contracts into the canonical OpenAPI 3.1 document
  • Keep the public product demo on blips.network/demo

​
Source of truth

The API surface in this docs site is generated from the local OpenAPI copy at openapi/blips-public-reference.yaml. That file should stay in sync with the canonical spec maintained by the BLIPS MVP/runtime repo, then be validated with Mintlify before deployment.