Modify Device Password

Changes the access password of a device. The device must be online, and the server waits for device confirmation before returning the result.

Endpoint

PUT /wlte/v1/devices/{deviceId}/password

Authorization Requirements

Scope	Required	Description
device:manage	Yes	Modify a device password

Request Parameters

Field	Type	Required	Description
oldPassword	string	Yes	Current device password. Must be 4 characters
newPassword	string	Yes	New device password. Must be 4 characters

Request Example

{
  "oldPassword": "1234",
  "newPassword": "5678"
}

curl example:

curl --request PUT '{baseUrl}/wlte/v1/devices/{deviceId}/password' \
  --header 'Authorization: Bearer {accessToken}' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --data '{
    "oldPassword": "1234",
    "newPassword": "5678"
  }'

Response Example

{
  "code": "SUCCESS",
  "message": "OK.",
  "requestId": "7d2e2e30-36d7-4e31-9e89-c840f54185f8",
  "data": {
    "deviceId": "rek083895063",
    "updated": true
  }
}

Common Errors

HTTP Status	code	Description
400	INVALID_REQUEST	Missing parameters, or password is not 4 characters
403	AUTH_SCOPE_DENIED	The API Key does not have the device:manage permission
404	DEVICE_NOT_FOUND	The device does not exist, or this API Key cannot access it
409	DEVICE_OFFLINE	The device is offline, so the result cannot be confirmed
429	RATE_LIMITED	Too many requests. Wait and retry
504	DEVICE_TIMEOUT	The device did not confirm the update within the wait time

The response never includes the old or new password.