Tags
Delete Tag Group
Delete a group and every tag in it
DELETE
/
tag-groups
/
{groupId}
curl -X DELETE "https://api.clustr-ai.com/api/public/tag-groups/5a1c3f88-92d4-4b0e-8e7a-1f2b3c4d5e60" \
-H "Authorization: Bearer YOUR_API_KEY"
{
"success": true,
"data": { "deleted": true }
}
{
"success": false,
"error": { "message": "tag group not found", "code": "NOT_FOUND" }
}
{
"success": false,
"error": { "message": "this group is built in and cannot be deleted", "code": "UNPROCESSABLE_ENTITY" }
}
This deletes the group’s tags too, and every record carrying one loses it.
It cannot be undone.Check the damage first:
GET /tag-groups?with_counts=true reports a
subject_count per tag.is_system is built in and returns 422 instead. Rename it if
its name no longer fits.
Path Parameters
string
required
The group’s id, from List Tag Groups.
curl -X DELETE "https://api.clustr-ai.com/api/public/tag-groups/5a1c3f88-92d4-4b0e-8e7a-1f2b3c4d5e60" \
-H "Authorization: Bearer YOUR_API_KEY"
{
"success": true,
"data": { "deleted": true }
}
{
"success": false,
"error": { "message": "tag group not found", "code": "NOT_FOUND" }
}
{
"success": false,
"error": { "message": "this group is built in and cannot be deleted", "code": "UNPROCESSABLE_ENTITY" }
}
⌘I
curl -X DELETE "https://api.clustr-ai.com/api/public/tag-groups/5a1c3f88-92d4-4b0e-8e7a-1f2b3c4d5e60" \
-H "Authorization: Bearer YOUR_API_KEY"
{
"success": true,
"data": { "deleted": true }
}
{
"success": false,
"error": { "message": "tag group not found", "code": "NOT_FOUND" }
}
{
"success": false,
"error": { "message": "this group is built in and cannot be deleted", "code": "UNPROCESSABLE_ENTITY" }
}