Skip to main content
DELETE
/
v2
/
tag-groups
/
{id}
/
public
curl --request DELETE \
  --url 'https://api-prod.usefini.com/v2/tag-groups/f770d0bb-d5ea-44e7-a92a-fcfa2d5a32d5/public' \
  --header 'Authorization: Bearer fini_your_api_key'

{
  "success": true
}
Deletes a custom tag group.
Use this route only for workspace-owned custom groups you created. Tag-level routes live on Tags.

​
Headers

​
Authorization
string
required
Bearer token containing your Fini workspace API key. Format: Bearer fini_... The key needs write scope.

​
Path parameters

​
id
string
required
Tag group ID to delete.
curl --request DELETE \
  --url 'https://api-prod.usefini.com/v2/tag-groups/f770d0bb-d5ea-44e7-a92a-fcfa2d5a32d5/public' \
  --header 'Authorization: Bearer fini_your_api_key'

​
Response

​
success
boolean
true when the delete completed successfully.
{
  "success": true
}
Current controller behavior: unknown IDs and attempts to delete mandatory groups currently surface as 500 Internal Server Error on this public route.

​
Errors

The API key is missing, malformed, revoked, or invalid.
The API key does not include the write scope required for this route.
Fini failed while deleting the tag group. Unknown or non-deletable IDs currently surface here as well.