> ## 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.

# Actualizar número de teléfono

> Actualiza el apodo de un número de teléfono

<Warning>
  **API de Famulor 1.0 (legado).** Esta página se aplica únicamente a Famulor 1.0 (`app.famulor.de`) y se conserva por compatibilidad. Para la plataforma actual, usa la [referencia de la API de Famulor 2.0](/es/api-reference/introduction).
</Warning>

Este endpoint actualiza los atributos editables de un número de teléfono de tu propiedad. Actualmente se trata del **apodo**: una etiqueta corta y descriptiva (p. ej., «Línea de ventas», «Soporte — US») que se muestra junto al número en todo el panel.

Solo el **propietario** del número puede actualizarlo. Los números compartidos contigo (concedidos) muestran el apodo, pero no puedes modificarlo.

### Parámetros de ruta

<ParamField path="id" type="integer" required>
  El identificador único del número de teléfono que se va a actualizar
</ParamField>

### Cuerpo de la solicitud

<ParamField body="nickname" type="string">
  Una etiqueta corta para el número de teléfono. Máximo 50 caracteres. Envía `null` o una cadena vacía para borrarla.
</ParamField>

### Respuesta

<ResponseField name="message" type="string">
  Mensaje de éxito
</ResponseField>

<ResponseField name="data" type="object">
  El número de teléfono actualizado

  <Expandable title="propiedades">
    <ResponseField name="id" type="integer">
      El identificador único del número de teléfono
    </ResponseField>

    <ResponseField name="phone_number" type="string">
      El número de teléfono en formato E.164
    </ResponseField>

    <ResponseField name="nickname" type="string">
      El apodo del número de teléfono (o `null` si no está establecido)
    </ResponseField>

    <ResponseField name="country_code" type="string">
      El código de país ISO 3166-1 alfa-2
    </ResponseField>

    <ResponseField name="type" type="string">
      El tipo de número de teléfono: `normal`, `sip` o `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>
  El apodo es la misma etiqueta que puedes establecer en el panel. Lo devuelven los endpoints de listado de números de teléfono (`GET /user/phone-numbers/all`, `GET /user/phone-numbers/sip-trunks`), de modo que otros recursos que hagan referencia a un número mediante `phone_number_id` pueden resolver su apodo a partir de ahí.
</Note>