RoscoLive API v1.0

Create new profile in a company

POST

https://fleet.roscolive.com/api/v1.0/partners/companies/{company_name}/profiles

Add a new profile to a company. The configuration and configurationdv6 parameter is stringified JSON.

The configuration and configurationdv6 objects are camera configuration settings for the respective camera type. Only the configuration for the camera types the user wishes to update need to be changed, otherwise the configuration object can remain the same if no changes are needed.

Profile is not automatically applied to devices after creation, must use POST /device/{device_id}/config endpoint to apply config to each device.

Request

Path Params

company_name

string

required

Name of company to create new profile in

Body Params multipart/form-data

configurationdv6

string <json>

required

Configuration object for DV6 type devices

name

string

required

Name to assign to profile

configuration

string <json>

required

Configuration object for DV4 type devices

dv4_driver

enum<string>

required

Event upload option for DV4 driver event

Allowed values:

alert_onlysnapshot_onlyvideo_snapshot

dv4_high_speed

enum<string>

required

Event upload option for DV4 high speed event

Allowed values:

alert_onlysnapshot_onlyvideo_snapshot

dv4_fatal_gsensor

enum<string>

required

Event upload option for DV4 high g-force event

Allowed values:

alert_onlysnapshot_onlyvideo_snapshot

dv4_ext_driver

enum<string>

required

Event upload option for DV4 external driver event

Allowed values:

alert_onlysnapshot_onlyvideo_snapshot

dv4_distraction

enum<string>

required

Event upload option for DV4 distraction event (external hardware required)

Allowed values:

alert_onlysnapshot_onlyvideo_snapshot

dv4_drowsiness

enum<string>

required

Event upload option for DV4 drowsiness event (external hardware required)

Allowed values:

alert_onlysnapshot_onlyvideo_snapshot

dv4_phone_use

enum<string>

required

Event upload option for DV4 phone use event (external hardware required)

Allowed values:

alert_onlysnapshot_onlyvideo_snapshot

dv6_driver

enum<string>

required

Event upload option for DV6 driver event

Allowed values:

alert_onlysnapshot_onlyvideo_snapshot

dv6_high_speed

enum<string>

required

Event upload option for DV6 high speed event

Allowed values:

alert_onlysnapshot_onlyvideo_snapshot

dv6_fatal_gsensor

enum<string>

required

Event upload option for DV6 high g-force event

Allowed values:

alert_onlysnapshot_onlyvideo_snapshot

dv6_distraction

enum<string>

required

Event upload option for DV6 distraction event

Allowed values:

alert_onlysnapshot_onlyvideo_snapshot

dv6_drowsiness

enum<string>

required

Event upload option for DV6 drowsiness event

Allowed values:

alert_onlysnapshot_onlyvideo_snapshot

dv6_phone_use

enum<string>

required

Event upload option for DV6 phone use event

Allowed values:

alert_onlysnapshot_onlyvideo_snapshot

dv6_yawning

enum<string>

required

Event upload option for DV6 yawning event

Allowed values:

alert_onlysnapshot_onlyvideo_snapshot

dv6_harsh_braking

enum<string>

required

Event upload option for DV6 harsh braking event

Allowed values:

alert_onlysnapshot_onlyvideo_snapshot

dv6_harsh_accel

enum<string>

required

Event upload option for DV6 harsh acceleration event

Allowed values:

alert_onlysnapshot_onlyvideo_snapshot

dv6_lane_departure

enum<string>

required

Event upload option for DV6 lane departure event (NOT IMPLEMENTED)

Allowed values:

alert_onlysnapshot_onlyvideo_snapshot

dv6_forward_collision

enum<string>

required

Event upload option for DV6 forward collision event

Allowed values:

alert_onlysnapshot_onlyvideo_snapshot

dv6_headway_monitoring

enum<string>

required

Event upload option for DV6 headway monitoring event

Allowed values:

alert_onlysnapshot_onlyvideo_snapshot

dv6_following_distance

enum<string>

required

Event upload option for DV6 following distance event

Allowed values:

alert_onlysnapshot_onlyvideo_snapshot

dv6_seatbelt

enum<string>

required

Event upload option for DV6 seatbelt event

Allowed values:

alert_onlysnapshot_onlyvideo_snapshot

dv6_smoking

enum<string>

required

Event upload option for DV6 smoking event

Allowed values:

