Cet endpoint effectue une mise à jour partielle. Seuls les champs envoyés sont modifiés. key et type ne peuvent pas être modifiés.
Champs du body
| Champ | Type | Description |
|---|---|---|
label | string | Nouveau nom affiché |
description | string | Description du champ. Une valeur vide l'efface |
options | array | Remplace toute la liste d'options avec des objets { label, key? }. Champs DROPDOWN uniquement |
Renommer des options
Les clés d'options restent stables. Pour renommer une option, envoyez sa key actuelle avec le nouveau label. Une option envoyée sans key correspondante est considérée comme nouvelle et reçoit une clé dérivée de son label. Les options absentes de la liste sont supprimées.
Champs synchronisés depuis un CRM
Un champ dont la source n'est pas allo est géré par votre intégration CRM et ne peut pas être modifié. Toute mise à jour renvoie 409 ATTRIBUTE_MANAGED_BY_INTEGRATION. Les champs natifs comme name ou company renvoient 400 ATTRIBUTE_BUILT_IN.
Réponse
Renvoie 200 avec le champ mis à jour, dans le même format que Lister les champs personnalisés.
{
"data": {
"key": "lead_status",
"label": "Lead temperature",
"type": "DROPDOWN",
"options": [
{ "key": "hot", "label": "Hot" },
{ "key": "warm", "label": "Warm" },
{ "key": "cold", "label": "Cold" }
],
"source": "allo"
}
}
Erreurs
| Statut | Code | Quand |
|---|---|---|
400 | ATTRIBUTE_LABEL_INVALID | label est vide, dépasse 255 caractères ou ne contient ni lettre ni chiffre |
400 | ATTRIBUTE_OPTION_INVALID | Un label d'option est vide, dépasse 255 caractères ou est en doublon |
400 | ATTRIBUTE_OPTIONS_NOT_SUPPORTED | options envoyé pour un champ qui n'est pas DROPDOWN |
400 | ATTRIBUTE_BUILT_IN | La clé est celle d'un champ natif, pas d'un champ personnalisé |
403 | API_KEY_INSUFFICIENT_SCOPE | La clé n'a pas le scope CRM_WRITE |
404 | TEAM_NOT_FOUND | L'espace de travail n'utilise pas le nouveau modèle de contacts |
404 | ATTRIBUTE_NOT_FOUND | Aucun champ avec cette clé, ou le champ a été supprimé |
409 | ATTRIBUTE_MANAGED_BY_INTEGRATION | Le champ est géré par une intégration CRM |