v1

latestOpenAPI 3.0.32026-07-268955212.1 KB
tag-groups

[Preview] Create a tag in a tag group

Creates a new tag (value) within the specified tag group.

Tag names must be unique within the tag group.

The company must have the Tags feature enabled in their price plan.

Preview: This endpoint is in preview and may change or be removed before general availability. Read the full preview policy

Scope: tags:write

post/companies/{companyId}/tag-groups/{tagGroupId}/tags

Request body

namestring required

Name of the tag (must be unique within the tag group)

Example request

{
  "name": "Project Alpha"
}

Response

Tag created

idstring uuid

Unique identifier of the tag

namestring

Name of the tag

Example response

{
  "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "name": "Project Alpha"
}