Function deleteSpan

Delete a single span by identifier.

Important: This operation deletes ONLY the specified span itself and does NOT delete its descendants/children. All child spans will remain in the trace and become orphaned (their parent_id will point to a non-existent span).

Behavior:

• Deletes only the target span (preserves all descendant spans)
• Child spans become orphaned but remain in the database
• Returns successfully if span is found and deleted
• Throws error if span is not found (404) or other errors occur

this function is experimental and may change in the future

// Delete by OpenTelemetry span_id
await deleteSpan({
  client,
  spanIdentifier: "abc123def456"
});

// Delete by Phoenix Global ID
await deleteSpan({
  client,
  spanIdentifier: "U3BhbjoyMzQ1Njc4OQ=="
});
Copy