Add public terramate cloud api docs

.vitepress/config.ts

@@ -1,5 +1,13 @@
 import type { HeadConfig } from 'vitepress'
 import { defineConfig } from 'vitepress'
+import { useSidebar } from 'vitepress-openapi'
+import spec from './theme/openapi.json' with { type: 'json' }
+
+const sidebar = useSidebar({
+  spec,
+  // Optionally, you can specify a link prefix for all generated sidebar items.
+  linkPrefix: '/api/',
+})
 
 function getPath(path: string) {
   const uri = path.replace(/(?:(^|\/)index)?\.md$/, '$1')
@@ -519,7 +527,16 @@ export default defineConfig({
                 { text: 'API Keys', link: '/cloud/organization/api-keys' },
               ],
             },
+            {
+              text: 'API Reference',
+              collapsed: true,
+              items: [
+                // ...sidebar.itemsByTags(),
+                ...sidebar.generateSidebarGroups(),
+              ],
+            },
           ],
+
         },
 
         {

.vitepress/theme/index.js → .vitepress/theme/index.ts

@@ -1,14 +1,25 @@
+import type { Theme } from 'vitepress'
 import mediumZoom from 'medium-zoom'
 import { useRoute } from 'vitepress'
+import { theme, useOpenapi } from 'vitepress-openapi/client'
 import DefaultTheme from 'vitepress/theme'
 import { nextTick, onMounted, watch } from 'vue'
+import spec from './openapi.json'
+import 'vitepress-openapi/dist/style.css'
 
 import './vars.css'
 import './index.css'
 
 export default {
-  ...DefaultTheme,
-
+  extends: DefaultTheme,
+  async enhanceApp(ctx) {
+    useOpenapi({
+      spec,
+      config: {
+      },
+    })
+    theme.enhanceApp(ctx)
+  },
   setup() {
     const route = useRoute()
     const initZoom = () => {
@@ -23,4 +34,4 @@ export default {
       () => nextTick(() => initZoom()),
     )
   },
-}
+} satisfies Theme