Delete Trace

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}.

delete/tracing/traces/{trace_id}

Path parameters

trace_idstring required

Response

Successful Response

countinteger

Number of spans that were accepted and published to the ingest stream. Compare against the number of spans you sent to detect partial failures.

Changes

Changed in 9 of the 378 revisions of this API.4313

May 19, 2026a7f9a68232302See the full diff
- ●
  removed the optional property from the response with the status
  response-optional-property-removed
- ●
  removed the optional property from the response with the status
  response-optional-property-removed
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
May 14, 2026d7e21f629c881See the full diff
- ●
  removed the optional property from the response with the status
  response-optional-property-removed
May 8, 2026bb630edffa273See the full diff
- ○
  api tag Deprecated added
  api-tag-added
- ○
  api tag Traces removed
  api-tag-removed
- ○
  endpoint deprecated
  endpoint-deprecated
May 2, 20266e37373d45fe2See the full diff
- ○
  api tag Traces added
  api-tag-added
- ○
  api tag Observability removed
  api-tag-removed
This revision also has 11 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Apr 23, 2026925e8b901a263See the full diff
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
Mar 7, 202620311f76350541See the full diff
- ▲
  the response property /// became optional for the status
  response-property-became-optional
- ▲
  the response property /// became optional for the status
  response-property-became-optional
- ▲
  response property links/anyOf[subschema #1]/items/span_id list-of-types was widened by adding types null to media type application/json of response 202
  response-property-list-of-types-widened
- ▲
  response property links/anyOf[subschema #1]/items/trace_id list-of-types was widened by adding types null to media type application/json of response 202
  response-property-list-of-types-widened
- ○
  api operation id delete_trace removed and replaced with delete_trace_tracing
  api-operation-id-removed
This revision also has 7 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Feb 13, 202672fe88316d152See the full diff
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
This revision also has 31 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jan 14, 202653da4c9de2b71See the full diff
- ○
  endpoint added
  endpoint-added
This revision also has 56 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jun 27, 2025e3e84db471981See the full diff
- ○
  api path removed with deprecation
  api-path-removed-with-deprecation
This revision also has 651 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history