1. Device
RoscoLive API v1.0(v2.42.0)
  • Authentication
    • Login
      POST
    • Logout
      GET
  • Report
    • Request IFTA report of a company
      POST
    • Get IFTA report of a company
      GET
    • Get IFTA report in CSV-file by company
      GET
    • Update a report's subscription options
      POST
    • Put subscribe to a report
      PUT
    • Get report subscriptions
      GET
  • Company
    • Add custom user profile
      PUT
    • Get custom user profiles
      GET
  • User
    • Get User Info from Email Address
      GET
    • Update notification by email
      POST
  • Device
    • Get stop routes of devices
      GET
    • Update a device settings
      POST
    • Get a device
      GET
    • Get list of company devices
      GET
    • Get devices for all companies available for user
      GET
    • Get device list for multiple companies
      GET
  • Driver Scoring / Coaching
    • Upload a driver from csv file
      PUT
  • Event
    • Get list of company events
      GET
  • Metadata
    • Get missing GPS intervals of devices
      GET
  1. Device

Update a device settings

POST
/partners/devices/{device_id}
Updates a device. All the attributes are optional, only the posted attributes will be changed.

User Role Permissions#

The following table shows which user roles are allowed to send requests using this API endpoint.
RolePermission
Partner
Partner View
Custom Partner
Fleet Manager
Group Manager
User
Custom User

Request

Path Params

Body Params multipart/form-data

Responses

🟢200OK
application/json
Bodyapplication/json

🟠400Update non existing device
🟠400Update a device with an existing name
🟠401Login Required
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/partners/devices/' \
--form 'vehicle_icon="Arrow 1"' \
--form 'vehicle_name="Truck 1"' \
--form 'user_email="john.doe@example.com,jane.doe@example.com"' \
--form 'driver_name="jim.doe@example.com"' \
--form 'matching_token="my-unique-matching-token-01"' \
--form 'silence_err_notifs="SD20"' \
--form 'adas_camera_height=""' \
--form 'adas_camera_offset=""' \
--form 'adas_vehicle_hood_len=""' \
--form 'adas_vehicle_width=""' \
--form 'adas_units=""' \
--form 'canbus=""' \
--form 'can_log_upload=""' \
--form 'ignition_switch_only=""' \
--form 'active=""' \
--form 'vehicle_icon_size=""'
Response Response Example
200 - Success
{
    "meta": {
        "code": 200
    },
    "response": {
        "device": {
            "cardreader": true,
            "canbus": "0",
            "device_type": "dv6",
            "is_flagged": true,
            "activated_timestamp": "2024-01-01 12:31:42",
            "active": false,
            "ads_online": false,
            "antenna_img": 1,
            "channel_available": null,
            "company_id": 12345,
            "company_name": "Reilly, Cartwright and Walker",
            "created_at": "2024-01-01 12:31:42",
            "config_checksum": 31529194,
            "data_limit": 1,
            "disable_live_stream": true,
            "dms_enabled": false,
            "deleted_at": "2024-01-01 12:31:42",
            "device_id": "12345",
            "driver_id": "67376042394",
            "driver_name": "Garry Rowe",
            "driver_last_update": "2024-01-01 12:31:42",
            "driver_recognition": null,
            "flood_blocked": -96201719,
            "general_status": null,
            "groups": [
                "fugiat minim enim voluptate tempor",
                "in",
                "est"
            ],
            "incorrect_device_time": false,
            "installed_by_user_id": null,
            "is_installation": false,
            "is_installation_report": true,
            "last_disconnected_ts": "2024-01-01 12:31:42",
            "last_sleep_connected_ts": "2024-01-01 12:31:42",
            "last_sleep_disconnected_ts": "2024-01-01 12:31:42",
            "live_online": false,
            "matching_token": "ad culpa minim voluptate nostrud",
            "modem_img": 1,
            "modem": {
                "current_firmware": null,
                "firmware_status": "firmware out of date",
                "firmware_updated_ts": null,
                "imei": 61899221,
                "manufacturer": null,
                "model": null,
                "pending_firmware": null,
                "simcard_iccid": "Passenger Van=Passen",
                "version": null
            },
            "online_gps": false,
            "parking_duration": 480,
            "partner_device": null,
            "partner_name": "Mueller, Runte and Koelpin",
            "pending_config": {
                "adas_camera_height": "150",
                "adas_camera_offset": "0",
                "adas_vehicle_hood_len": "150",
                "adas_vehicle_width": "170",
                "canbus": "0",
                "cardreader": false,
                "parking_duration": "et cupidatat proident",
                "timezone": "2024-01-01 12:31:42"
            },
            "power_img": 90392659,
            "recording_status": "OK",
            "silence_err_notifs": null,
            "status": "used",
            "serial_number": null,
            "sleep_mode_enabled": false,
            "tag_plate": null,
            "timezone": "America/Sitka",
            "uploaded_company_profile": null,
            "users": [
                25229953,
                -24168739
            ],
            "vehicle_icon": null,
            "vehicle_icon_size": false,
            "vehicle_name": "ullamco anim nostrud eiusmod",
            "vin_number": "eiusmod eu",
            "windshield_img": 1
        }
    },
    "result": "OK"
}
Modified at 2026-06-23 16:46:13
Previous
Get stop routes of devices
Next
Get a device
Built with