The API field
prompt is the wire-format name for the dashboard’s AI Instructions field.Read routes return both workspace-owned custom groups and Fini-shipped default groups. In the response, custom groups have a workspace
companyId, while default groups return companyId: null. Mandatory groups, such as Conversation Status, return mandatory: true.Reference pages
List tag groups
GET /v2/tag-groups/public - list the tag groups visible in the workspace.Get tag group
GET /v2/tag-groups/{id}/public - fetch one tag group by ID.Create tag group
POST /v2/tag-groups/public - create a custom tag group.Update tag group
PUT /v2/tag-groups/{id}/public - update a custom tag group.Delete tag group
DELETE /v2/tag-groups/{id}/public - delete a custom tag group.Endpoint map
TagGroup object
string
Tag group ID.
string
ISO 8601 creation timestamp.
string
ISO 8601 last-update timestamp.
string | null
Workspace ID that owns the tag group.
null indicates a Fini-shipped default group.string
Group title shown in the dashboard and used as the human-readable name for the classification dimension.
string
Human-readable description for the group.
string
AI-instruction text that teaches the model how to apply the group’s tags. This is the API name for the dashboard’s AI Instructions field.
boolean
Whether the group allows multiple tags to be applied to the same conversation.
boolean
Whether the group is Fini-mandatory and not intended for deletion or disabling.
boolean
Whether this is an output-only tag group. If
true, the group is for post-classification/reporting use and will not be available as a Rulebook condition, including in intent-based rules.Use the child pages in this section for the detailed request and response reference for each route.