Bulk configure devices

Set device settings in bulk, such as turning the in-cabin facing camera or distracted driver functionality on/off. Provide a list of IMEIs or group IDs.

Note: PUT calls update data entirely. Any data not mentioned in the call, will be deleted.

Request

Security:

bearerAuth

Request Body schema: application/json

One of:

organizationId required	number (Organization ID) The ID of the organization. Obtain this from GET /organizations.
groupIds	Array of integers (Group ID) The IDs of the requested groups. Obtain group IDs from GET /organizations/{orgId}/devices.
required	object (Device configuration) The device configuration object for request.

Responses

200

Successful operation

400

Bad request error

401

Unauthorized error

403

Forbidden error

404

Not found error

500

Internal server error

put/devices/device-config

Request samples

Payload
curl
JavaScript
Node.js

application/json

{"organizationId": 17,
"groupIds": [32
],
"config": {"adas": {"value": true
},
"distractedDriver": {"value": true
},
"liveVideo": {"value": true
},
"driverCamera": {"value": true
},
"textOverlay": {"value": true
},
"inCabinCameraRecording": {"value": true
},
"driverPosition": {"value": "left"
},
"speedUnits": {"value": "mph"
},
"audioAlarms": {"value": true
},
"notifyLiveStreaming": {"value": true
},
"adminPin": {"value": "1234"
},
"driverPin": {"value": "4321"
},
"brightness": {"value": 128
},
"dateTimeUnits": {"value": "us"
},
"voiceRecording": {"value": true
},
"standby": {"timeout": 10
},
"hotSpot": {"internetAccess": false,
"hotspotEnabled": true
},
"recordingEncryption": {"enabled": true,
"password": "0123456789ABCDEF"
},
"privacy": {"gpsEnabled": true,
"mvaiEnabled": true,
"liveStreamEnabled": true,
"allEventsEnabled": true,
"cameras": [{"cameraId": 1,
"recordingEnabled": true,
"eventsEnabled": true
}
]
},
"pinCodeDi": {"value": true
},
"qrDi": {"value": true
},
"driverIdentification": {"driverPrompt": true,
"audioAlert": true,
"driverPromptDurationSeconds": 30
},
"virtualIgnition": {"value": true
},
"screenTimeout": {"value": 120
},
"passengerLimit": {"value": 1
},
"wakeupMsg": {"enabled": true,
"timeout": 10
},
"ledEnabled": {"value": true
},
"setTimezoneByCloud": {"value": true
}
}
}

Response samples

application/json

{"data": {"effectedImeis": ["357660101000198"
],
"config": {"adas": {"value": true
},
"distractedDriver": {"value": true
},
"liveVideo": {"value": true
},
"driverCamera": {"value": true
},
"textOverlay": {"value": true
},
"inCabinCameraRecording": {"value": true
},
"driverPosition": {"value": "left"
},
"speedUnits": {"value": "mph"
},
"audioAlarms": {"value": true
},
"notifyLiveStreaming": {"value": true
},
"adminPin": {"value": "1234"
},
"driverPin": {"value": "4321"
},
"brightness": {"value": 128
},
"dateTimeUnits": {"value": "us"
},
"voiceRecording": {"value": true
},
"standby": {"timeout": 10
},
"hotSpot": {"internetAccess": false,
"hotspotEnabled": true
},
"recordingEncryption": {"enabled": true
},
"privacy": {"gpsEnabled": true,
"mvaiEnabled": true,
"liveStreamEnabled": true,
"allEventsEnabled": true,
"cameras": [{"cameraId": 1,
"recordingEnabled": true,
"eventsEnabled": true
}
]
},
"pinCodeDi": {"value": true
},
"qrDi": {"value": true
},
"setTimezoneByCloud": {"value": true
}
}
},
"requestId": "06327cae-e075-42ca-b620-c5cfdd3b4e37"
}