Account Device Line

Update device line

Use to update a device line by device ID. To modify the MAC Address or the Device Type, we strongly recommend to use the <a href="#/~operation/Account%20Device%20Line/swapDevice">Device Line Swap</a> endpoint instead. <span hidden>See more about <a href="accountDeviceLine.html#update-deviceline">Updating an Account Device Line</a>.</span>

put/v2/partition/{partitionId}/account/{accountId}/deviceline/{deviceId}

Request

Path parameters

accountIdstring required

ID of account, refers to <a href="#/~schema/Account">account.id</a>

deviceIdstring required

ID of device line, reference to <a href="#/~schema/DeviceX">device.id</a>.

partitionIdstring required

ID of partition, refers to <a href="#/~schema/PartitionX">partition.id</a>

Request body

idstring required

Not required for creating a new device line

deviceTypeIdstring required

Identifies the equipment as well as the features that the device supports. Refers to <a href="#/~schema/DeviceTypeX">deviceType.id</a>. See also: <a href="#/~operation/Reference%20Resources/getDeviceTypes">Get All Device Types</a> and <a href="#/~operation/Reference%20Resources/getDeviceTypeById">Get Device Type by ID</a>

accountIdstring required

Not required for creating a new device line

partitionIdstring required

Not required for creating a new device line

macAddressstring

The 48-bit hexadecimal address assigned to the device by the manufacturer. Required if the device line refers to a physical device. Must not be claimed in another device request.

deviceNamestring required
emergencyNumberstring

Required if emergencyNumberReservationId is absent

emergencyNumberReservationIdstring

Required if emergencyNumber is absent

faxEnabledboolean required
lineNumberinteger required

Required for POST & PUT operations only

userIdstring required
sipPasswordstring
sipUsernamestring

Required to be globally unique if specified

zipcodestring
statestring
lineType'Line' | 'AdvancedSharedLine' | 'ReferencedUser' | 'IntercomLine' | 'PresenceBlfUser' | 'SpeedDialUser' | 'SpeedDialTn' | 'CallParkingSpot' | 'SipPaging' | 'Custom'
referenceIdstring

Changes Depending on LineType. If LineType.Line then this should be null. If LineType.ReferencedUser, PresenceBlfUser, or SpeedDialUser then this should be a valid userid. If LineType.SpeedDialTn then this should be a valid phone number.

Response

Successful operation

idstring required

Not required for creating a new device line

deviceTypeIdstring required

Identifies the equipment as well as the features that the device supports. Refers to <a href="#/~schema/DeviceTypeX">deviceType.id</a>. See also: <a href="#/~operation/Reference%20Resources/getDeviceTypes">Get All Device Types</a> and <a href="#/~operation/Reference%20Resources/getDeviceTypeById">Get Device Type by ID</a>

accountIdstring required

Not required for creating a new device line

partitionIdstring required

Not required for creating a new device line

macAddressstring

The 48-bit hexadecimal address assigned to the device by the manufacturer. Required if the device line refers to a physical device. Must not be claimed in another device request.

deviceNamestring required
emergencyNumberstring

Required if emergencyNumberReservationId is absent

emergencyNumberReservationIdstring

Required if emergencyNumber is absent

faxEnabledboolean required
lineNumberinteger required

Required for POST & PUT operations only

userIdstring required
sipPasswordstring
sipUsernamestring

Required to be globally unique if specified

zipcodestring
statestring
lineType'Line' | 'AdvancedSharedLine' | 'ReferencedUser' | 'IntercomLine' | 'PresenceBlfUser' | 'SpeedDialUser' | 'SpeedDialTn' | 'CallParkingSpot' | 'SipPaging' | 'Custom'
referenceIdstring

Changes Depending on LineType. If LineType.Line then this should be null. If LineType.ReferencedUser, PresenceBlfUser, or SpeedDialUser then this should be a valid userid. If LineType.SpeedDialTn then this should be a valid phone number.

Changes

No recorded changes to this operation across all 1 revision of this API.