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

Delete a Tag

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

Delete by ID

string
required
UUID of the tag to delete.
boolean
default:"false"
Recursively delete child tags.
boolean
default:"false"
Permanently delete the tag. If false, the tag is soft-deleted and can be restored.

Delete by Name

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

Restore a Soft-Deleted Tag

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

Returns

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

Error Handling