---
title: "Delete Trace"
method: DELETE
path: "/tracing/traces/{trace_id}"
tags: ["Deprecated"]
deprecated: true
---

# Delete Trace

`DELETE /tracing/traces/{trace_id}`

> **Deprecated.**

Delete a trace and all its spans.

Removes every span that shares this `trace_id` within the project.
Returns `202 Accepted` with the links for the spans that were
marked for deletion. `trace_id` must be a 32-char hex UUID.

Deletion is not reversible. For soft-removal semantics on a
single-trace simple annotation, prefer
`DELETE /simple/traces/{trace_id}`.

## Path parameters

- `trace_id` string, required

## Response `202`

Successful Response

- OTelLinksResponse — Response from span ingestion. `count` reflects how many spans were successfully parsed and published to the ingest stream. If you submitted N spans and see `count < N`, some spans failed server-side validation and were not persisted (check server logs for details). See [Tracing — Async write contract](/reference/api-guide/tracing#async-write-contract-202) for the full semantics of the `202 Accepted` response.
  - `count` integer — Number of spans that were accepted and published to the ingest stream. Compare against the number of spans you sent to detect partial failures.
  - `links` OTelLinkOutput[], nullable — List of `(trace_id, span_id)` pairs for the accepted spans, in submission order.
    - `span_id` string, nullable
    - `trace_id` string, nullable
    - `attributes` object, nullable

## Other responses

- `422` — Validation Error

## Changes

- **2026-05-19** `a7f9a6823230` — 2 warning
  - removed the optional property `support_id` from the response with the `202` status
  - removed the optional property `support_ts` from the response with the `202` status
- **2026-05-14** `d7e21f629c88` — 1 warning
  - removed the optional property `dropped` from the response with the `202` status
- **2026-05-08** `bb630edffa27` — 3 info
  - api tag `Deprecated` added
  - api tag `Traces` removed
  - endpoint deprecated
- **2026-05-02** `6e37373d45fe` — 2 info
  - api tag `Traces` added
  - api tag `Observability` removed
- **2026-04-23** `925e8b901a26` — 3 info
  - added the optional property `dropped` to the response with the `202` status
  - added the optional property `support_id` to the response with the `202` status
  - added the optional property `support_ts` to the response with the `202` status

[Full history](https://skmtc.dev/agenta-ai/apis/agenta-api/changes/tracing/traces/:trace_id/delete.md)

---

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