alert_onlysnapshot_onlyvideo_snapshot

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://fleet.roscolive.com/api/v1.0/partners/companies//profiles' \
--form 'configurationdv6=""' \
--form 'name=""' \
--form 'configuration=""' \
--form 'dv4_driver=""' \
--form 'dv4_high_speed=""' \
--form 'dv4_fatal_gsensor=""' \
--form 'dv4_ext_driver=""' \
--form 'dv4_distraction=""' \
--form 'dv4_drowsiness=""' \
--form 'dv4_phone_use=""' \
--form 'dv6_driver=""' \
--form 'dv6_high_speed=""' \
--form 'dv6_fatal_gsensor=""' \
--form 'dv6_distraction=""' \
--form 'dv6_drowsiness=""' \
--form 'dv6_phone_use=""' \
--form 'dv6_yawning=""' \
--form 'dv6_harsh_braking=""' \
--form 'dv6_harsh_accel=""' \
--form 'dv6_lane_departure=""' \
--form 'dv6_forward_collision=""' \
--form 'dv6_headway_monitoring=""' \
--form 'dv6_following_distance=""' \
--form 'dv6_seatbelt=""' \
--form 'dv6_smoking=""'

Responses

🟢201Profile Created

application/json

Body

meta

object

required

Request metadata object

code

integer

required

HTTP status code returned by server

response

object

required

Contains response data

profile

object (Profile)

required

Profile object of newly created profile

result

string

required

"OK" if request successful, otherwise "Failed"

Example

