RoscoLive API v1.0
  1. Event
RoscoLive API v1.0
  • Device
    • Get a device
      GET
  • Driver Scoring / Coaching
    • Get drivers coaching events
      GET
  • Event
    • Get company events
      GET
    • Get flagged company events
      GET
    • Request custom video from device
      PUT
    • Add event label
      POST
    • Add user feedback to event
      POST
    • Get event user feedback
      GET
    • Get event filters list for date range in company
      GET
  1. Event

Add user feedback to event

POST
/events/{event_id}/feedback
eventfeedback
Add user feedback to event. The passed in feedback will then be stored on the event and retrievable for further review and data exploration.
The enum mapping for selections param are the following:
Enum valueDescription
1Event reported did not happen in video / was a false positive
2Video did not playback properly / quality issues with video
3Camera was positioned improperly / event happened outside of camera's view
4The event type captured in the video has little / no value to me and/or is unhelpful
5Camera / equipment issue caused the event to not be captured properly enough to be valuable.
6Other

User Role Permissions#

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

Request

Path Params
event_id
integer 
required
ID of event to add label value
Example:
1234567
Body Params multipart/form-data
has_feedback
boolean 
required
Flag to set if submitting feedback for event
Example:
true
selections
string 
required
A string of comma-separated enum values for preset feedback selections. One or more can be passed in if relevant, but at least one is required.
Example:
"1,6"
comment
string 
optional
User comment field for additional feedback
<= 255 characters
Example:
{{$lorem.sentences}}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://fleet.roscolive.com/api/v1.0/events/1234567/feedback' \
--form 'has_feedback="true"' \
--form 'selections="\"1,6\""' \
--form 'comment="{{$lorem.sentences}}"'

Responses

🟢200Success
application/json
Body
meta
object 
required
Request metadata object
code
integer 
required
HTTP status code returned by response
>= 100<= 599
response
string 
required
Contains response data
result
enum<string> 
required
"OK" if successful, else "Fail" if error
Allowed values:
OKFailed
Example
{
  "meta": {
    "code": 200
  },
  "response": "success",
  "result": "OK"
}
🔴500Internal Server Error
🟠404Resource Not Found
🟠401Login Required
Modified at 2025-02-18 15:10:38
Previous
Add event label
Next
Get event user feedback
Built with