Skip to main content
The source contract is docs/api/openapi-v1.json. The docs generator copies it to apps/docs/api-reference/openapi.json, and Mintlify creates one interactive reference page per operation.

From a running service

Repository drift check

After changing control-plane routes:
Compatibility tests reject unresolved operation references and the removed broad JsonValue fallback. Every stable operation has named request and response schemas; several core resources also use closed field-level schemas.
Generated clients must still preserve unknown additive response fields and enum values safely within v1.