{
  "meta": {
    "code": 201
  },
  "response": {
    "profile": {
      "comments": null,
      "configuration": "{\"Channels\": [{\"index\": 0, \"ParkingQuality\": 1, \"Substream\": true, \"Enabled\": true, \"ParkingFPS\": 1, \"Record\": 1, \"MainQuality\": 2, \"MainFPS\": 15, \"Audio\": 0}, {\"index\": 1, \"ParkingQuality\": 1, \"Substream\": true, \"Enabled\": true, \"ParkingFPS\": 1, \"Record\": 1, \"MainQuality\": 2, \"MainFPS\": 15, \"Audio\": 1}, {\"index\": 2, \"ParkingQuality\": 1, \"Substream\": true, \"Enabled\": false, \"ParkingFPS\": 1, \"Record\": 1, \"MainQuality\": 2, \"MainFPS\": 15, \"Audio\": 1}, {\"index\": 3, \"ParkingQuality\": 1, \"Substream\": true, \"Enabled\": false, \"ParkingFPS\": 1, \"Record\": 1, \"MainQuality\": 2, \"MainFPS\": 15, \"Audio\": 1}], \"Debug\": {\"LcdDisplayMode\": 0, \"UseLegacyLive\": false}, \"Overlay\": {\"ShowSpeed\": true}, \"General\": {\"TimeZone\": \"US/Eastern\", \"IgnitionShutdownDelay\": 60}, \"Event\": {\"Accelerometer\": {\"Enable\": {\"Y\": true, \"X\": true, \"Z\": false}, \"TriggerOutput\": -1, \"FatalThreshold\": {\"Y\": 1.2, \"X\": 1.2, \"Z\": 2}, \"Enabled\": true, \"ParkingThreshold\": {\"Y\": 0.2, \"X\": 0.2, \"Z\": 1.2}, \"SendToCloud\": false, \"FatalSendToCloud\": true, \"Threshold\": {\"Y\": 10, \"X\": 10, \"Z\": 10}, \"FatalTriggerOutput\": -1}, \"PanicButton\": {\"Enabled\": true}, \"Adas\": {\"Pedestrian\": {\"SendToCloud\": false, \"Enabled\": false}, \"SpeedThreshold\": 0, \"LaneDeparture\": {\"SendToCloud\": false, \"Enabled\": false}, \"Headway\": {\"SendToCloud\": false, \"Enabled\": false}, \"ForwardCollision\": {\"SendToCloud\": false, \"Enabled\": false}}, \"HighSpeed\": {\"Threshold\": 112.65, \"SendToCloud\": false, \"Enabled\": false, \"TriggerOutput\": -1}, \"Voltage\": {\"HighThreshold\": 32, \"ShutdownDelay\": 20, \"LowThreshold\": 11.4, \"Enabled\": true, \"RecoveryThreshold\": 11.6}, \"BuzzerEnabled\": false, \"Sensor\": [{\"index\": 0, \"SendToCloud\": false, \"Name\": \"Sensor #1\", \"TriggerOutput\": -1, \"ActiveHigh\": true, \"Enabled\": false, \"ShortName\": \"S1\"}, {\"index\": 1, \"SendToCloud\": false, \"Name\": \"Sensor #2\", \"TriggerOutput\": -1, \"ActiveHigh\": true, \"Enabled\": false, \"ShortName\": \"S2\"}, {\"index\": 2, \"SendToCloud\": false, \"Name\": \"Sensor #3\", \"TriggerOutput\": -1, \"ActiveHigh\": true, \"Enabled\": false, \"ShortName\": \"S3\"}, {\"index\": 3, \"SendToCloud\": false, \"Name\": \"Sensor #4\", \"TriggerOutput\": -1, \"ActiveHigh\": true, \"Enabled\": false, \"ShortName\": \"S4\"}, {\"index\": 4, \"SendToCloud\": true, \"Name\": \"External Driver Event\", \"TriggerOutput\": -1, \"Enabled\": true, \"ShortName\": \"EE\"}, {\"index\": 8, \"SendToCloud\": true, \"TriggerOutput\": -1}], \"HighTemperature\": {\"Threshold\": 99, \"ShutdownDelay\": 150, \"Enabled\": true}, \"Dms\": {\"Distraction\": {\"Enabled\": false, \"SendToCloud\": false}, \"PhoneUse\": {\"Enabled\": false, \"SendToCloud\": false}, \"Dozing\": {\"Enabled\": false, \"SendToCloud\": false}, \"HeadDown\": {\"Enabled\": false, \"SendToCloud\": false}, \"Enabled\": false, \"Yawning\": {\"Enabled\": false, \"SendToCloud\": false}}}, \"Servers\": {\"Ads\": {\"ShutdownDelay\": 480}}, \"System\": {\"SpeedUnit\": 1, \"BacklightLow\": 100, \"BacklightHigh\": 800, \"DisplaySpeed\": false}, \"Recording\": {\"LockEventFiles\": false}, \"Peripherals\": {\"Mobileye\": {\"Enabled\": false}, \"Dms\": {\"Enabled\": false}}}",
      "configurationdv6": "{\"Channels\": [{\"index\": 0, \"ParkingQuality\": 1, \"Substream\": true, \"Enabled\": true, \"ParkingFPS\": 1, \"Record\": 1, \"MainQuality\": 2, \"MainFPS\": 24, \"Audio\": 0}, {\"index\": 1, \"ParkingQuality\": 1, \"Substream\": true, \"Enabled\": true, \"ParkingFPS\": 1, \"Record\": 1, \"MainQuality\": 2, \"MainFPS\": 24, \"Audio\": 1}, {\"index\": 2, \"ParkingQuality\": 1, \"Substream\": false, \"Enabled\": false, \"ParkingFPS\": 1, \"Record\": 0, \"MainQuality\": 2, \"MainFPS\": 24, \"Audio\": 0}], \"Debug\": {\"LcdDisplayMode\": 0, \"UseLegacyLive\": false}, \"Overlay\": {\"ShowSpeed\": true}, \"General\": {\"TimeZone\": \"US/Eastern\", \"IgnitionShutdownDelay\": 60}, \"Event\": {\"Adas\": {\"Enabled\": false, \"CameraHeight\": 150, \"CameraOffset\": 0, \"VehicleHoodLength\": 152, \"VehicleWidth\": 170, \"LaneDeparture\": {\"SendToCloud\": false, \"Enabled\": false}, \"ForwardCollision\": {\"Sensitivity\": 0, \"SendToCloud\": false, \"Enabled\": false}, \"Headway\": {\"Sensitivity\": 0, \"SendToCloud\": false, \"Enabled\": false, \"SpeedUnit\": \"mph\", \"SpeedThreshold\": 32, \"Ttc\": {\"TriggerThreshold\": 0.6}}, \"FollowingDistance\": {\"Sensitivity\": 0, \"SendToCloud\": false, \"Enabled\": false, \"SpeedUnit\": \"mph\", \"SpeedThreshold\": 32, \"Ttc\": {\"TriggerThreshold\": 0.6}}}, \"Accelerometer\": {\"Enable\": {\"Y\": true, \"X\": true, \"Z\": false}, \"TriggerOutput\": -1, \"FatalThreshold\": {\"Y\": 1.2, \"X\": 1.2, \"Z\": 2}, \"Enabled\": true, \"ParkingThreshold\": {\"Y\": 0.2, \"X\": 0.2, \"Z\": 1.2}, \"SendToCloud\": false, \"FatalSendToCloud\": true, \"Threshold\": {\"Y\": 10, \"X\": 10, \"Z\": 10}, \"FatalTriggerOutput\": -1}, \"HarshAccel\": {\"Threshold\": 9.5, \"SendToCloud\": true, \"Enabled\": true}, \"HarshBraking\": {\"Threshold\": 11, \"SendToCloud\": true, \"Enabled\": true}, \"HighSpeed\": {\"Threshold\": 112.65, \"SendToCloud\": false, \"Enabled\": false, \"TriggerOutput\": -1}, \"Voltage\": {\"HighThreshold\": 32, \"ShutdownDelay\": 20, \"LowThreshold\": 11.5, \"Enabled\": true, \"RecoveryThreshold\": 12}, \"Sensor\": [{\"index\": 0, \"SendToCloud\": false, \"Name\": \"Sensor #1\", \"TriggerOutput\": -1, \"ActiveHigh\": true, \"Enabled\": false, \"ShortName\": \"S1\"}, {\"index\": 1, \"SendToCloud\": false, \"Name\": \"Sensor #2\", \"TriggerOutput\": -1, \"ActiveHigh\": true, \"Enabled\": false, \"ShortName\": \"S2\"}, {\"index\": 2, \"SendToCloud\": false, \"Name\": \"Sensor #3\", \"TriggerOutput\": -1, \"ActiveHigh\": true, \"Enabled\": false, \"ShortName\": \"S3\"}, {\"index\": 3, \"SendToCloud\": false, \"Name\": \"Sensor #4\", \"TriggerOutput\": -1, \"ActiveHigh\": true, \"Enabled\": false, \"ShortName\": \"S4\"}, {\"index\": 4, \"SendToCloud\": true, \"Name\": \"External Driver Event\", \"TriggerOutput\": -1, \"Enabled\": true, \"ShortName\": \"EE\"}, {\"index\": 8, \"SendToCloud\": true, \"TriggerOutput\": -1}], \"HighTemperature\": {\"Threshold\": 99, \"ShutdownDelay\": 150, \"Enabled\": true}, \"Dms\": {\"CameraObstruction\": {\"Enabled\": false}, \"Seatbelt\": {\"Enabled\": false, \"Sensitivity\": 0}, \"Distraction\": {\"Enabled\": true, \"SendToCloud\": true, \"Sensitivity\": 0}, \"PhoneUse\": {\"Enabled\": true, \"SendToCloud\": true, \"Sensitivity\": 0}, \"Enabled\": true, \"Yawning\": {\"SendToCloud\": true, \"Enabled\": true, \"Sensitivity\": 0}, \"Dozing\": {\"SendToCloud\": true, \"Enabled\": true, \"Sensitivity\": 0}, \"Sensitivity\": 1, \"HeadDown\": {\"SendToCloud\": true, \"Enabled\": true, \"Sensitivity\": 0}, \"Smoking\": {\"Enabled\": false, \"Sensitivity\": 0}}, \"BuzzerEnabled\": false}, \"Servers\": {\"Ads\": {\"ShutdownDelay\": 480}, \"SleepMode\": {\"Enabled\": false}}, \"System\": {\"SpeedUnit\": 1, \"Chimes\": {\"CameraObstruction\": {\"Enabled\": 0}, \"Dms\": false, \"Volume\": 100, \"Adas\": false, \"Accelerometer\": false, \"HarshBraking\": false, \"HarshAccel\": false, \"HighSpeed\": false, \"Distraction\": true, \"Yawning\": true, \"Drowsiness\": true, \"PhoneUse\": true, \"ForwardCollision\": true, \"Headway\": true, \"FollowingDistance\": true, \"LaneDeparture\": true, \"Smoking\": false, \"Seatbelt\": false}}, \"Recording\": {\"LockEventFiles\": false}, \"Peripherals\": {\"CanBus\": {\"Type\": 0}}}",
      "created_at": "Mon, 25 Nov 2024 01:38:50 GMT",
      "id": 14633,
      "last_changed_ts": "Mon, 25 Nov 2024 01:38:50 GMT",
      "name": "New Profile Name",
      "preferred": false
    }
  },
  "result": "OK"
}

🟠401Login Required

Modified at 2024-11-26 17:37:19

Get events for a device

Get a company profile