Skip to main content
PUT
/
v2
/
tag-groups
/
{id}
/
public
curl --request PUT \
  --url 'https://api-prod.usefini.com/v2/tag-groups/f770d0bb-d5ea-44e7-a92a-fcfa2d5a32d5/public' \
  --header 'Authorization: Bearer fini_your_api_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "description": "Post-reply outcome tags for downstream ticket workflows and reporting.",
    "prompt": "Choose the single outcome tag that best captures the final assistant handling.",
    "multiselect": false,
    "isOutputTagGroup": true
  }'

{
  "id": "f770d0bb-d5ea-44e7-a92a-fcfa2d5a32d5",
  "createdAt": "2026-06-19T07:30:11.000Z",
  "companyId": "38ba4db0-31db-4669-bb95-7b8313c4016b",
  "title": "Resolution Outcome",
  "description": "Post-reply outcome tags for downstream ticket workflows and reporting.",
  "prompt": "Choose the single outcome tag that best captures the assistant's final handling.",
  "multiselect": false,
  "updatedAt": "2026-06-19T07:46:09.000Z",
  "mandatory": false,
  "isOutputTagGroup": true
}
Updates a custom tag group and returns the stored TagGroup.
Supported contract: use this route for workspace-owned custom groups. Fini-managed groups are read-only in the product model.

​
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 group ID to update.

​
Body parameters

​
title
string
Updated group title.
​
description
string
Updated group description.
​
prompt
string
Updated AI-instruction text.
​
multiselect
boolean
Updated multi-select behavior.
​
isOutputTagGroup
boolean
Updated flag for output-only groups. If true, this group will not be available in Rulebooks, including intent-based rules, so leave it false for routing or other Rulebook conditions.
curl --request PUT \
  --url 'https://api-prod.usefini.com/v2/tag-groups/f770d0bb-d5ea-44e7-a92a-fcfa2d5a32d5/public' \
  --header 'Authorization: Bearer fini_your_api_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "description": "Post-reply outcome tags for downstream ticket workflows and reporting.",
    "prompt": "Choose the single outcome tag that best captures the final assistant handling.",
    "multiselect": false,
    "isOutputTagGroup": true
  }'

​
Response

Returns the updated TagGroup. 
{
  "id": "f770d0bb-d5ea-44e7-a92a-fcfa2d5a32d5",
  "createdAt": "2026-06-19T07:30:11.000Z",
  "companyId": "38ba4db0-31db-4669-bb95-7b8313c4016b",
  "title": "Resolution Outcome",
  "description": "Post-reply outcome tags for downstream ticket workflows and reporting.",
  "prompt": "Choose the single outcome tag that best captures the assistant's final handling.",
  "multiselect": false,
  "updatedAt": "2026-06-19T07:46:09.000Z",
  "mandatory": false,
  "isOutputTagGroup": true
}
Current controller behavior: unknown IDs and attempts to update Fini-managed groups currently surface as 500 Internal Server Error rather than a dedicated 404 or 409.

​
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 updating the tag group. Unknown or non-editable IDs currently surface here as well.