Skip to main content
PUT
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

string
required
Bearer token containing your Fini workspace API key. Format: Bearer fini_... The key needs write scope.
string
required
application/json

Path parameters

string
required
Tag group ID to update.

Body parameters

string
Updated group title.
string
Updated group description.
string
Updated AI-instruction text.
boolean
Updated multi-select behavior.
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.

Response

Returns the updated TagGroup.
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.