---
title: "Delete Runs"
method: POST
path: "/api/v1/runs/delete"
tags: ["run"]
---

# Delete Runs

`POST /api/v1/runs/delete`

Delete specific runs by trace IDs or metadata key-value pairs.

## Request body

- BodyDeleteRunsApiV1RunsDeletePost
  - `session_id` string, uuid, nullable
  - `trace_ids` string[], nullable
  - `metadata` object, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## 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
  - …2 more
- **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`
  - …2 more

[Change history](https://skmtc.dev/langchain-ai/apis/langsmith/changes/api/v1/runs/delete/post.md)

---

[API](https://skmtc.dev/langchain-ai/apis/langsmith.md) · [All operations](https://skmtc.dev/langchain-ai/apis/langsmith/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/langchain-ai/langsmith/revisions/a0acb3a6a101/schema)