LangChain Reference home pageLangChain ReferenceLangChain Reference
  • GitHub
  • Main Docs
Deep Agents
LangChain
LangGraph
Integrations
LangSmith
  • Overview
  • Client
  • AsyncClient
  • Run Helpers
  • Run Trees
  • Evaluation
  • Schemas
  • Utilities
  • Wrappers
  • Anonymizer
  • Testing
  • Expect API
  • Middleware
  • Pytest Plugin
  • Deployment SDK
⌘I

LangChain Assistant

Ask a question to get started

Enter to send•Shift+Enter new line

Menu

OverviewClientAsyncClientRun HelpersRun TreesEvaluationSchemasUtilitiesWrappersAnonymizerTestingExpect APIMiddlewarePytest PluginDeployment SDK
Language
Theme
Pythonlangsmithasync_clientAsyncClientread_run
Method●Since v0.2Deprecated

read_run

Copy
read_run(
  self,
  run_id: ls_client.ID_TYPE,
  *,
  project_id: Optional[ls_client.ID_TYPE
View source on GitHub
]
=
None
)
->
ls_schemas
.
Run

Parameters

NameTypeDescription
run_id*ls_client.ID_TYPE
project_idOptional[ls_client.ID_TYPE]
Default:None

Read a run.

.. admonition:: Deprecated

Use :meth:`langsmith.AsyncClient.runs.retrieve` instead.
See https://docs.langchain.com/langsmith/smithdb-sdk-migration#runs-retrieve for the migration guide.
Will be removed after Jan 31, 2027.

The ID of the run to read.

The ID of the project (session) that owns the run. Required on SmithDB-only backends (no ClickHouse query support), where it's used to look up the run via the v2 API.