Docs
open_in_new Sign in Get API key
tags

List tags

Returns every tag in the workspace, ordered by name. Tags are the labels used to categorise conversations. Use a tag's id as tag_id on GET /conversations to find every conversation carrying it. Tags also appear inline on each conversation (see tags on a conversation).

GET /api/v1/tags

Response fields

data
array of object
A tag as it appears inline on a conversation — just enough to render it. The full catalog entry (with description and usage count) is returned by GET /tags.
id
string
name
string
color
string · nullable
Hex colour (e.g. #2E7D32), or null if the tag has no colour.
description
string · nullable
applied_count
integer
Number of conversations the tag is applied to. Excludes AI-suggested applications the user hasn't accepted.
next_cursor
string · nullable
has_more
boolean