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 event label

POST
/event/{event_id}/label
event
Adds a label to the event_label value for an event. If viewing the event within RoscoLive, this value will be displayed instead of the event_display_type value. This is useful for event sub-categorization or flagging the end user finds valuable.

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 Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://fleet.roscolive.com/api/v1.0/event/1234567/label' \
--form 'event_label="lorem ipsum dolores"'
Response Response Example
200 - Success
{
    "meta": {
        "code": 200
    },
    "response": "success",
    "result": "OK"
}

Request

Path Params
event_id
integer 
required
ID of event to add label value
Example:
1234567
Body Params multipart/form-data
event_label
string 
required
Label text to add to event. Pass an empty value to remove event label
<= 20 characters
Example:
lorem ipsum dolores

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
🟠401Login Required
🟠404Record Not Found
🟠404Resource Not Found
🔴500Internal Server Error
Modified at 2025-06-15 10:46:58
Previous
Request custom video from device
Next
Add user feedback to event
Built with