Sign in

v1

latestOpenAPI 3.0.3RingCentral API License Agreement2026-08-064871,2921.5 MB
Devices

Swap Devices

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.
post/restapi/v2/accounts/{accountId}/extensions/{extensionId}/devices/{deviceId}/replace

Path parameters

accountIdstring required

Internal identifier of the RingCentral account (can be set to "~" to indicate that the account associated with current authorization session should be used)

extensionIdstring required

Internal identifier of the RingCentral extension/user (can be set to "~" to indicate that the extension associated with current authorization session should be used)

deviceIdstring required

Internal identifier of a source device that is currently assigned to the given extension

Request body

targetDeviceIdstring

Internal identifier of a target device, to which the current one will be swapped

Example request

{
  "targetDeviceId": "8459879873"
}

Response

No content