Sign in

v1

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

Remove phone line

Disassociates a phone line (DL & Device) from an extension:

  • if the value of keepAssetsInInventory is true, the given device is moved to unassigned devices and the number is moved to the number inventory;
  • if the value of keepAssetsInInventory is false, the given device and number is removed from the account;
  • if the parameter keepAssetsInInventory is not set (empty body), default value true is set.
delete/restapi/v2/accounts/{accountId}/devices/{deviceId}

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)

deviceIdstring required

Internal identifier of a source device

Request body

keepAssetsInInventoryboolean required

The flag that controls what to do with the number and device:

  • if the value of keepAssetsInInventory is true, the given device is moved to unassigned devices and the number is moved to the number inventory;
  • if the value of keepAssetsInInventory is false, the given device and number is removed from the account;
  • if the parameter keepAssetsInInventory is not set (empty body) or the value of the parameter is empty, default value true is set.

Response

Successful response (when keepAssetsInInventory is true)

idstring required

Internal identifier of a source device

type'HardPhone' | 'SoftPhone' | 'OtherPhone' | 'MobileDevice' | 'BLA' | 'Paging' | 'WebPhone' | 'WebRTC' | 'ZoomMobile' | 'ZoomPhone' | 'Room' | 'Unknown' required

Device type

namestring required

The display name of a source device

serialstring

Serial number of a device (HardPhone)

Example response

{
  "name": "My Device N1",
  "serial": "ff:ff:ff:ff:ff:ff"
}