threads

Get stats for a public shared thread

Changed on

Returns aggregate stats for the thread identified by the share token.

Self-hosted deployments require LangSmith v0.16 or later.

get/api/v2/public/threads/{share_token}/stats

Request

  • Base URL
    https://api.smith.langchain.com
  • URL
    https://api.smith.langchain.com/api/v2/public/threads/{share_token}/stats
  • Auth
    none declared

Path parameters

share_tokenstring uuid required

Share token UUID

Query parameters

selectsstring[] required

repeatable public thread stats fields to include

Headers

Acceptstring

application/json or text/event-stream

Response

OK

completion_costnumber

completion_cost is the sum of per-trace completion costs across the thread, in USD. Populated when COMPLETION_COST is selected.

completion_tokensinteger

completion_tokens is the sum of per-trace completion token counts across the thread. Populated when COMPLETION_TOKENS is selected.

feedback_statsQueryRunFeedbackStats
first_start_timestring date-time

first_start_time is the earliest trace start time in the thread (RFC3339). Populated when FIRST_START_TIME is selected.

last_end_timestring date-time

last_end_time is the latest trace end time in the thread (RFC3339). Populated when LAST_END_TIME is selected.

last_start_timestring date-time

last_start_time is the latest trace start time in the thread (RFC3339). Populated when LAST_START_TIME is selected.

latency_p50_secondsnumber

latency_p50_seconds is the approximate p50 of trace latency across the thread, in seconds. Populated when LATENCY_P50 is selected.

latency_p99_secondsnumber

latency_p99_seconds is the approximate p99 of trace latency across the thread, in seconds. Populated when LATENCY_P99 is selected.

prompt_costnumber

prompt_cost is the sum of per-trace prompt costs across the thread, in USD. Populated when PROMPT_COST is selected.

prompt_tokensinteger

prompt_tokens is the sum of per-trace prompt token counts across the thread. Populated when PROMPT_TOKENS is selected.

total_costnumber

total_cost is the sum of per-trace total costs across the thread, in USD. Populated when TOTAL_COST is selected.

total_tokensinteger

total_tokens is the sum of per-trace total token counts across the thread. Populated when TOTAL_TOKENS is selected.

turnsinteger

turns is the number of distinct traces (turns) in the thread. Populated when TURNS is selected.

Changes