Skip to main content
POST
Create trace deletion request

Authorizations

x-api-key
string
header
required

Headers

x-selected-account-id
string | null

Body

application/json
reason_code
enum<string>
required
Available options:
customer_requested_deletion
trace_ids
string[]
required

Explicit trace IDs to delete. Limited to 10,000 after deduplication.

Required string length: 1 - 256
reason_details
string

Optional bounded audit context for the deletion request.

Maximum string length: 2000
group_id
null

Response

Successful Response

deletion_request_id
string
required
status
enum<string>
required
Available options:
accepted,
resolving,
deleting,
completed,
failed,
canceled
object
string
default:trace_deletion
trace_count
integer
resolved_trace_count
integer
tombstoned_span_count
integer

Live spans tombstoned in ClickHouse, from the awaited propagation acknowledgement. Response-only (the durable record is sgp-traces' deletion audit). Null when propagation was skipped or ran best-effort.

soft_deleted_at
string<date-time>