v1

latestOpenAPI 3.1.02026-07-2617501.1 MB

Create a video recall request

post/v1/video_recall_requests

Request body

start_timestring date required

Specify the start time from when you want the recall request to begin. Format: ISO 8601

durationinteger required

Specify the duration of the video.

vehicle_numberstring

Specify the number of the vehicle for which you are creating this request.

asset_namestring

Specify the name of the asset for which you are creating this request.

recall_typestring

Specify the type of recall. Allowed values are <ul><li>regular</li><li>timelapse</li></ul>

camera_positionsstring[]

Specify the position of the camera for this particular video recall request. Below are the supported camera positions: <ul> <li>front_facing</li> <li>driver_facing</li> <li>front_narrow_facing</li> <li>side_left</li> <li>side_right</li> <li>rear</li> </ul>

Response

200

idinteger

statusstring

primary_entitystring

{"stackTrail":"paths:/v1/video_recall_requests:post:responses:200:content:application/json:schema:properties:asset","oasType":"schema","type":"unknown"}

start_timestring

end_timestring

recall_typestring

created_atstring

updated_atstring

camerasobject[]

Example response

{
  "id": 125776,
  "status": "pending",
  "primary_entity": "vehicle",
  "vehicle": {
    "id": 161783,
    "number": "AABV52DE450005-2"
  },
  "start_time": "2025-11-26T14:03:21Z",
  "end_time": "2025-11-26T14:04:21Z",
  "recall_type": "regular",
  "created_at": "2025-11-27T15:58:06Z",
  "updated_at": "2025-11-27T15:58:06Z"
}