How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Samsara Settings API

The Settings API from Samsara — 3 operation(s) for settings.

Samsara Settings API is one of 90 APIs that Samsara publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Settings. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and a GitHub repository.

This API exposes 5 operations across 3 paths, and defines 83 schemas. It is described by OpenAPI 3.0.1, at version 2024-11-18.

Requests are made against 2 base URLs: https://api.samsara.com/, https://api.eu.samsara.com/.

5 operations 3 paths 83 schemas 3 GET2 PATCH

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
2024-11-18
Base URL
https://api.samsara.com
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Samsara Settings API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (AccessTokenHeader). By default, every request must be authenticated.

Paths & Operations 5

Across 3 paths, the API surfaces 5 operations — 3 GET, 2 PATCH. Each is listed below with its method, path, parameters, and response codes.

Settings 5
GET
/fleet/settings/compliance
Get Compliance Settings
getComplianceSettings → 200401404405429500501502
PATCH
/fleet/settings/compliance
Update Compliance Settings
patchComplianceSettings body → 200401404405429500501502
GET
/fleet/settings/driver-app
Get Driver App Settings
getDriverAppSettings → 200401404405429500501502
PATCH
/fleet/settings/driver-app
Update Driver App Settings
patchDriverAppSettings body → 200401404405429500501502
GET
/fleet/settings/safety
Get Safety Settings
getSafetySettings → 200401404405429500501502

Schemas 83

The contract defines 83 schemas that model the data the API accepts and returns. The most detailed are SafetyScoreConfigurationSettingsObjectResponseBody (29 properties), SafetySettingsObjectResponseBody (12 properties), SettingsComplianceResponseObjectResponseBody (10 properties), SettingsPatchComplianceSettingsRequestBody (10 properties). Each schema is shown below with its type and property counts.

