Skip to main content
POST
Error

Autorizações

Authorization
string
header
obrigatório

A staff session token, uk_st_…. Minted by sign-up, sign-in or the two-factor exchange. Only a 401 means it is spent; not_a_member (403) is about the organization named in X-Organization-Id and leaves the token good for the others.

Cabeçalhos

X-Organization-Id
string

The organization the caller is acting on — the org_… code that appears in the panel URL. It identifies; the membership JOIN is what authorizes, so a forged code reads nothing: the answer is not_a_member (403), which does not mean the session is over. Absent, the session's default organization answers, or — if that membership was revoked while the session was open — any other one the caller still holds.

Corpo

application/json
name
string
obrigatório
color
string

Any CSS color the panel should draw the tag in.

Resposta

The tag.

One word of the organization's tagging vocabulary. Organization-scoped: the same tag reaches live and test conversations alike.

id
string<uuid>
name
string

Unique per organization, case-insensitively.

color
string
created_at
string<date-time>