Does the LangSmith v1 API/SDK deprecation affect the Traces UI?

Last updated: November 11, 2026

Overview

LangSmith is retiring a set of v1 API endpoints and matching SDK methods in favor of newer endpoints backed by SmithDB, the observability backend that replaces ClickHouse for storing and querying trace data. If you received a deprecation notice about this, you may be wondering whether it changes how you use the Traces view in the LangSmith UI.

It doesn't. The Traces UI already queries runs and traces through the newer (SmithDB-backed) endpoints, not the deprecated v1 ones. The deprecation targets external callers: your own code, scripts, or integrations that call the LangSmith API or SDK directly.

What's affected

The deprecated endpoints and SDK methods cover more than read-only queries. They include:

  • Querying and reading runs (for example list_runs/listRuns, read_run/readRun)

  • Run sharing and public/shared runs

  • Dataset experiment run queries

  • Thread querying

  • Annotation queue run methods and feedback

If your code calls any of these directly, it needs to migrate to the SmithDB-backed replacements before the endpoints are removed. Using the LangSmith UI's Traces view on its own does not require any action.

Checking your own usage

To find out whether any of your integrations are still calling deprecated endpoints, check the "Legacy API usage detected" banner in the LangSmith UI, or call:

GET /api/v1/workspaces/current/legacy-api-usage

with a workspace API key. This returns the deprecated endpoints and SDK versions seen from that workspace over the last 7 days. Run this check per workspace, since usage is scoped to the workspace the API key belongs to.

Timelines and minimum SDK versions

For LangSmith Cloud, the v1 endpoints are deprecated as of end of July 2026 and are removed (stop working) on January 31, 2027, across all Cloud regions.

For LangSmith Self-Hosted, the same endpoints are deprecated starting with version 0.16 and are removed once ClickHouse is disabled, at the latest with the upgrade to version 0.19. The newer SmithDB-backed methods require Self-Hosted 0.16 or later regardless of which backing data store is in use.

To use the SmithDB-backed methods, make sure your SDK meets the minimum version for your language: Python langsmith>=0.10.15, TypeScript langsmith>=0.8.9, Java langsmith-java 0.1.0-beta.22, Go langsmith-go v0.25.4, and LangSmith CLI v0.2.44.

References