PUT configuration/:id

Update the configuration of a device.

Resource URL

https://production-connect.blacklinesafety.com/1/configuration/:id

General Parameters

id required	The id of the device. Example Value: 555
network_timeout optional	The period (in minutes) that a device must communicate before it is considered offline (min: 0, max: 60). Default Value: 15

Fall Detection Unit (fdu) Parameters

fall_detection_enabled optional	The fall detection enabled flag. Default Value: true
no_motion_enabled optional	The no motion enabled flag. Default Value: true
no_motion_timeout optional	The number of minutes of no motion before an alarm is triggered (min: 1, max:30). Default Value: 5
manual_checkin_enabled optional	The manual check in enabled flag. Default Value: false
manual_checkin_timeout optional	The timeout in minutes for a manual check in (min: 1, max: 180). Default Value: 60
motion_sensitivity optional	The sensitivity of the motion detector in percent, where 100% detects the most motion (min: 0, max: 100). Default Value: 50
silent_alarm_enabled optional	The silent alarm enabled flag. Default Value: true
emergency_alarm_enabled optional	The emergency alarm enabled flag. Default Value: true
visual_alarm_enabled optional	The visual alarm enabled flag. This is to enable/disable the lights on the FDU. Default Value: true
use_gps_as_motion optional	The use GPS as motion flag. This is useful if traveling in a vehicle (no motion is picked up but are considered moving). Default Value: true
gps_motion_cutoff_speed optional	The cutoff speed for using GPS as motion in Km/hr. Speed greater than the cutoff is considered motion (min: 20, max:255) Default Value: 25
alarm_acknowledge_timeout optional	The amount of time in seconds the user has to acknowledge an alarm before it becomes an alert (min: 30, max: 240). Default Value: 30
gsm_lost_alarm_timeout optional	The timeout in minutes before sending an alert after GSM has been lost (min: 1, max: 30). Default Value: 5
low_battery_alarm_level optional	The battery level, in percent, at which a low battery alert is generated. Must be an increment of 10% and 0% is the equivalent of off (min:0, max:100). Default Value: 20
gsm_lost_alarm_enabled optional	The GSM lost alarm enabled flag. Default Value: false

Loner Mobile Specific (mobile) Parameters

language optional	The language of the device. Must be one of: english, french
fdu_required optional	The FDU required flag. Default Value: false
checkin_on_fdu_motion optional	The check in on FDU motion flag. Default Value: true
gps_publish_period optional	This is the period in minutes which Loner Mobile send locations to the server (min:0, max:60, 0 = disabled). Default Value: 15
automatic_shutdown_threshold optional	The battery percentage in which the device shuts down. Must be an increment of 10% and 0% is the equivalent of off (min:0, max:100). Default Value: 0 (off)
alarm_sound_enabled optional	Is the alarm sound enabled. Default Value: true
alarm_vibration_enabled optional	Is the alarm vibration enabled. Default Value: true

Example Request

PUT	https://production-connect.blacklinesafety.com/1/configuration/555?access_token=abcd

Request Data

{
    "network_timeout": 15,
    "fdu":{
        "fall_detection_enabled": true,
        "no_motion_enabled": false,
        "no_motion_timeout": 10,
        "manual_checkin_enabled": false,
        "manual_checkin_timeout": 10,
        "motion_sensitivity": 80,
        "silent_alarm_enabled": false,
        "emergency_alarm_enabled": true,
        "visual_alarm_enabled": true,
        "use_gps_as_motion": false,
        "gps_motion_cutoff_speed": 25,
        "alarm_acknowledge_timeout": 30,
        "gsm_lost_alarm_timeout": 5,
        "low_battery_alarm_level": 30,
        "gsm_lost_alarm_enabled": false
    },
    "mobile":{
        "language":"english",
        "fdu_required":false,
        "checkin_on_fdu_motion":true,
        "gps_publish_period":15,
        "automatic_shutdown_threshold":0,
        "alarm_sound_enabled":true,
        "alarm_vibration_enabled":true
    }
}

Request Response

No response data is sent on a successful PUT.