Skip to main content
DELETE
DELETE /v1/classifications/{id}

Delete a Classification

Delete a classification by ID or fully qualified name. Supports soft delete (default), hard delete, and restore operations.

Delete by ID

id
string
required
UUID of the classification to delete.
recursive
boolean
default:"false"
Recursively delete all tags within this classification.
hardDelete
boolean
default:"false"
Permanently delete the classification. If false, the classification is soft-deleted and can be restored.

Delete by Name

Use DELETE /v1/classifications/name/{fqn} to delete by fully qualified name.
fqn
string
required
Fully qualified name of the classification (e.g., Certification).
recursive
boolean
default:"false"
Recursively delete all tags.
hardDelete
boolean
default:"false"
Permanently delete the classification.

Restore a Soft-Deleted Classification

Use PUT /v1/classifications/restore to restore a soft-deleted classification.
id
string
required
UUID of the soft-deleted classification to restore.
DELETE /v1/classifications/{id}

Returns

Soft delete returns the classification object with deleted: true. Hard delete returns no content (204). Restore returns the restored classification object.

Error Handling