> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Mettre à jour un numéro de téléphone

> Met à jour le surnom d’un numéro de téléphone

<Warning>
  **API Famulor 1.0 (héritée).** Cette page concerne uniquement Famulor 1.0 (`app.famulor.de`) et est conservée pour la compatibilité. Pour la plateforme actuelle, consultez la [référence API Famulor 2.0](/fr/api-reference/introduction).
</Warning>

Ce point de terminaison met à jour les attributs modifiables d’un numéro de téléphone que vous possédez. Actuellement, il s’agit du **surnom** — une étiquette courte et conviviale (par ex. « Ligne commerciale », « Support — US ») affichée à côté du numéro dans le tableau de bord.

Seul le **propriétaire** du numéro peut le mettre à jour. Les numéros partagés avec vous (accordés) affichent le surnom mais ne peuvent pas être modifiés par vous.

### Paramètres de chemin

<ParamField path="id" type="integer" required>
  L’identifiant unique du numéro de téléphone à mettre à jour
</ParamField>

### Paramètres du corps

<ParamField body="nickname" type="string">
  Une courte étiquette pour le numéro de téléphone. 50 caractères maximum. Envoyez `null` ou une chaîne vide pour l’effacer.
</ParamField>

### Réponse

<ResponseField name="message" type="string">
  Message de succès
</ResponseField>

<ResponseField name="data" type="object">
  Le numéro de téléphone mis à jour

  <Expandable title="propriétés">
    <ResponseField name="id" type="integer">
      L’identifiant unique du numéro de téléphone
    </ResponseField>

    <ResponseField name="phone_number" type="string">
      Le numéro de téléphone au format E.164
    </ResponseField>

    <ResponseField name="nickname" type="string">
      Le surnom du numéro de téléphone (ou `null` s’il n’est pas défini)
    </ResponseField>

    <ResponseField name="country_code" type="string">
      Le code pays ISO 3166-1 alpha-2
    </ResponseField>

    <ResponseField name="type" type="string">
      Le type de numéro de téléphone : `normal`, `sip` ou `caller_id`
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 Response theme={null} theme={null}
  {
    "message": "Phone number updated successfully.",
    "data": {
      "id": 1,
      "phone_number": "+14155551234",
      "nickname": "Sales line",
      "country_code": "US",
      "type": "normal"
    }
  }
  ```

  ```json 404 Not Found theme={null} theme={null}
  {
    "error": "Phone number not found."
  }
  ```

  ```json 422 Validation Error theme={null} theme={null}
  {
    "message": "The nickname must not exceed 50 characters.",
    "errors": {
      "nickname": ["The nickname must not exceed 50 characters."]
    }
  }
  ```
</ResponseExample>

<Note>
  Le surnom est la même étiquette que celle que vous pouvez définir dans le tableau de bord. Il est renvoyé par les points de terminaison de liste des numéros de téléphone (`GET /user/phone-numbers/all`, `GET /user/phone-numbers/sip-trunks`), afin que les autres ressources faisant référence à un numéro via `phone_number_id` puissent en résoudre le surnom à partir de là.
</Note>