From 03b08ce3285b3e6a3a9b2458e3af4177fb56c530 Mon Sep 17 00:00:00 2001
From: chdeskur <chdeskur@gmail.com>
Date: Sun, 19 Oct 2025 14:43:09 -0400
Subject: [PATCH] chore: add health endpoint, use real component

---
 fern/apis/public-api/definition/health.yml        | 15 +++++++++++++++
 .../default-components/runnable-endpoint.mdx      |  5 ++++-
 2 files changed, 19 insertions(+), 1 deletion(-)
 create mode 100644 fern/apis/public-api/definition/health.yml

diff --git a/fern/apis/public-api/definition/health.yml b/fern/apis/public-api/definition/health.yml
new file mode 100644
index 000000000..95bdbb749
--- /dev/null
+++ b/fern/apis/public-api/definition/health.yml
@@ -0,0 +1,15 @@
+service:
+  base-path: /
+  auth: false
+  audiences:
+    - external
+  endpoints:
+    health:
+      method: GET
+      display-name: Health
+      path: health
+      docs: Check the health of the SDK generation service. The response will be "OK" if the service is healthy.
+      response: string
+      examples:
+        - response:
+            body: "OK"
diff --git a/fern/products/docs/pages/component-library/default-components/runnable-endpoint.mdx b/fern/products/docs/pages/component-library/default-components/runnable-endpoint.mdx
index 86416ca7b..d102f5398 100644
--- a/fern/products/docs/pages/component-library/default-components/runnable-endpoint.mdx
+++ b/fern/products/docs/pages/component-library/default-components/runnable-endpoint.mdx
@@ -7,8 +7,11 @@ The `<RunnableEndpoint>` component enables users to make real HTTP requests to y
 
 <Tabs>
 <Tab title="Example">
+This endpoint returns the health of `api.buildwithfern.com`.
+<RunnableEndpoint endpoint="GET /health" />
 
-![Runnable Endpoint component example](runnable-endpoint.png)
+This endpoint returns the document for a given domain. It requires authentication, and a `domain` path parameter.
+<RunnableEndpoint endpoint="GET /document/{domain}" />
 
 </Tab>
 <Tab title="Markdown">