{"slug":"langsmith-api","name":"LangSmith API","host":"api.smith.langchain.com","site":"https://langchain.com","category":"devtools","docsUrl":null,"sources":[{"kind":"changelog","url":"https://docs.langchain.com/langsmith/changelog"},{"kind":"openapi","url":"https://api.smith.langchain.com/openapi.json"}],"url":"https://www.okapi.bot/providers/langsmith-api/","json":"https://www.okapi.bot/api/v1/providers/langsmith-api.json","breakingChanges":[{"slug":"api-v1-runs-share-stops-working","api":"langsmith-api","title":"/api/v1/runs/{}/share stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":"2026-07-27","effectiveAt":"2027-01-31","scope":null,"calls":["/api/v1/runs/{}/share"],"method":null,"path":"/api/v1/runs/{}/share","source":{"url":"https://docs.langchain.com/langsmith/changelog","kind":"archive"},"quote":"LangSmith marks every legacy endpoint replaced by the SmithDB SDK migration guide as deprecated: the v1 runs query and retrieve endpoints, the v1 run sharing and public-run read endpoints, POST /api/v1/datasets/{dataset_id}/runs , and the annotation queue run endpoints. All of them now respond with Deprecation: true , a Sunset date of January 31, 2027","migration":"Share with POST /api/v2/runs/{run_id}/share, unshare with DELETE /api/v2/runs/{trace_id}/share, and read the share state with GET /api/v2/runs/{run_id}?selects=SHARE_URL.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:01:15.193Z","updatedAt":"2026-10-23T10:01:15.193Z","status":"upcoming","tone":"risk","url":"https://www.okapi.bot/providers/langsmith-api/breaking-changes/api-v1-runs-share-stops-working/"},{"slug":"get-api-v1-public-run-stops-working","api":"langsmith-api","title":"GET /api/v1/public/{}/run/{} stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":"2026-07-27","effectiveAt":"2027-01-31","scope":null,"calls":["GET /api/v1/public/{}/run/{}"],"method":"GET","path":"/api/v1/public/{}/run/{}","source":{"url":"https://docs.langchain.com/langsmith/changelog","kind":"archive"},"quote":"LangSmith marks every legacy endpoint replaced by the SmithDB SDK migration guide as deprecated: the v1 runs query and retrieve endpoints, the v1 run sharing and public-run read endpoints, POST /api/v1/datasets/{dataset_id}/runs , and the annotation queue run endpoints. All of them now respond with Deprecation: true , a Sunset date of January 31, 2027","migration":"Call GET /api/v2/public/{share_token}/run/{run_id}.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:01:15.193Z","updatedAt":"2026-10-23T10:01:15.193Z","status":"upcoming","tone":"risk","url":"https://www.okapi.bot/providers/langsmith-api/breaking-changes/get-api-v1-public-run-stops-working/"},{"slug":"get-api-v1-runs-stops-working","api":"langsmith-api","title":"GET /api/v1/runs/{} stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":"2026-07-27","effectiveAt":"2027-01-31","scope":null,"calls":["GET /api/v1/runs/{}"],"method":"GET","path":"/api/v1/runs/{}","source":{"url":"https://docs.langchain.com/langsmith/changelog","kind":"archive"},"quote":"LangSmith marks every legacy endpoint replaced by the SmithDB SDK migration guide as deprecated: the v1 runs query and retrieve endpoints, the v1 run sharing and public-run read endpoints, POST /api/v1/datasets/{dataset_id}/runs , and the annotation queue run endpoints. All of them now respond with Deprecation: true , a Sunset date of January 31, 2027","migration":"Call GET /api/v2/runs/{run_id} with the new required project_id query parameter and selects for the fields you need.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:01:15.193Z","updatedAt":"2026-10-23T10:01:15.193Z","status":"upcoming","tone":"risk","url":"https://www.okapi.bot/providers/langsmith-api/breaking-changes/get-api-v1-runs-stops-working/"},{"slug":"post-api-v1-datasets-runs-stops-working","api":"langsmith-api","title":"POST /api/v1/datasets/{}/runs stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":"2026-07-27","effectiveAt":"2027-01-31","scope":null,"calls":["POST /api/v1/datasets/{}/runs"],"method":"POST","path":"/api/v1/datasets/{}/runs","source":{"url":"https://docs.langchain.com/langsmith/changelog","kind":"archive"},"quote":"LangSmith marks every legacy endpoint replaced by the SmithDB SDK migration guide as deprecated: the v1 runs query and retrieve endpoints, the v1 run sharing and public-run read endpoints, POST /api/v1/datasets/{dataset_id}/runs , and the annotation queue run endpoints. All of them now respond with Deprecation: true , a Sunset date of January 31, 2027","migration":"Call POST /api/v2/datasets/{dataset_id}/experiment-runs with experiment_ids (it returns JSON only, paginated by cursor).","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:01:15.193Z","updatedAt":"2026-10-23T10:01:15.193Z","status":"upcoming","tone":"risk","url":"https://www.okapi.bot/providers/langsmith-api/breaking-changes/post-api-v1-datasets-runs-stops-working/"},{"slug":"post-api-v1-public-runs-query-stops-working","api":"langsmith-api","title":"POST /api/v1/public/{}/runs/query stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":"2026-07-27","effectiveAt":"2027-01-31","scope":null,"calls":["POST /api/v1/public/{}/runs/query"],"method":"POST","path":"/api/v1/public/{}/runs/query","source":{"url":"https://docs.langchain.com/langsmith/changelog","kind":"archive"},"quote":"LangSmith marks every legacy endpoint replaced by the SmithDB SDK migration guide as deprecated: the v1 runs query and retrieve endpoints, the v1 run sharing and public-run read endpoints, POST /api/v1/datasets/{dataset_id}/runs , and the annotation queue run endpoints. All of them now respond with Deprecation: true , a Sunset date of January 31, 2027","migration":"Call POST /api/v2/public/{share_token}/runs/query.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:01:15.193Z","updatedAt":"2026-10-23T10:01:15.193Z","status":"upcoming","tone":"risk","url":"https://www.okapi.bot/providers/langsmith-api/breaking-changes/post-api-v1-public-runs-query-stops-working/"},{"slug":"post-api-v1-runs-query-stops-working","api":"langsmith-api","title":"POST /api/v1/runs/query stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":"2026-07-27","effectiveAt":"2027-01-31","scope":null,"calls":["POST /api/v1/runs/query"],"method":"POST","path":"/api/v1/runs/query","source":{"url":"https://docs.langchain.com/langsmith/changelog","kind":"archive"},"quote":"LangSmith marks every legacy endpoint replaced by the SmithDB SDK migration guide as deprecated: the v1 runs query and retrieve endpoints, the v1 run sharing and public-run read endpoints, POST /api/v1/datasets/{dataset_id}/runs , and the annotation queue run endpoints. All of them now respond with Deprecation: true , a Sunset date of January 31, 2027","migration":"Call POST /api/v2/runs/query with project_ids and an explicit min_start_time (it defaults to the last 24 hours), and selects for the fields you need; root runs: POST /api/v2/traces/query; threads: POST /api/v2/threads/query.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:01:15.193Z","updatedAt":"2026-10-23T10:01:15.193Z","status":"upcoming","tone":"risk","url":"https://www.okapi.bot/providers/langsmith-api/breaking-changes/post-api-v1-runs-query-stops-working/"},{"slug":"api-v1-feedback-formulas-stops-working","api":"langsmith-api","title":"/api/v1/feedback/formulas stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":"2026-07-13","effectiveAt":"2026-08-20","scope":null,"calls":["/api/v1/feedback/formulas*"],"method":null,"path":"/api/v1/feedback/formulas*","source":{"url":"https://docs.langchain.com/langsmith/changelog","kind":"archive"},"quote":"that back composite scores are deprecated in favor of composite evaluators , which implement a composite score as a code evaluator plus a run rule, and are scheduled for removal on 2026-08-20.","migration":"Recreate each feedback formula as a composite evaluator (a code evaluator plus a run rule).","migrationChange":null,"needsDecision":"Composite evaluators have no SDK replacement for the formula methods: composite scores are set up as evaluators and run rules instead.","text":null,"publishedAt":"2026-10-23T10:01:15.193Z","updatedAt":"2026-10-23T10:01:15.193Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/langsmith-api/breaking-changes/api-v1-feedback-formulas-stops-working/"}]}