v28

latestOpenAPI 3.1.0Apache-2.0raw.githubusercontent.com2026-07-082940159.9 KB

Taxonomy

Soft-remove a taxonomy node

Soft-removes a taxonomy node (sets removed_at/removed_by) and records a soft_remove event attributed to actor_id. The node is retained for audit but excluded from tree responses. Tenant-scoped; returns 404 if the node does not belong to the tenant. While a tenant data purge runs for the same tenant_id, the request is rejected with HTTP 409 (code tenant_write_conflict).

delete/v1/taxonomy/nodes/{node_id}

Path parameters

node_idstring uuid required

Example:019f177f-9abe-78cd-8008-f40b58e3147d

Taxonomy node ID.

Query parameters

tenant_idstring required

Example:org-123

Tenant that owns the node.

actor_idstring required

Identifier of the actor performing the removal (recorded in the audit event).

Response

The soft-removed node

idstring uuid required

run_idstring uuid required

parent_idstring uuid

Parent node ID; absent for the root node.

cluster_idstring uuid

Cluster this node summarizes; typically present on leaf nodes.

node_type'root' | 'branch' | 'leaf' required

Position of a node within the taxonomy tree.

labelstring required

original_labelstring

Label as originally generated, before any rename.

descriptionstring

levelinteger required

Depth in the tree; the root is level 0.

sort_orderinteger required

metadataobject

removed_atstring date-time

Set when the node has been soft-removed.

removed_bystring

Actor that soft-removed the node.

created_atstring date-time required

updated_atstring date-time required