Skip to main content
DELETE
/
v2
/
tag-groups
/
{id}
/
tags
/
public
curl --request DELETE \
  --url 'https://api-prod.usefini.com/v2/tag-groups/0dc53764-a417-4a4f-b7f4-63149529f530/tags/public' \
  --header 'Authorization: Bearer fini_your_api_key'

import requests

tag_id = "0dc53764-a417-4a4f-b7f4-63149529f530"
response = requests.delete(
    f"https://api-prod.usefini.com/v2/tag-groups/{tag_id}/tags/public",
    headers={"Authorization": "Bearer fini_your_api_key"},
)
result = response.json()

const tagId = "0dc53764-a417-4a4f-b7f4-63149529f530";

const response = await fetch(
  `https://api-prod.usefini.com/v2/tag-groups/${tagId}/tags/public`,
  {
    method: "DELETE",
    headers: {
      Authorization: "Bearer fini_your_api_key",
    },
  }
);
const result = await response.json();

{
  "success": true
}
Deletes one tag.
The {id} path segment is the tag ID on this route, not the tag group ID.

​
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 ID to delete.
curl --request DELETE \
  --url 'https://api-prod.usefini.com/v2/tag-groups/0dc53764-a417-4a4f-b7f4-63149529f530/tags/public' \
  --header 'Authorization: Bearer fini_your_api_key'

import requests

tag_id = "0dc53764-a417-4a4f-b7f4-63149529f530"
response = requests.delete(
    f"https://api-prod.usefini.com/v2/tag-groups/{tag_id}/tags/public",
    headers={"Authorization": "Bearer fini_your_api_key"},
)
result = response.json()

const tagId = "0dc53764-a417-4a4f-b7f4-63149529f530";

const response = await fetch(
  `https://api-prod.usefini.com/v2/tag-groups/${tagId}/tags/public`,
  {
    method: "DELETE",
    headers: {
      Authorization: "Bearer fini_your_api_key",
    },
  }
);
const result = await response.json();

​
Response

​
success
boolean
true when the delete completed successfully.
{
  "success": true
}
Current controller behavior: unknown tag IDs currently surface as 500 Internal Server Error on this route. Tags in Fini-managed groups are also not part of the supported write contract.

​
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 resolving the tag or deleting it from storage.