Aller au contenu
Développeurs

Endpoints

Tags

The workspace tag list that contact tags come from.

Les chemins sont relatifs à l’URL de base. Chaque carte indique la permission requise par l’appel et chaque paramètre, avec son type et ses limites.

GET
/tags

List workspace tags.

Permission : contacts
POST
/tags

Create a workspace tag.

Permission : contacts

Corps JSON

  • nameobligatoirestring

    1–80 characters. Must be unique (case-insensitive), else 409.

  • colorfacultatifenum | null

    Tag color.

    Valeurs autorisées :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.

Permission : contacts

Paramètres de chemin

  • idobligatoireinteger

    Tag ID.

Corps JSON

  • namefacultatifstring

    1–80 characters.

  • colorfacultatifenum | null

    Tag color.

    Valeurs autorisées :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.

Permission : contacts

Paramètres de chemin

  • idobligatoireinteger

    Tag ID.