---
title: "Changes to Stats Shared Dataset Runs"
method: POST
path: "/api/v1/public/{share_token}/datasets/runs/stats"
---

# Changes to Stats Shared Dataset Runs

`POST /api/v1/public/{share_token}/datasets/runs/stats`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 108 revisions.

- **2026-10-16** `1a8ee9358d81`: 4 breaking, 3 info
- **2026-05-27** `a0acb3a6a101`: 10 breaking
- **2026-02-14** `dab0b78b20b5`: 2 breaking, 9 info
- **2025-06-11** `2aef809a2c1e`: 1 info
- **2025-05-07** `81c4ee5d64f2`: 10 info
- **2025-03-06** `0345bb9c288e`: 1 info
- **2024-12-11** `bb22c35b3f5f`: 1 info

## Changes

- **2026-10-16** `1a8ee9358d81`: 4 breaking, 3 info
  - the `detail/items/` response's property type changed from `object` to `string` for status `422`
  - removed the required property `detail/items/loc` from the response with the `422` status
  - removed the required property `detail/items/msg` from the response with the `422` status
  - removed the required property `detail/items/type` from the response with the `422` status
  - added the new optional request property `include_details`
  - added the new optional request property `reference_dataset_id`
  - added the new `group_count` enum value to the request property `select/anyOf[subschema #1]/items/`
- **2026-05-27** `a0acb3a6a101`: 10 breaking
  - response property `completion_cost` list-of-types was widened by adding types `number` to media type `application/json` of response `200`
  - response property `cost_p50` list-of-types was widened by adding types `number` to media type `application/json` of response `200`
  - response property `cost_p99` list-of-types was widened by adding types `number` to media type `application/json` of response `200`
  - response property `prompt_cost` list-of-types was widened by adding types `number` to media type `application/json` of response `200`
  - response property `total_cost` list-of-types was widened by adding types `number` to media type `application/json` of response `200`
  - the `completion_cost/anyOf[subschema #1]/` response's property type changed from `string` to `number` for status `200`
  - the `cost_p50/anyOf[subschema #1]/` response's property type changed from `string` to `number` for status `200`
  - the `cost_p99/anyOf[subschema #1]/` response's property type changed from `string` to `number` for status `200`
  - the `prompt_cost/anyOf[subschema #1]/` response's property type changed from `string` to `number` for status `200`
  - the `total_cost/anyOf[subschema #1]/` response's property type changed from `string` to `number` for status `200`
- **2026-02-14** `dab0b78b20b5`: 2 breaking, 9 info
  - the response property `run_count` became optional for the status `200`
  - response property `run_count` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - added the new optional request property `groups`
  - added the new optional request property `select`
  - added the new `lite` enum value to the request property `data_source_type/anyOf[subschema #1: RunsFilterDataSourceTypeEnum]/`
  - added the new `root_lite` enum value to the request property `data_source_type/anyOf[subschema #1: RunsFilterDataSourceTypeEnum]/`
  - added the new `runs_feedbacks_rmt_wide` enum value to the request property `data_source_type/anyOf[subschema #1: RunsFilterDataSourceTypeEnum]/`
  - added the optional property `completion_cost_details` to the response with the `200` status
  - added the optional property `completion_token_details` to the response with the `200` status
  - added the optional property `prompt_cost_details` to the response with the `200` status
  - added the optional property `prompt_token_details` to the response with the `200` status
- **2025-06-11** `2aef809a2c1e`: 1 info
  - added the new optional request property `group_by/anyOf[subschema #1: RunStatsGroupBy]/max_groups`
- **2025-05-07** `81c4ee5d64f2`: 10 info
  - added the new optional request property `group_by`
  - added the new optional request property `search_filter`
  - added the new optional request property `use_experimental_search`
  - added the optional property `completion_tokens_p50` to the response with the `200` status
  - added the optional property `completion_tokens_p99` to the response with the `200` status
  - added the optional property `cost_p50` to the response with the `200` status
  - added the optional property `cost_p99` to the response with the `200` status
  - added the optional property `prompt_tokens_p50` to the response with the `200` status
  - added the optional property `prompt_tokens_p99` to the response with the `200` status
  - added the optional property `tokens_p99` to the response with the `200` status
- **2025-03-06** `0345bb9c288e`: 1 info
  - added the new optional request property `skip_pagination`
- **2024-12-11** `bb22c35b3f5f`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/langchain-ai/apis/langsmith/docs/api/v1/public/:share_token/datasets/runs/stats/post.md) - [API](https://skmtc.dev/langchain-ai/apis/langsmith.md) - [Page](https://skmtc.dev/langchain-ai/apis/langsmith/changes/api/v1/public/:share_token/datasets/runs/stats/post)