From 75f3fac479b8ff84befba9862782993cfc5c0936 Mon Sep 17 00:00:00 2001
From: Kathryn May <kathryn@langchain.dev>
Date: Fri, 21 Nov 2025 14:51:34 -0500
Subject: [PATCH] Add a reference tab for LangSmith APIs and SDKs

---
 src/docs.json               | 52 ++++++++++++++++--------------
 src/langsmith/reference.mdx | 63 +++++++++++++++++++++++++++++++++++++
 2 files changed, 91 insertions(+), 24 deletions(-)
 create mode 100644 src/langsmith/reference.mdx

diff --git a/src/docs.json b/src/docs.json
index f55bcbbffe..b4e0264598 100644
--- a/src/docs.json
+++ b/src/docs.json
@@ -877,23 +877,6 @@
                     "langsmith/user-management"
                   ]
                 },
-                {
-                  "group": "Reference",
-                  "pages": [
-                    "langsmith/smith-python-sdk",
-                    "langsmith/smith-js-ts-sdk",
-                    "langsmith/langgraph-python-sdk",
-                    "langsmith/langgraph-js-ts-sdk",
-                    "langsmith/smith-api-ref",
-                    {
-                      "group": "API reference for LangSmith Deployment",
-                      "pages": [
-                        "langsmith/server-api-ref",
-                        "langsmith/api-ref-control-plane"
-                      ]
-                    }
-                  ]
-                },
                 {
                   "group": "Additional resources",
                   "pages": [
@@ -1458,13 +1441,34 @@
                         "langsmith/script-running-ch-support-queries"
                       ]
                     }
-                    ]
-                  }
-                ]
-              }
-            ]
-          }
-        ]
+                  ]
+                }
+              ]
+            },
+            {
+              "tab": "Reference",
+              "pages": [
+                "langsmith/reference",
+                "langsmith/smith-python-sdk",
+                "langsmith/smith-js-ts-sdk",
+                "langsmith/langgraph-python-sdk",
+                "langsmith/langgraph-js-ts-sdk",
+                "langsmith/smith-api-ref",
+                {
+                  "group": "LangSmith Deployment",
+                  "pages": [
+                    "langsmith/server-api-ref",
+                    "langsmith/api-ref-control-plane",
+                    "langsmith/cli",
+                    "langsmith/remote-graph",
+                    "langsmith/env-var"
+                  ]
+                }
+              ]
+            }
+          ]
+        }
+      ]
   },
   "interaction": {
     "drilldown": true
diff --git a/src/langsmith/reference.mdx b/src/langsmith/reference.mdx
new file mode 100644
index 0000000000..2746d870a9
--- /dev/null
+++ b/src/langsmith/reference.mdx
@@ -0,0 +1,63 @@
+---
+title: LangSmith reference
+sidebarTitle: Overview
+mode: wide
+---
+
+The following sections provide API references and SDK documentation for LangSmith:
+
+<Columns cols={3}>
+  <Card
+    title="Python SDK"
+    icon="python"
+    href="/langsmith/smith-python-sdk"
+    arrow="true"
+  >
+    Reference documentation for the LangSmith Python SDK.
+  </Card>
+
+  <Card
+    title="JavaScript/TypeScript SDK"
+    icon="js"
+    href="/langsmith/smith-js-ts-sdk"
+    arrow="true"
+  >
+    Reference documentation for the LangSmith JavaScript/TypeScript SDK.
+  </Card>
+
+  <Card
+    title="LangGraph Python SDK"
+    icon="diagram-project"
+    href="/langsmith/langgraph-python-sdk"
+    arrow="true"
+  >
+    Reference documentation for deploying LangGraph applications with Python.
+  </Card>
+
+  <Card
+    title="LangGraph JS/TS SDK"
+    icon="diagram-project"
+    href="/langsmith/langgraph-js-ts-sdk"
+    arrow="true"
+  >
+    Reference documentation for deploying LangGraph applications with JavaScript/TypeScript.
+  </Card>
+
+  <Card
+    title="LangSmith API"
+    icon="code"
+    href="/langsmith/smith-api-ref"
+    arrow="true"
+  >
+    Complete REST API reference for LangSmith platform features.
+  </Card>
+
+  <Card
+    title="Deployment APIs"
+    icon="server"
+    href="/langsmith/server-api-ref"
+    arrow="true"
+  >
+    API references for self-hosted and hybrid LangSmith deployments.
+  </Card>
+</Columns>