Purpose: Use this endpoint for an on-demand image capture from vehicles and assets via Dashcams, and Omnicams respectively. You are required to specify the positions of the camera, since this endpoint captures the image from a single source (position of the camera).

Camera Positions

📘

NOTE

To use these endpoints, you must enable the company's "video_monitoring" feature.

Take the following steps:

1. Log in to the Motive Dashboard.
2. Navigate to Admin > Safety.
3. Scroll down to Cameras.
4. Turn on the Capture Trip Images feature.
5. Click Save.

Response Parameters

request_id

• type: Integer
• Description: Unique identifier of the image capture request. Use this value with the GET image capture endpoint to fetch the request status and result.

camera_type

• type: String
• Description: Type of camera for which the image capture was requested. omnicam indicates the request was created for an Omnicam device.

position

• type: String
• Description: Camera position requested for capture. side_left refers to the left-side Omnicam position.

status

• type: String
• Description: Current state of the image capture request. pending means the request has been accepted and is still being processed.

asset

• type: Object
• Description: Asset details associated with the image capture request. This object is present when the request is created for an asset.

asset.id

• type: Integer
• Description: Unique identifier of the asset associated with the image capture request.

asset.name

• type: String
• Description: Human-readable name of the asset associated with the image capture request.

created_at

• type: String (ISO 8601 datetime)
• Description: Timestamp indicating when the image capture request was created.