request videos of an alert

PUT

/api/{{API_VERSION}}/partners/events/custom_alert_clips

Partner requests video and snapshot of an alert from target device ID, starting from timestamp. Timestamp format is YYYYmmddHHMMSS, eg: 20180808130200. If the device is online, the request will be stored, snapshots and video clips will be uploaded to the cloud storage automatically. A request id will be returned in the response. If the device is offline, the request will be pending until the device is online.

Request

Body Params multipart/form-data

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request PUT 'https://fleet.roscolive.com/api/v1.0/api/{{API_VERSION}}/partners/events/custom_alert_clips' \
--form 'alert_type="{{ALERT_TYPE from ['\''CameraBlock'\'', '\''VideoLoss'\'', '\''PanicButton'\'', '\''InputSensor'\'', '\''Voltage'\'', '\''GSensor'\'', '\''GpsError'\'', '\''HighSpeed'\'','\''HddError'\'', '\''HighTemperature'\'', '\''MotionDetect'\'', '\''TireEvent'\'', '\''FatalGSensor'\'','\''UncleanShutdown'\'']}}"' \
--form 'device_id="{{DEVICE_ID}}"' \
--form 'timestamp="{{TIMESTAMP}}"'

Responses

🟢200Success

application/json

Body

Example

{}

🟠401Login Required

Modified at 2025-08-21 14:30:38

delete an event

share an event