---
title: "Swap Devices"
method: POST
path: "/restapi/v2/accounts/{accountId}/extensions/{extensionId}/devices/{deviceId}/replace"
tags: ["Devices"]
---

# Swap Devices

`POST /restapi/v2/accounts/{accountId}/extensions/{extensionId}/devices/{deviceId}/replace`

Replaces the user device with another device, which is assigned to an extension
or is stored in the inventory of the same account.
Currently, the following device types can be swapped - `HardPhone` and `OtherPhone`.

Please note:

 - This method allows replacing a device itself, while a phone number,
   a digital Line and an emergency address associated with this device remain unchanged
   and will still work together in a chain with the replacement device.
 - If a target device is from the inventory, then a source device will be moved
   to the inventory, and a target device will be assigned to the current extension.
 - If a target device is currently assigned to another extension,
   then the devices will be just swapped.

## Path parameters

- `accountId` string, required
- `extensionId` string, required
- `deviceId` string, required

## Request body

- SwapDeviceRequest — Swap device request
  - `targetDeviceId` string — Internal identifier of a target device, to which the current one will be swapped

## Response `204`

No content

## Other responses

- `400` — General response with **HTTP 400 "Bad request"** status.<br> Reasons: unparsable request, path, query or body parameters are invalid. The error description may contain reference to particular parameter(s) which haven't passed the validation.

---

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