LAlangchain-ai
public

Stats Shared Dataset Runs

Changed on

Get run stats in projects run over a dataset that has been shared.

post/api/v1/public/{share_token}/datasets/runs/stats

Request

Path parameters

share_tokenstring uuid required

Request body

idstring[] nullable
tracestring uuid nullable

Filter runs by trace ID. When set, limit and cursor-based pagination are not applied — all runs in the trace are returned in a single response.

parent_runstring uuid nullable
run_type'tool' | 'chain' | 'llm' | 'retriever' | 'embedding' | 'prompt' | 'parser'

Enum for run types.

sessionstring[] nullable
reference_examplestring[] nullable
execution_orderinteger nullable
start_timestring date-time nullable
end_timestring date-time nullable
errorboolean nullable
querystring nullable
filterstring nullable
trace_filterstring nullable
tree_filterstring nullable
is_rootboolean nullable
data_source_type'current' | 'historical' | 'lite' | 'root_lite' | 'runs_feedbacks_rmt_wide'

Enum for run data source types.

skip_paginationboolean nullable
search_filterstring nullable
use_experimental_searchboolean
groupsstring[] nullable
selectRunStatsSelect[] nullable
reference_dataset_idstring uuid nullable
include_detailsboolean

Response

Successful Response

run_countinteger nullable
latency_p50number nullable
latency_p99number nullable
first_token_p50number nullable
first_token_p99number nullable
total_tokensinteger nullable
prompt_tokensinteger nullable
completion_tokensinteger nullable
median_tokensinteger nullable
completion_tokens_p50integer nullable
prompt_tokens_p50integer nullable
tokens_p99integer nullable
completion_tokens_p99integer nullable
prompt_tokens_p99integer nullable
last_run_start_timestring date-time nullable
feedback_statsobject nullable
run_facetsobject[] nullable
error_ratenumber nullable
streaming_ratenumber nullable
total_costnumber nullable
prompt_costnumber nullable
completion_costnumber nullable
cost_p50number nullable
cost_p99number nullable
prompt_token_detailsobject nullable
completion_token_detailsobject nullable
prompt_cost_detailsobject nullable
completion_cost_detailsobject nullable

Changes

  • 1a8ee9358d81Revision changes
    • breaking

      the / response's property type changed from object to string for status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new group_count enum value to the request property //

  • a0acb3a6a101Revision changes
    • breaking

      response property completion_cost list-of-types was widened by adding types number to media type application/json of response 200

    • breaking

      response property cost_p50 list-of-types was widened by adding types number to media type application/json of response 200

    • breaking

      response property cost_p99 list-of-types was widened by adding types number to media type application/json of response 200

    • breaking

      response property prompt_cost list-of-types was widened by adding types number to media type application/json of response 200

    • breaking

      response property total_cost list-of-types was widened by adding types number to media type application/json of response 200

    • breaking

      the / response's property type changed from string to number for status

    • breaking

      the / response's property type changed from string to number for status

    • breaking

      the / response's property type changed from string to number for status

    • breaking

      the / response's property type changed from string to number for status

    • breaking

      the / response's property type changed from string to number for status