LangChain Reference home pageLangChain ReferenceLangChain Reference
  • GitHub
  • Main Docs
Deep Agents
LangChain
LangGraph
Integrations
LangSmith
LangSmith
  • Client
  • Run Trees
  • Traceable
  • Evaluation
  • Schemas
  • Langchain
  • Jest
  • Vitest
  • Wrappers
  • Anonymizer
  • Jestlike
  • Vercel
  • Anthropic
  • Sandbox
⌘I

LangChain Assistant

Ask a question to get started

Enter to send•Shift+Enter new line

Menu

LangSmith
ClientRun TreesTraceableEvaluationSchemasLangchainJestVitestWrappersAnonymizerJestlikeVercelAnthropicSandbox
Language
Theme
JavaScriptlangsmith_openapi_clientresourcesrunsQueryRunResponse
Interface●Since v0.9

QueryRunResponse

Copy
interface QueryRunResponse

Properties

View source on GitHub
property
app_path: string
property
attachments: __type
property
completion_cost: number
property
completion_cost_details: CompletionCostDetails
property
completion_token_details: CompletionTokenDetails
property
completion_tokens: number
property
dotted_order: string
property
end_time: string
property
error: string
property
error_preview: string
property
events: Event[]
property
extra: unknown
property
feedback_stats: __type
property
first_token_time: string
property
id: string
property
inputs: unknown
property
inputs_preview: string
property
is_in_dataset: boolean
property
is_root: boolean
property
latency_seconds: number
property
manifest: unknown
property
metadata: unknown
property
name: string
property
outputs: unknown
property
outputs_preview: string
property
parent_run_ids: string[]
property
price_model_id: string
property
project_id: string
property
prompt_cost: number
property
prompt_cost_details: PromptCostDetails
property
prompt_token_details: PromptTokenDetails
property
prompt_tokens: number
property
reference_dataset_id: string
property
reference_example_id: string
property
run_type: "TOOL" | "CHAIN" | "LLM" | "RETRIEVER" | "EMBEDDING" | "PROMPT" | "PARSER"
property
share_url: string
property
start_time: string
property
status: "SUCCESS" | "ERROR" | "PENDING"
property
tags: string[]
property
thread_evaluation_time: string
property
thread_id: string
property
total_cost: number
property
total_tokens: number
property
trace_id: string

attachments maps each attachment file name to a pre-signed HTTPS download URL.

completion_cost_details is the per-category USD breakdown of completion_cost. Categories mirror completion_token_details. Returned only when the COMPLETION_COST_DETAILS field is requested.

completion_token_details is the per-category breakdown of completion_tokens. Category names are model-specific (for example reasoning, audio). Returned only when the COMPLETION_TOKEN_DETAILS field is requested.

JSON body of the response that caused the error

error_preview is a truncated plain-text error snippet.

is_in_dataset is true when this run is linked to a dataset example.

is_root is true when this run has no parent (it is the trace root).

latency_seconds is wall-clock duration from start to end in seconds.

manifest is the serialized configuration of the traced component (for example the model parameters, prompt template, or pipeline definition), when recorded.

parent_run_ids lists ancestor run UUIDs from the trace root down to the direct parent.

price_model_id identifies the pricing model UUID used for cost estimates, when recorded.

project_id is the tracing project UUID this run was logged to.

prompt_cost_details is the per-category USD breakdown of prompt_cost. Categories mirror prompt_token_details. Returned only when the PROMPT_COST_DETAILS field is requested.

prompt_token_details is the per-category breakdown of prompt_tokens. Category names are model-specific (for example cache_read, cache_write). Returned only when the PROMPT_TOKEN_DETAILS field is requested.

Enum for run types.

share_url is the fully-qualified URL of this run's public view, rooted at the deployment's LangSmith app origin (for example https://smith.langchain.com/public/4f7a1b2c-8d9e-4a0b-9c1d-2e3f4a5b6c7d/r). It is returned only when SHARE_URL is included in selects, and only when the run has been explicitly shared; the URL remains stable until the run is unshared. Anyone with this URL can view the run anonymously, so treat it as a secret and do not log it.

HTTP status for the response that caused the error

thread_evaluation_time is thread-level evaluation timing (RFC3339 date-time), when recorded.

thread_id is the conversation thread UUID this run belongs to, if any.