Endpoints

Tags

The workspace tag list that contact tags come from.

Pfade sind relativ zur Basis-URL. Jede Karte zeigt die Berechtigung, die der Aufruf braucht, und jeden Parameter mit Typ und Grenzen.

GET

/tags

List workspace tags.

Berechtigung: contacts

POST

/tags

Create a workspace tag.

Berechtigung: contacts

JSON-Body

nameerforderlichstring
1–80 characters. Must be unique (case-insensitive), else 409.
coloroptionalenum | null
Tag color.
Erlaubte Werte:chart-1chart-2chart-3chart-4chart-5chart-6chart-7chart-8

PATCH

/tags/:id

Rename or recolor a tag. A rename updates every contact that has it. Send name, color, or both.

Berechtigung: contacts

Pfadparameter

iderforderlichinteger
Tag ID.

JSON-Body

nameoptionalstring
1–80 characters.
coloroptionalenum | null
Tag color.
Erlaubte Werte:chart-1chart-2chart-3chart-4chart-5chart-6chart-7chart-8

DELETE

/tags/:id

Delete a tag and remove it from every contact. The response includes contacts_updated.

Berechtigung: contacts

Pfadparameter

iderforderlichinteger
Tag ID.