Requested Media Submitted

The REQUESTED_MEDIA_SUBMITTED event is triggered when a user submits a request to retrieve a video clip from a camera. This event confirms that the system has received the request successfully and has started processing it. At this stage, no video chunks or media links are available yet the system has only logged the request.

**Event Name:**REQUESTED_MEDIA_SUBMITTED

**Enablement Package:**NA


Trigger Condition

  • REQUESTED_MEDIA_SUBMITTED webhook event should be subscribed.
  • The webhook is triggered when a user requests a video from a Surfsight (vendor 15) camera, except when the request is made by a Fleet-Pro Integration User.
  • The event is triggered when the request status is 1, indicates submitted.

Example Payload

{
  "messageType": "REQUESTED_MEDIA_SUBMITTED",
  "generatedAt": 1732639083923,
  "data": {
    "requestedMediaId": "573d40d4-ac14-11ef-b0b8-230c90d6e1c2",
    "requestedMediaName": "25Nov2024_0101303489_Request:2",
    "safetyCamDeviceId": "1457c06c-0533-11ee-b8c4-ad3118588c1b",
    "safetyCamSerialNum": "357660102175957",
    "startTime": "2024-11-24 18:30:00",
    "endTime": "2024-11-24 18:30:30",
    "requestorId": "03840664-4a03-11e6-98cb-7b86271dc116",
    "requestorName": "Alan Niesel",
    "vehicleId": "ddb312c8-3063-11ee-924d-9f6b04f645e8",
    "vehicleName": "0101303489",
    "groupId": "c337220c-8672-11e2-9b71-55cae3166848",
    "groupName": "Default Group",
    "driverId": "8a94907b-918c-6f64-0191-927652f42c68",
    "driverName": "Event Driver",
    "customerId": 1059,
    "vendorId": 15,
    "recordStatus": 1,
    "chunksAvailable": [],
    "status": 1,
    "mediaLinks": []
  }
}

Reference

FieldDescription
messageType*
string
Type of Message(dentifies the type of event being sent).
Example: REQUESTED_MEDIA_SUBMITTED
generatedAt*
number (epoch ms)
The exact time the webhook was created, in epoch milliseconds (UTC).
Example: 1732639083923
data*
object
Contains all the details related to the media request.
requestedMediaId*
string
A unique identifier for the specific video request.
Example: 573d40d4-ac14-11ef-b0b8-230c90d6e1c2
requestedMediaName*
string
A readable name for the requested video. Usually includes date/time.
Example: 25Nov2024_0101303489_Request:2
safetyCamDeviceId*
string
Internal Azuga ID for the camera device.
Example: 1457c06c-0533-11ee-b8c4-ad3118588c1b
safetyCamSerialNum*
String
The serial number printed on the camera device.
Example: "357660102175957"
startTime*
string (UTC)
Start timestamp of the requested footage (UTC – format: YYYY-MM-DD HH:MM:SS).
Example: 2024-11-24 18:30:00
endTime*
string (UTC)
End timestamp of the requested footage (UTC – format: YYYY-MM-DD HH:MM:SS).
Example: 2025-01-01 18:30:30
requestorId*
String
Unique ID of the user who requested the video.
Example: "03840664-4a03-11e6-98cb-7b86271dc116"
requestorName*
String
Name of the person who initiated the request.
Example: "Alan Niesel"
vehicleId*
string
The Azuga ID of the vehicle from which the footage was requested.
Example: ddb312c8-3063-11ee-924d-9f6b04f645e8
vehicleName*
string
Display name / fleet number of the vehicle.
Example: 0101303489
groupId*
string
ID of the group the vehicle belongs to.
Example: 8a94907b-918c-6f64-0191-927652f42c68
groupName*
string
Name of the group the vehicle belongs to.
Example: Default Group
driverId*
string
ID of the driver linked to the vehicle at the time of the event.
Example: 8a94907b-918c-6f64-0191-927652f42c68
driverName*
String
Driver name associated at the time of event.
Example: "Event Driver"
customerId*
number
Unique ID of the customer account.
Example: "1059"
vendorId*
number
Camera vendor ID (15 = Surfsight camera).
recordStatus*
number
Indicates record availability status.
Example: 1
chunksAvailable*
array
List of all available video segments (chunks) from each camera stream.
mediaLinks*
array
Download links for the video files and thumbnails.
status*
number
Type of media.
Example: 1 (1 = Submitted)

Did this page help you?