Skip to main content
POST
/
v2
/
tag-groups
/
public
curl --request POST \
  --url 'https://api-prod.usefini.com/v2/tag-groups/public' \
  --header 'Authorization: Bearer fini_your_api_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "title": "Resolution Outcome",
    "description": "Post-reply outcome tags for downstream workflows.",
    "prompt": "Apply the tag that best describes how the assistant handled the conversation.",
    "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 workflows.",
  "prompt": "Apply the tag that best describes how the assistant handled the conversation.",
  "multiselect": false,
  "updatedAt": "2026-06-19T07:30:11.000Z",
  "mandatory": false,
  "isOutputTagGroup": true
}
Creates a custom tag group and returns the stored TagGroup.

​
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

​
Body parameters

​
title
string
required
Group title.
​
description
string
Optional group description.
​
prompt
string
Optional AI-instruction text for the group’s tag selection logic.
​
multiselect
boolean
Optional flag controlling whether the group allows multiple tags per conversation.
​
isOutputTagGroup
boolean
Optional 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 POST \
  --url 'https://api-prod.usefini.com/v2/tag-groups/public' \
  --header 'Authorization: Bearer fini_your_api_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "title": "Resolution Outcome",
    "description": "Post-reply outcome tags for downstream workflows.",
    "prompt": "Apply the tag that best describes how the assistant handled the conversation.",
    "multiselect": false,
    "isOutputTagGroup": true
  }'

​
Response

Returns the created 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 workflows.",
  "prompt": "Apply the tag that best describes how the assistant handled the conversation.",
  "multiselect": false,
  "updatedAt": "2026-06-19T07:30:11.000Z",
  "mandatory": false,
  "isOutputTagGroup": true
}

​
Errors

The body is malformed or missing the required title.
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 creating the tag group in storage.