Samsara API

Overview
Assets
- List stats for a given reeferget
- List historical locations for a given assetget
Issues
Fleet
- /fleet/locationsget

Core

Addresses
Alerts
Attributes
Contacts
Gateways
Live Sharing Links
Organization Info
- Get information about your organizationget
Settings
Tags
Trips
- Get Trips Streamget
- Get vehicle tripsget
Users
Webhooks

Assets: Vehicles, Trailers, Equipment

Assets
Equipment
Location and Speed
- List asset location and speed data in an organization.get
Readings
Sensors
Trailer Assignments
Trailers
Vehicle Locations
Vehicle Stats
Vehicles

Drivers

Auth Token for Driver
- Create auth token for a driverpost
Driver QR Codes
Driver-Vehicle Assignments
Drivers
Messages
- Get all messages.get
- Send a message to a list of driver ids.post

Compliance

Hours of Service
Tachograph (EU Only)

Fuel and efficiency

Fuel and Energy
IFTA
Idling
- Get idling events.get
- [legacy] Get vehicle idling reports.get

Workflows

Carrier Proposed Assignments
Documents
Forms
Issues

ROUTING

Hubs
Plans
Route Events
- Get route events streamget
Routes

Maintenance

Maintenance
Work Orders

Safety

Coaching
Media
Safety
Safety Scores
Speeding Intervals
- Get Speeding Intervalsget
Training Assignments
Training Courses
- Get a list of filtered training courses.get

Future

Beta APIs
Preview APIs

Legacy

Industrial
Legacy APIs

[beta] Update an upcoming preventive maintenance instance

patch

https://api.samsara.com/maintenance/preventive/upcoming

Patches the due-target and last-resolved values on the open preventive maintenance instance for a schedule and asset. Only fields provided in the request are updated.

Rate limit: 5 requests/sec (learn more about rate limits here).

To use this endpoint, select Write Upcoming Preventive Maintenance under the Preventive Maintenance category when creating or editing an API token. Learn More.

Submit Feedback: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

assetId

string

Samsara ID for the asset.

scheduleId

string

ID of the preventive maintenance schedule that the vehicle is scheduled to be serviced for.

Body Params

Request body for updating a UpcomingPreventativeMaintenance

lastResolvedAt

string

Date and time when the prior instance was resolved.

lastResolvedAtEngineHours

int64

Engine hours at the time the prior instance was resolved.

lastResolvedAtOdometer

int64

Odometer reading at the time the prior instance was resolved. Measured in meters.

nextEngineHours

int64

The next engine hour value that the vehicle is scheduled to be serviced.

nextOdometer

int64

The next odometer value that the vehicle is scheduled to be serviced. Measured in meters.

nextTime

string

The next time that the vehicle is scheduled to be serviced for a date based PM.

Responses

Updated 20 days ago

[beta] Update a purchase order

[preview] Create a warranty

Did this page help you?

Language

Credentials

Bearer

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

Updated 20 days ago

[beta] Update a purchase order

[preview] Create a warranty

Did this page help you?

200OK response.

401Unauthorized response.

404Not Found response.

405Method Not Allowed response.

413Content Too Large response.

429Too Many Requests response.

500Internal Server Error response.

501Not Implemented response.

502Bad Gateway response.

503Service Unavailable response.

504Gateway Timeout response.

defaultBad Request response.