1. Device
RoscoLive API v1.0(v2.40.0)
  • Report
    • Get custom report data
      GET
    • Get all events report for company
      GET
    • Get event count summary report for company devices
      GET
    • Update custom report
      POST
    • Create custom report for user
      PUT
  • Company
    • private
      • Create a new partner company
      • Update partner company info
      • Get a partner company
      • Disable a customer company
      • Enable a customer company
      • Disable a partner company
      • Enable a partner company
    • Create a company
      PUT
    • Get audit logs of a company
      GET
    • Get a company by ID
      GET
    • Update company
      POST
    • Get companies list
      GET
    • Get a company
      GET
    • Get companies
      GET
    • Get own partner company
      GET
  • User
    • Get Company Users
      GET
    • Get User Info from Email Address
      GET
    • Update a User's Info
      POST
    • Get my Own User Info
      GET
    • Create a User
      PUT
    • Update notification by email
      POST
  • Device
    • Update a device settings
      POST
    • Get company devices with modems
      GET
    • Get a device
      GET
    • Create devices (auto-prov/DV4/DV6/DV7)
      PUT
  • Driver Scoring / Coaching
    • Get company drivers list
      GET
    • Get driver scores
      GET
    • Add new driver to company
      PUT
    • Get company event score weights
      GET
    • Update company event score weights
      POST
  • Event
    • Get an Event of a Device by Start Time
    • Get an Event by ID and Storage Type
    • Get Company Events
    • Get Event by Company and ID
    • Get Flagged Company Events
    • Get Device Events for Period
    • Get list of company events
  • Metadata
    • Get alerts and events of devices for company
    • Get alerts of a driver
  • Fleet Configuration
    • Get profiles of a company
    • Get company default profile settings
    • Remove a company profile
    • Create new profile in a company
    • Get a company profile
    • Get profile history
    • Update a company profile
  • DocuWiki Support
    • Rosco customer registration
  • Installer App
    • Add install report
    • Installer registration
    • Install Rosco device
  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 'https://fleet.roscolive.com/api/v1.0/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=""'
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"
            ],
            "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_name": "ullamco anim nostrud eiusmod",
            "vin_number": "eiusmod eu",
            "windshield_img": 1
        }
    },
    "result": "OK"
}
Modified at 2026-06-23 16:46:13
Previous
Update notification by email
Next
Get company devices with modems
Built with