---
title: "Replace Device"
method: PUT
path: "/v4/accounts/{voip_id}/devices/{id}"
tags: ["Devices"]
---

# Replace Device

`PUT /v4/accounts/{voip_id}/devices/{id}`

## Request

- Base URL: `https://api.phone.com`
- URL: `https://api.phone.com/v4/accounts/{voip_id}/devices/{id}`
- Auth: HTTP bearer

Update the details of an individual VoIP device

## Path parameters

- `voip_id` integer, required
- `id` integer, required

## Request body

- Device
  - `name` string, nullable: Device Name
  - `lines` object[], nullable: Array of Line Objects showing which extensions are attached to this device, and their assigned line numbers
    - `line` integer, required: Line number
    - `extension` object, required: Extensions object that this line number is mapped to
      - `id` integer, nullable: ID of the extension. This is the internal Phone.com ID, not the extension number callers may dial.
      - `extension` integer, nullable: Extension number that callers may dial. On POST, leaving this empty will result in an auto-generated value. On PUT, this field is required.
      - `name` string, nullable: User-supplied name for the extension. On POST, leaving this empty will result in an auto-generated value. On PUT, this field is required.
  - `code` integer, nullable: Device Code (available for special integrations only)
  - `address` object, nullable: Address associated with this device for 911 calls
    - `line_1` string, required: Address line 1
    - `line_2` string, required: Address line 2
    - `city` string, required: City
    - `province` string, required: Contact province
    - `postal_code` string, required: Contact postal code
    - `country` string, required: Country name

## Response `200`

OK

- object

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `402`: Payment Required
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `422`: Validation failed
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/phone/apis/phoenix-api-by-phone-com.md) · [All operations](https://skmtc.dev/phone/apis/phoenix-api-by-phone-com/llms.txt) · [OpenAPI document](https://skmtc.dev/phone/apis/phoenix-api-by-phone-com/revisions/c8e33dffe904?raw)