# Mettre à jour un champ personnalisé

> Cet endpoint effectue une mise à jour partielle. Seuls les champs envoyés sont modifiés. key et type ne peuvent pas être modifiés.

`PATCH /v2/api/crm/attributes/{key}`

<Note>
**Scope requis :** `CRM_WRITE`
</Note>

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](/fr/docs/crm/list-attributes).

```json
{
  "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 |
