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 Role	Allowed
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

event_label

string

required

Label text to add to event. Pass an empty value to remove event label

<= 20 characters

Example:

lorem ipsum dolores

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://fleet.roscolive.com/api/v1.0/event/1234567/label' \
--form 'event_label="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

Example

{
  "meta": {
    "code": 200
  },
  "response": "success",
  "result": "OK"
}

🟠401Login Required

🟠404Record Not Found

🟠404Resource Not Found

🔴500Internal Server Error

Modified at 2025-02-18 15:10:38

Request custom video from device

Add user feedback to event

Add event label

User Role Permissions#

Request

Request samples

Responses

User Role Permissions