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

# Update phone number

> Update a phone number's nickname

This endpoint updates the editable attributes of a phone number you own. Currently this is the **nickname** — a short, human-friendly label (e.g. "Sales line", "Support — US") shown next to the number across the dashboard.

Only the **owner** of the number can update it. Numbers shared with you (granted) display the nickname but cannot be changed by you.

### Path Parameters

**id** `integer` *required*

The unique identifier of the phone number to update

### Body Parameters

**nickname** `string`

A short label for the phone number. Maximum 50 characters. Send `null` or an empty string to clear it.

### Response

**message** `string`

Success message

**data** `object`

The updated phone number

**properties**

**id** `integer`

The unique identifier of the phone number

**phone\_number** `string`

The phone number in E.164 format

**nickname** `string`

The phone number's nickname (or `null` if not set)

**country\_code** `string`

The ISO 3166-1 alpha-2 country code

**type** `string`

The type of phone number: `normal`, `sip`, or `caller_id`

```json 200 Response 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}
{
  "error": "Phone number not found."
}
```

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

> [!NOTE]
>
> The nickname is the same label you can set in the dashboard. It is returned by the phone number listing endpoints (`GET /user/phone-numbers/all`, `GET /user/phone-numbers/sip-trunks`), so other resources that reference a number by `phone_number_id` can resolve its nickname from there.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.