Endpoint

Tags

The workspace tag list that contact tags come from.

I percorsi sono relativi all'URL di base. Ogni scheda indica il permesso richiesto dalla chiamata e ogni parametro, con tipo e limiti.

GET

/tags

List workspace tags.

Permesso: contacts

POST

/tags

Create a workspace tag.

Permesso: contacts

Corpo JSON

nameobbligatoriostring
1–80 characters. Must be unique (case-insensitive), else 409.
coloropzionaleenum | null
Tag color.
Valori consentiti: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.

Permesso: contacts

Parametri del percorso

idobbligatoriointeger
Tag ID.

Corpo JSON

nameopzionalestring
1–80 characters.
coloropzionaleenum | null
Tag color.
Valori consentiti: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.

Permesso: contacts

Parametri del percorso

idobbligatoriointeger
Tag ID.