HarshAccelSensitivityGForceSettingsObjectResponseBody
object
The harsh acceleration sensitivity settings.
3 properties
SafetySettingsGetSafetySettingsBadRequestErrorResponseBody
object
Bad Request parameters
2 properties 2 required
DriverAppSettingsGamificationConfigTinyObjectResponseBody
object
Gamification configuration for the Driver App.
1 property
HarshBrakeSensitivityV2SettingsObjectResponseBody
object
The harsh brake sensitivity settings.
3 properties
SettingsGetDriverAppSettingsBadGatewayErrorResponseBody
object
Bad Gateway
2 properties 2 required
SettingsPatchComplianceSettingsRequestBody
object
Information set here will be displayed in roadside inspections and in the transferred US DOT datafile. Can be set or updated through the Samsara Settings page…
10 properties
SettingsPatchDriverAppSettingsNotImplementedErrorResponseBody
object
Requested endpoint is not yet implemented
2 properties 2 required
SettingsGetDriverAppSettingsMethodNotAllowedErrorResponseBody
object
Method not allowed
2 properties 2 required
SettingsGetComplianceSettingsGatewayTimeoutErrorResponseBody
object
Gateway timeout
2 properties 2 required
SettingsPatchComplianceSettingsNotImplementedErrorResponseBody
object
Requested endpoint is not yet implemented
2 properties 2 required
DriverAppSettingsTrailerSelectionConfigTinyObjectResponseBody
object
Trailer selection setting configuration for the Driver App.
3 properties
SettingsGetComplianceSettingsTooManyRequestsErrorResponseBody
object
Too many requests
2 properties 2 required
InattentiveDrivingDetectionAlertSettingsObjectResponseBody
object
Enables AI detection of inattentive driving events.
4 properties
SettingsGetComplianceSettingsServiceUnavailableErrorResponseBody
object
Service unavailable
2 properties 2 required
SettingsGetDriverAppSettingsNotFoundErrorResponseBody
object
Resource not found
2 properties 2 required
speedingSeverityLevelResponseBody
object
The settings for a specific speeding severity level.
4 properties 4 required
SettingsGetComplianceSettingsUnauthorizedErrorResponseBody
object
Unauthorized
2 properties 2 required
DriverAppSettingsTrailerSelectionConfigTinyObjectRequestBody
object
Trailer selection setting configuration for the Driver App.
3 properties
SafetySettingsGetSafetySettingsNotImplementedErrorResponseBody
object
Requested endpoint is not yet implemented
2 properties 2 required
SafetySettingsGetSafetySettingsResponseBody
object
1 property 1 required
SettingsGetDriverAppSettingsServiceUnavailableErrorResponseBody
object
Service unavailable
2 properties 2 required
SettingsGetDriverAppSettingsGatewayTimeoutErrorResponseBody
object
Gateway timeout
2 properties 2 required
HarshEventSensitivitySettingsObjectResponseBody
object
The configurable sensitivity for Harsh Event Detection on CM11/CM12/CM22 devices. Sensitivity can be measured as a numeric g-force value or the following value…
3 properties
SettingsPatchComplianceSettingsResponseBody
object
1 property 1 required
SafetySettingsGetSafetySettingsGatewayTimeoutErrorResponseBody
object
Gateway timeout
2 properties 2 required
SettingsGetComplianceSettingsInternalServerErrorResponseBody
object
An internal server error occurred
2 properties 2 required
SettingsPatchDriverAppSettingsTooManyRequestsErrorResponseBody
object
Too many requests
2 properties 2 required
VoiceCoachingSettingsObjectResponseBody
object
Enabling voice coaching will play messages for harsh events, speeding, and unbuckled seat belts.
4 properties
SettingsPatchDriverAppSettingsRequestBody
object
The configuration settings for the Samsara Driver App. Can be set or updated through the Samsara Settings page or the API at any time.
6 properties
SettingsPatchDriverAppSettingsMethodNotAllowedErrorResponseBody
object
Method not allowed
2 properties 2 required
SettingsPatchDriverAppSettingsNotFoundErrorResponseBody
object
Resource not found
2 properties 2 required
ForwardCollisionDetectionAlertSettingsObjectResponseBody
object
Enables AI detection of near forward collisions, surfaces events in Safety Inbox, and enables configurable alerts. While the feature is in beta, it is only ena…
3 properties
FollowingDistanceDetectionAlertSettingsObjectResponseBody
object
Enables AI detection of tailgating or unsafe following distances, surfaces events in Safety Inbox, and enables configurable alerts. By default, Following Dista…
4 properties
SafetySettingsGetSafetySettingsInternalServerErrorResponseBody
object
An internal server error occurred
2 properties 2 required
SettingsGetDriverAppSettingsBadRequestErrorResponseBody
object
Bad Request parameters
2 properties 2 required
SafetySettingsGetSafetySettingsBadGatewayErrorResponseBody
object
Bad Gateway
2 properties 2 required
SettingsGetDriverAppSettingsTooManyRequestsErrorResponseBody
object
Too many requests
2 properties 2 required
SafetySettingsGetSafetySettingsTooManyRequestsErrorResponseBody
object
Too many requests
2 properties 2 required
SettingsPatchComplianceSettingsTooManyRequestsErrorResponseBody
object
Too many requests
2 properties 2 required
HarshAccelSensitivityV2SettingsObjectResponseBody
object
The harsh acceleration sensitivity settings.
3 properties
SettingsGetDriverAppSettingsUnauthorizedErrorResponseBody
object
Unauthorized
2 properties 2 required
DistractedDrivingDetectionAlertSettingsObjectResponseBody
object
Enables AI detection of distracted driving, surfaces events in Safety Inbox, and enables configurable alerts. By default, Distracted Driving will impact the dr…
3 properties
SettingsPatchComplianceSettingsNotFoundErrorResponseBody
object
Resource not found
2 properties 2 required
DriverAppSettingsResponseObjectResponseBody
object
The configuration settings for the Samsara Driver App. Can be set or updated through the Samsara Settings page or the API at any time.
6 properties
SettingsPatchDriverAppSettingsResponseBody
object
1 property 1 required
SafetySettingsGetSafetySettingsMethodNotAllowedErrorResponseBody
object
Method not allowed
2 properties 2 required
SettingsGetDriverAppSettingsInternalServerErrorResponseBody
object
An internal server error occurred
2 properties 2 required
SettingsPatchDriverAppSettingsBadRequestErrorResponseBody
object
Bad Request parameters
2 properties 2 required
SettingsGetDriverAppSettingsResponseBody
object
1 property 1 required
HarshEventSensitivityV2SettingsObjectResponseBody
object
The configurable sensitivity for Harsh Event Detection. Does not apply to CM11/12/22 devices.
3 properties
RollingStopDetectionAlertSettingsObjectResponseBody
object
AI event detection settings for the rolling stop behavior. Detection is available in vehicles with compatible dash cams.
2 properties
SafetyScoreConfigurationSettingsObjectResponseBody
object
The configurable safety infraction weights.
29 properties
HarshTurnSensitivityGForceSettingsObjectResponseBody
object
The harsh turn sensitivity settings.
3 properties
SettingsPatchComplianceSettingsMethodNotAllowedErrorResponseBody
object
Method not allowed
2 properties 2 required
SettingsGetComplianceSettingsMethodNotAllowedErrorResponseBody
object
Method not allowed
2 properties 2 required
SettingsGetComplianceSettingsBadGatewayErrorResponseBody
object
Bad Gateway
2 properties 2 required
SafetySettingsGetSafetySettingsServiceUnavailableErrorResponseBody
object
Service unavailable
2 properties 2 required
SettingsPatchComplianceSettingsServiceUnavailableErrorResponseBody
object
Service unavailable
2 properties 2 required
SettingsPatchComplianceSettingsUnauthorizedErrorResponseBody
object
Unauthorized
2 properties 2 required
SafetySettingsObjectResponseBody
object
Safety settings for a single organization.
12 properties 12 required
SettingsPatchComplianceSettingsInternalServerErrorResponseBody
object
An internal server error occurred
2 properties 2 required
SafetySettingsGetSafetySettingsUnauthorizedErrorResponseBody
object
Unauthorized
2 properties 2 required
PolicyViolationsDetectionAlertSettingsObjectResponseBody
object
Enables detection of policy violations, surfaces events in Safety Inbox, and enables configurable alerts. While the feature is in beta, in-cab alerts are recom…
5 properties
DriverAppSettingsGamificationConfigTinyObjectRequestBody
object
Gamification configuration for the Driver App.
1 property
SettingsPatchDriverAppSettingsGatewayTimeoutErrorResponseBody
object
Gateway timeout
2 properties 2 required
SettingsPatchComplianceSettingsBadRequestErrorResponseBody
object
Bad Request parameters
2 properties 2 required
HarshTurnSensitivityV2SettingsObjectResponseBody
object
The harsh turn sensitivity settings.
3 properties
SafetySettingsGetSafetySettingsNotFoundErrorResponseBody
object
Resource not found
2 properties 2 required
SettingsPatchComplianceSettingsGatewayTimeoutErrorResponseBody
object
Gateway timeout
2 properties 2 required
HarshBrakeSensitivityGForceSettingsObjectResponseBody
object
The harsh brake sensitivity settings.
3 properties
SettingsPatchComplianceSettingsBadGatewayErrorResponseBody
object
Bad Gateway
2 properties 2 required
SettingsGetComplianceSettingsBadRequestErrorResponseBody
object
Bad Request parameters
2 properties 2 required
SpeedingSettingsObjectResponseBody
object
Enables custom speeding levels.
2 properties
SettingsGetComplianceSettingsResponseBody
object
1 property 1 required
SettingsPatchDriverAppSettingsUnauthorizedErrorResponseBody
object
Unauthorized
2 properties 2 required
SettingsGetComplianceSettingsNotFoundErrorResponseBody
object
Resource not found
2 properties 2 required
SettingsComplianceResponseObjectResponseBody
object
Information set here will be displayed in roadside inspections and in the transferred US DOT datafile.
10 properties
SettingsGetComplianceSettingsNotImplementedErrorResponseBody
object
Requested endpoint is not yet implemented
2 properties 2 required
SettingsGetDriverAppSettingsNotImplementedErrorResponseBody
object
Requested endpoint is not yet implemented
2 properties 2 required
MobileUsageDetectionAlertSettingsObjectResponseBody
object
Enables AI detection of mobile usage events.
3 properties
SettingsPatchDriverAppSettingsServiceUnavailableErrorResponseBody
object
Service unavailable
2 properties 2 required
SettingsPatchDriverAppSettingsInternalServerErrorResponseBody
object
An internal server error occurred
2 properties 2 required
SettingsPatchDriverAppSettingsBadGatewayErrorResponseBody
object
Bad Gateway
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

samsara-settings-api-openapi.yml Raw ↑

Other APIs Samsara publishes across the network.

Samsara Activity API
Samsara Addresses API
Samsara Aemp API
Samsara Applications API
Samsara Assets API
Samsara Assignments API
Samsara Attributes API
Samsara Audit API
Samsara Beta A P Is API
Samsara Camera API
Samsara Cameras API
Samsara Cargo API
Where this information came from

This is an independent, third-party profile of Samsara Settings API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.