Skip to main content
PUT
/
user
/
phone-numbers
/
{id}
Update phone number
curl --request PUT \
  --url https://app.autocalls.ai/api/user/phone-numbers/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "nickname": "<string>"
}
'
{
  "message": "Phone number updated successfully.",
  "data": {
    "id": 1,
    "phone_number": "+14155551234",
    "nickname": "Sales line",
    "country_code": "US",
    "type": "normal"
  }
}
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
{
  "message": "Phone number updated successfully.",
  "data": {
    "id": 1,
    "phone_number": "+14155551234",
    "nickname": "Sales line",
    "country_code": "US",
    "type": "normal"
  }
}
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.