# How can I verify my runs have been queued for deletion via the API?

**URL:** <https://forum.langchain.com/t/how-can-i-verify-my-runs-have-been-queued-for-deletion-via-the-api/3849>\
**Category:** Observability & Evals\
**Created:** [June 2, 2026, 3:23pm UTC](https://forum.langchain.com/t/how-can-i-verify-my-runs-have-been-queued-for-deletion-via-the-api/3849 "2026-06-02T15:23:59Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![benlammers](https://yyz1.discourse-cdn.com/flex007/user_avatar/forum.langchain.com/benlammers/32/2323_2.png) [@benlammers](https://forum.langchain.com/u/benlammers)\
**Post date:** [June 2, 2026, 3:23pm UTC](https://forum.langchain.com/t/how-can-i-verify-my-runs-have-been-queued-for-deletion-via-the-api/3849/1 "2026-06-02T15:23:59Z")

</div>

I am using the /api/v1/runs/delete endpoint to queue up specific traces / runs for deletion by passing session\_id and applicable metadata filters. The response is very opaque simply indicating that runs have been queued for deletion.

I sent a few requests last week and have been periodically check if runs I expect to be deleted are still visible in the LangSmith platform. So far none have been removed, I will continue to monitor but wondering if there is an easier way to validate this.

We are trying to develop a pipeline for removing traces for compliance and this feedback loop is currently making it very tough to move the project forward.

Thanks!

---

<div class="post-metadata">

**Author:** ![keenborder786](https://yyz1.discourse-cdn.com/flex007/user_avatar/forum.langchain.com/keenborder786/32/1757_2.png) [@keenborder786](https://forum.langchain.com/u/keenborder786)\
**Post date:** [June 2, 2026, 3:53pm UTC](https://forum.langchain.com/t/how-can-i-verify-my-runs-have-been-queued-for-deletion-via-the-api/3849/2 "2026-06-02T15:53:15Z")

</div>

Hi @benlammers, there isn’t a separate API to poll “deletion job status” today. A `200` from `POST /api/v1/runs/delete` means the delete was **accepted and scheduled** , not that traces are already gone.

### What “queued for deletion” actually means

Per the [Data purging for compliance](https://docs.langchain.com/langsmith/data-purging-compliance#deletion-timeline) guide:

- Deletions run during **non-peak** times and are **not instant**.
- LangSmith runs the delete job on the **weekend**.
- There is **no confirmation callback or completion payload**. you verify by querying again.

The [Delete Runs API](https://docs.langchain.com/langsmith/smith-api/run/delete-runs) returns an empty `{}` on success (no job ID, no count of traces matched).

So if you submitted requests last week and checked before the weekend batch, traces can still appear in the UI , that’s expected, not necessarily a failed request.

* * *

### 1. Verify the request was accepted (queued)

**Minimum:** `POST /api/v1/runs/delete` returns **HTTP 200**.

**Enterprise (audit trail):** Query audit logs for the `delete_runs` operation:

```bash
curl -G 'https://api.smith.langchain.com/api/v1/audit-logs' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'X-Organization-Id: YOUR_ORG_ID' \
  --data-urlencode 'operations=delete_runs' \
  --data-urlencode 'start_time=2026-05-26T00:00:00Z' \
  --data-urlencode 'limit=50'

```

See [Audit logs](https://docs.langchain.com/langsmith/audit-logs). This confirms **who called delete and when** , not that every trace was purged.

* * *

### 2. Verify deletion actually completed

Re-query with the same criteria you used to delete, via [`list_runs`](https://docs.langchain.com/langsmith/export-traces) / `POST /api/v1/runs/query` ([trace query syntax](https://docs.langchain.com/langsmith/trace-query-syntax)).

Paginate until no results. For large scopes, count root runs before delete vs after.

**Timing:** Plan verification **after the weekend** delete window, not hours after the POST.

* * *

### 3. Suggested compliance pipeline pattern (this is a recommendation given the restrictions we have, and I have NOT personally tried it in production)

1. **Discover** : `list_runs` with your compliance filter; collect root `trace_id`s (and `session_id` / project).
2. **Delete** : `POST /api/v1/runs/delete` with explicit `trace_ids` + `session_id` in batches of ≤1000.
3. **Record** : Store `(trace_id, session_id, delete_requested_at)` in your system of record.
4. **Verify** : After the weekend, re-run the same `list_runs` query; assert zero matches.
5. **Audit** (Enterprise): Correlate your records with `delete_runs` audit log events.

* * *

### TLDR

- **Queued** ≈ HTTP 200 from delete (optionally `delete_runs` in audit logs on Enterprise).
- **Deleted** ≈ targeted traces no longer returned by `list_runs` / `/runs/query` after the weekend batch.
- There is **no** job-status or completion webhook today. programmatic re-query is the supported verification path.

Doc Reference

- [Data purging for compliance](https://docs.langchain.com/langsmith/data-purging-compliance)
- [Delete Runs API](https://docs.langchain.com/langsmith/smith-api/run/delete-runs)
- [Export / query traces](https://docs.langchain.com/langsmith/export-traces)
- [Trace query syntax](https://docs.langchain.com/langsmith/trace-query-syntax)
- [Audit logs](https://docs.langchain.com/langsmith/audit-logs)

---

<div class="post-metadata">

**Author:** ![benlammers](https://yyz1.discourse-cdn.com/flex007/user_avatar/forum.langchain.com/benlammers/32/2323_2.png) [@benlammers](https://forum.langchain.com/u/benlammers)\
**Post date:** [June 2, 2026, 5:23pm UTC](https://forum.langchain.com/t/how-can-i-verify-my-runs-have-been-queued-for-deletion-via-the-api/3849/3 "2026-06-02T17:23:56Z")

</div>

Thanks @keenborder786 for the quick reply.

If my requests were correct and the deletions were queued last week should they have been deleted by now or is it possible they are still queued for next weekend.

I am trying to determine if the existence of the runs means I did not properly form my requests last week or if they are still queued for even the following weekend yet.

---

<div class="post-metadata">

**Author:** ![keenborder786](https://yyz1.discourse-cdn.com/flex007/user_avatar/forum.langchain.com/keenborder786/32/1757_2.png) [@keenborder786](https://forum.langchain.com/u/keenborder786)\
**Post date:** [June 2, 2026, 6:23pm UTC](https://forum.langchain.com/t/how-can-i-verify-my-runs-have-been-queued-for-deletion-via-the-api/3849/4 "2026-06-02T18:23:57Z")

</div>

As per the official documentation [here](https://docs.langchain.com/langsmith/data-purging-compliance#deletion-timeline), they should be. It specifies the weekend, so if you queued the deletion last monday, ideally by now the traces should have been removed