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
http
PUT /wlte/v1/devices/{deviceId}/passwordAuthorization 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
json
{
"oldPassword": "1234",
"newPassword": "5678"
}Response Example
json
{
"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.
