Purpose: The Camera Control Job endpoints allow the Fleet Managers/Fleet Admins to programmatically and remotely turn ON or turn OFF an installed Dashcam of a vehicle.
Since Motive Dashcams record both driver-facing and road-facing views, these controls allow companies to respect the privacy of their drivers during the non-working hours, as well as to follow operational policies, and event-specific needs.

Use this endpoint to poll for the status of the Camera Control job. This endpoint will let you know if the job was a success or not.

📘

Things to remember

• The polling endpoint can be called once every 10 seconds. In a minute the maximum number of retries that you can have is 6.
• You may start polling after ~ 5 seconds after invoking the PUT request.
• Avoid back-to-back control jobs and polling jobs for the same vehicle.

Rate Limits

• This endpoint has a limit of 1 for every 10 seconds.

📘

NOTE

Polling more frequently may result in throttling or inaccurate Unknown responses.

• Polling Limit of up to 6 times during the polling window of 1 minute.

Response Parameters

req_id

• Type: String
• Description: Denotes the ID of the request that you are querying for.

req_status

• Type: String
• Description: Denotes the status of the request. Possible values are:
  • Succeeded: Denotes that the camera control request was a success. If you switched ON the camera, then it was successful.
  • Failed: Denotes that the camera control request of either switching the camera ON or OFF was not successful.
  • Pending: Denotes that the request is still under process. You may continue to poll till you see a different message.
  • Unknown: Denotes that the response is not known. You can restart the entire flow with a new PUT request that will generate a new ID.