Skip to main content
POST
Creates a Tag inside one tag group.
Supported contract: create tags inside workspace-owned custom groups. For group-level routes, see Tag groups.

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

Body parameters

string
required
Tag label.
string
Optional tag description or instruction text.

Response

Returns the created Tag.

Errors

The body is malformed, the required tagName is missing, the tag group does not exist, the group belongs to another workspace, or the group is a Fini default or mandatory group.
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.