Skip to main content
Tags are the individual values inside a tag group. There is no top-level public list all tags route. Instead, the API lets you fetch one tag by ID, list the tags inside one group, or list tags across a specific set of group IDs.
If you need every tag in the workspace, first call Tag groups to collect the group IDs you care about, then call GET /v2/tag-groups/tags/public with those tagGroupIds.
Path semantics are asymmetric in the current controller:
  • POST /v2/tag-groups/{id}/tags/public uses {id} as the tag group ID
  • PUT /v2/tag-groups/tags/{id}/public uses {id} as the tag ID
  • DELETE /v2/tag-groups/tags/{id}/public uses {id} as the tag ID

​
Reference pages

Get tag

GET /v2/tags/{id}/public - fetch one tag by ID.

List tags in group

GET /v2/tag-groups/{id}/tags/public - list the tags in one tag group.

List tags across groups

GET /v2/tag-groups/tags/public - list tags across one or more tag groups.

Create tag

POST /v2/tag-groups/{id}/tags/public - create a tag inside one tag group.

Update tag

PUT /v2/tag-groups/tags/{id}/public - update one tag by tag ID.

Delete tag

DELETE /v2/tag-groups/tags/{id}/public - delete one tag by tag ID.

​
Endpoint map

​
Tag object

​
string
Tag ID.
​
string
ISO 8601 creation timestamp.
​
string
ID of the tag group that owns this tag.
​
string
Tag label.
​
string
Optional tag description or instruction text.
Use the child pages in this section for the detailed request and response reference for each route.