---
title: "Rename a phone"
method: PATCH
path: "/phones/{phone_id}/nickname"
tags: ["Phones"]
---

# Rename a phone

`PATCH /phones/{phone_id}/nickname`

Sets the human-readable display name on a private phone the caller's org owns. Returns the updated phone summary.

## Path parameters

- `phone_id` string, required — device identifier

## Request body

- PhoneUpdateNicknameRequest
  - `nickname` string, required

## Response `200`

OK

- PhonePhoneSummary
  - `agent_version` string, nullable, required
  - `android_version` string, nullable, required
  - `create_date` string, date-time, required
  - `current_session_id` string, nullable, required
  - `id` string, required
  - `imei1` string, nullable, required
  - `imei2` string, nullable, required
  - `last_heartbeat` string, date-time, nullable, required
  - `last_interaction_timestamp` string, date-time, nullable, required
  - `location` string, nullable, required
  - `model_id` string, nullable, required
  - `model_name` string, nullable, required
  - `nickname` string, nullable, required
  - `one_ui_version` string, nullable, required
  - `owner_organization_id` string, nullable, required
  - `ownership_type` string, required
  - `phone_id` string, required
  - `phone_metadata` object, required
  - `phone_name` string, nullable, required
  - `phone_serial` string, nullable, required
  - `phone_type` string, nullable, required
  - `rental_expires_at` string, date-time, nullable, required
  - `status` string, required
  - `update_date` string, date-time, required

## Other responses

- `default` — Error

---

[API](https://skmtc.dev/axilioai/apis/axilio-api-2.md) · [All operations](https://skmtc.dev/axilioai/apis/axilio-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/axilioai/axilio-api-2/revisions/d7ecf9466d6d/schema)