Developers | Samsara

Synthetic engine hours are now available from the Vehicles Stats API endpoints. You can include the query parameter types=syntheticEngineSeconds to get synthetic engine runtime if engine runtime from the ECU is unavailable. This value is approximated by the time the vehicle gateway receives power from the vehicle. See this article for details on synthetic engine runtime. See the Telematics API guide for how to use the types=syntheticEngineSeconds query parameter and details on the telematics API endpoints.

We've released a new beta API endpoint that returns all vehicles' driver assignments for a given time period. You can view the reference documentation here. Note: This API is in beta and is likely to change before it enters a broader release. This beta release gives you the opportunity to experiment and provide feedback – before the final release. The final release will be announced via another changelog entry.

The external IDs of each dashcam's vehicle have been added to the payload of the GET /fleet/vehicles/cameras/media/history beta API endpoint. Note: This API is in beta and is likely to change before it enters a broader release. This beta release gives you the opportunity to experiment and provide feedback – before the final release. The final release will be announced via another changelog entry.

We've released a beta version of a new endpoint to create routes. This new version conforms to our latest API standards. You can preview the reference docs here. Note: This API is in beta and is likely to change before it enters a broader release. This beta release gives you the opportunity to experiment and provide feedback – before the final release. The final release will be announced via another changelog entry.

We've released a new beta API endpoint that allows you to retrieve camera media for a given time period. You can view the reference docs here. Note: This APIs is in beta and is likely to change before it enters a broader release. This beta release gives you the opportunity to experiment and provide feedback – before the final release. The final release will be announced via another changelog entry.

We've released a beta version of a new set of endpoints that allow you to create and manage custom attributes for drivers and vehicles. See the new Custom Attributes guide for more details.

A new stat type is available for the types query param in the /fleet/equipment/stats endpoints: types=gatewayJ1939EngineSeconds. This an approximation of engine runtime for equipment with J1939/CAT cables. It is based on the cumulative time that the Samsara AG device has received power from the engine. This stat is only available for equipment that does not automatically report engine runtime from on-board diagnostics. In order to activate this stat, you must set a manual engine runtime offset for the piece of equipment in the Samsara Dashboard.

Addresses now support riskZone as an additional option for addressTypes[].

A /me API endpoint is now available that returns information about the organization that the API access token belongs to. This includes the organization's id, name, and carrierSettings if the organization is a fleet.

Documents now support conditional fields that enable follow-up questions for a given multiple-choice answer.