PUT configuration/:id

Update the configuration of a device.

Resource URL

https://eu.connect-prod.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://eu.connect-prod.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.