Skip to main content
PUT
/
v2
/
tag-groups
/
{id}
/
tags
/
public
curl --request PUT \
  --url 'https://api-prod.usefini.com/v2/tag-groups/0dc53764-a417-4a4f-b7f4-63149529f530/tags/public' \
  --header 'Authorization: Bearer fini_your_api_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "tagName": "resolved_without_escalation",
    "tagDescription": "Use when the assistant fully resolved the request without handing off."
  }'

{
  "id": "0dc53764-a417-4a4f-b7f4-63149529f530",
  "createdAt": "2026-06-19T07:32:10.000Z",
  "tagGroupId": "f770d0bb-d5ea-44e7-a92a-fcfa2d5a32d5",
  "tagName": "resolved_without_escalation",
  "tagDescription": "Use when the assistant fully resolved the request without handing off."
}
Updates 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.
​
Content-Type
string
required
application/json

​
Path parameters

​
id
string
required
Tag ID to update.

​
Body parameters

​
tagName
string
Updated tag label.
​
tagDescription
string
Updated tag description or instruction text.
curl --request PUT \
  --url 'https://api-prod.usefini.com/v2/tag-groups/0dc53764-a417-4a4f-b7f4-63149529f530/tags/public' \
  --header 'Authorization: Bearer fini_your_api_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "tagName": "resolved_without_escalation",
    "tagDescription": "Use when the assistant fully resolved the request without handing off."
  }'

​
Response

Returns the updated Tag. 
{
  "id": "0dc53764-a417-4a4f-b7f4-63149529f530",
  "createdAt": "2026-06-19T07:32:10.000Z",
  "tagGroupId": "f770d0bb-d5ea-44e7-a92a-fcfa2d5a32d5",
  "tagName": "resolved_without_escalation",
  "tagDescription": "Use when the assistant fully resolved the request without handing off."
}
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 body is malformed.
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 updating it in storage.