---
title: "Changes to Delete Runs"
method: POST
path: "/api/v1/runs/delete"
---

# Changes to Delete Runs

`POST /api/v1/runs/delete`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 2 of 48 revisions.

- **2026-05-27** `a0acb3a6a101` — 6 info
- **2026-03-31** `9b9d7777d6a9` — 5 breaking, 1 warning

## Changes

- **2026-05-27** `a0acb3a6a101` — 6 info
  - added the new optional request property `metadata`
  - request body became optional
  - the request property `session_id` became optional
  - the request property `trace_ids` became optional
  - request property `session_id` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `trace_ids` list-of-types was widened by adding types `null` to media type `application/json`
- **2026-03-31** `9b9d7777d6a9` — 5 breaking, 1 warning
  - request body became required
  - the request property `session_id` became required
  - the request property `trace_ids` became required
  - request property `session_id` list-of-types was narrowed by removing types `null` from media type `application/json`
  - request property `trace_ids` list-of-types was narrowed by removing types `null` from media type `application/json`
  - removed the request property `metadata`

---

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