Merge pull request #4789 from Blargian/swagger_hyperdx

ClickStack: add ClickStack reference docs (attempt 3)

Author: Blargian

docs/use-cases/observability/clickstack/api-reference.md

@@ -0,0 +1,15 @@
+---
+slug: /use-cases/observability/clickstack/api-reference
+title: 'API reference'
+pagination_prev: null
+pagination_next: null
+description: 'Landing page for ClickStack API reference docs'
+doc_type: 'landing-page'
+---
+
+import CloudNotSupportedBadge from '@theme/badges/CloudNotSupportedBadge';
+import {Button} from "@clickhouse/click-ui/bundled";
+
+<CloudNotSupportedBadge/>
+
+For API reference docs, please visit [this page](https://www.clickhouse.com/docs/clickstack/api-reference)

package.json

@@ -13,7 +13,7 @@
     "docusaurus": "docusaurus",
     "copy-clickhouse-repo-docs": "bash scripts/copy-clickhouse-repo-docs.sh",
     "serve": "docusaurus serve",
-    "build-swagger": "yarn redocly build-docs https://api.clickhouse.cloud/v1 --output build/cloud/manage/api/swagger.html",
+    "build-swagger": "yarn redocly build-docs https://api.clickhouse.cloud/v1 --output build/cloud/manage/api/swagger.html && yarn redocly build-docs https://raw.githubusercontent.com/hyperdxio/hyperdx/refs/heads/main/packages/api/openapi.json --output build/clickstack/api-reference/index.html",
     "prep-from-local": "bash ./scripts/copy-clickhouse-repo-docs.sh -l $1",
     "autogenerate-settings": "bash ./scripts/settings/autogenerate-settings.sh",
     "autogenerate-table-of-contents": "bash ./scripts/autogenerate-table-of-contents.sh",

sidebars.js

@@ -1694,7 +1694,8 @@ const sidebars = {
               dirName: "use-cases/observability/clickstack/integration-examples",
             },
           ]
-        }
+        },
+        "use-cases/observability/clickstack/api-reference"
       ]
     },
   ],