Skip to main content
POST
/
v2
/
tag-groups
/
{id}
/
tags
/
public
curl --request POST \
  --url 'https://api-prod.usefini.com/v2/tag-groups/f770d0bb-d5ea-44e7-a92a-fcfa2d5a32d5/tags/public' \
  --header 'Authorization: Bearer fini_your_api_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "tagName": "resolved_by_ai",
    "tagDescription": "Use when the assistant fully resolved the request."
  }'

{
  "id": "0dc53764-a417-4a4f-b7f4-63149529f530",
  "createdAt": "2026-06-19T07:32:10.000Z",
  "tagGroupId": "f770d0bb-d5ea-44e7-a92a-fcfa2d5a32d5",
  "tagName": "resolved_by_ai",
  "tagDescription": "Use when the assistant fully resolved the request."
}
Creates a Tag inside one tag group.
Supported contract: create tags inside workspace-owned custom groups. For group-level routes, see Tag groups.

​
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 that should own the new tag.

​
Body parameters

​
tagName
string
required
Tag label.
​
tagDescription
string
Optional tag description or instruction text.
curl --request POST \
  --url 'https://api-prod.usefini.com/v2/tag-groups/f770d0bb-d5ea-44e7-a92a-fcfa2d5a32d5/tags/public' \
  --header 'Authorization: Bearer fini_your_api_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "tagName": "resolved_by_ai",
    "tagDescription": "Use when the assistant fully resolved the request."
  }'

​
Response

Returns the created Tag. 
{
  "id": "0dc53764-a417-4a4f-b7f4-63149529f530",
  "createdAt": "2026-06-19T07:32:10.000Z",
  "tagGroupId": "f770d0bb-d5ea-44e7-a92a-fcfa2d5a32d5",
  "tagName": "resolved_by_ai",
  "tagDescription": "Use when the assistant fully resolved the request."
}
Current controller behavior: unknown tag group IDs currently surface as 500 Internal Server Error on this public route.

​
Errors

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