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.

Role	Permission
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 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 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_name": "ullamco anim nostrud eiusmod",
            "vin_number": "eiusmod eu",
            "windshield_img": 1
        }
    },
    "result": "OK"
}

Modified at 2026-06-23 16:46:13

Search devices

Get a device

Update a device settings

User Role Permissions#

Request

Responses

User Role Permissions