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 Assets API

The Assets API from Samsara — 8 operation(s) for assets.

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

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

This API exposes 10 operations across 8 paths, and defines 61 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/.

10 operations 8 paths 61 schemas 1 DELETE6 GET2 PATCH1 POST

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 Assets API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (AccessTokenHeader). By default, every request must be authenticated.

Paths & Operations 10

Across 8 paths, the API surfaces 10 operations — 1 DELETE, 6 GET, 2 PATCH, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Assets 10
GET
/industrial/assets
List All Assets
getIndustrialAssets 5 params → 200default
POST
/industrial/assets
Create an Asset
createIndustrialAsset body → 200default
DELETE
/industrial/assets/{id}
Delete an Existing Asset
deleteIndustrialAsset 1 param → 204default
PATCH
/industrial/assets/{id}
Update an Asset
patchIndustrialAsset 1 param body → 200default
PATCH
/industrial/assets/{id}/data-outputs
Writes to Data Outputs on an Asset
patchAssetDataOutputs 1 param body → 200401404405429500501502
GET
/v1/fleet/assets
List All Assets
V1getAllAssets → 200default
GET
/v1/fleet/assets/locations
List Current Location for All Assets
V1getAllAssetCurrentLocations 3 params → 200default
GET
/v1/fleet/assets/reefers
List Stats for All Reefers
V1getAssetsReefers 5 params → 200default
GET
/v1/fleet/assets/{asset_id}/locations
List Historical Locations for a Given Asset
V1getAssetLocation 3 params → 200default
GET
/v1/fleet/assets/{asset_id}/reefer
List Stats for a Given Reefer
V1getAssetReefer 3 params → 200default

Schemas 61

The contract defines 61 schemas that model the data the API accepts and returns. The most detailed are AssetResponse (11 properties), AssetPatch (8 properties), V1AssetsReefer_reeferStats (8 properties), AssetCreate (8 properties). Each schema is shown below with its type and property counts.

PatchAssetDataOutputsSingleResponseResponseBody
object
A response that corresponds to an element in the original request body.
3 properties 2 required
AssetDataInput_lastPoint
object
The last reported point of a data input.
2 properties
V1AssetReeferResponse_reeferStats_alarms
object
4 properties
V1ErrorResponse
string
Error message describing why the request failed.
inline_response_200_1
object
1 property
inline_response_200_3
object
2 properties
time
string
UTC timestamp in RFC 3339 format. Example: 2020-01-27T07:06:25Z.
AssetResponse_runningStatusDataInput
object
The associated running status data input. isRunning will be true when the data input's value is 1.
1 property 1 required
AssetResponse_parentAsset
object
The asset's parent
2 properties 2 required
AssetDataOutputsPatchAssetDataOutputsInternalServerErrorResponseBody
object
An internal server error occurred
2 properties 2 required
V1AssetReeferResponse_reeferStats
object
6 properties
V1Asset_cable
object
The cable connected to the asset
1 property
AssetDataOutputsPatchAssetDataOutputsNotFoundErrorResponseBody
object
Resource not found
2 properties 2 required
AssetDataOutputsPatchAssetDataOutputsTooManyRequestsErrorResponseBody
object
Too many requests
2 properties 2 required
tagTinyResponse
object
A minified tag object
3 properties
AssetDataOutput
object
5 properties
standardErrorResponse
object
Error response
2 properties
CustomMetadata
object
The custom fields of an asset.
V1Asset
object
Basic information of an asset
6 properties 1 required
V1Pagination
object
4 properties 4 required
AssetDataOutputsPatchAssetDataOutputsMethodNotAllowedErrorResponseBody
object
Method not allowed
2 properties 2 required
AssetDataOutputsPatchAssetDataOutputsResponseBody
object
1 property 1 required
AssetDataOutputsPatchAssetDataOutputsNotImplementedErrorResponseBody
object
Requested endpoint is not yet implemented
2 properties 2 required
V1AssetReeferResponse_reeferStats_fuelPercentage
object
2 properties
latitude
number
The latitude of the asset in decimal degrees.
AssetDataOutputsPatchAssetDataOutputsRequestBody
object
1 property 1 required
AssetCreate
object
The asset creation arguments
8 properties 1 required
V1AssetReeferResponse
object
Reefer-specific asset details
4 properties
V1AssetReeferResponse_reeferStats_alarms_1
object
2 properties
AssetName
string
The name of the asset.
LocationType
string
The format of the location. This field is required if a location is provided. Valid values: point, address, dataInput.
inline_response_200_2
object
2 properties
V1AssetsReefer_reeferStats
object
Contains all the state changes of the reefer for the included stat types. Each state change is recorded independently, so the number of records in each array m…
8 properties
ParentId
string
The id of the parent asset that the asset belongs to.
V1AssetCurrentLocation
object
Current location of an asset
5 properties
V1AssetReeferResponse_reeferStats_powerStatus
object
2 properties
V1AssetsReefer_reeferStats_ambientAirTemperature
object
2 properties
AssetDataInput
object
5 properties
V1AssetReeferResponse_reeferStats_setPoint
object
2 properties
AssetLocation
object
For locationType "point", latitude and longitude are required. For "address", formattedAddress must be provided, and lat/long can be optionally included for di…
3 properties
TagIds
array
The ids of the tags that the asset should belong to.
standardDeleteResponse
string
A successful DELETE response is a 204 with no content.
AssetDataOutputsPatchAssetDataOutputsBadRequestErrorResponseBody
object
Bad Request parameters
2 properties 2 required
paginationResponse
object
Pagination parameters.
2 properties 2 required
AssetDataOutputsPatchAssetDataOutputsGatewayTimeoutErrorResponseBody
object
Gateway timeout
2 properties 2 required
V1AssetReeferResponse_reeferStats_returnAirTemp
object
2 properties
AssetResponse
object
Asset
11 properties 3 required
inline_response_200
object
1 property
V1AssetsReefer_reeferStats_dischargeAirTemperature
object
2 properties
ListIndustrialAssetsResponse
object
2 properties
V1AssetReeferResponse_reeferStats_engineHours
object
2 properties
AssetDataOutputsPatchAssetDataOutputsBadGatewayErrorResponseBody
object
Bad Gateway
2 properties 2 required
AssetResponse_locationDataInput
object
The associated location data input (only applicable when locationType is "dataInput").
1 property 1 required
V1AssetsReefer_reeferStats_powerStatus
object
2 properties
AssetDataOutputsPatchAssetDataOutputsUnauthorizedErrorResponseBody
object
Unauthorized
2 properties 2 required
AssetPatch
object
The asset creation arguments
8 properties
V1AssetLocationResponse
array
A list of historical asset locations.
AssetDataOutputsPatchAssetDataOutputsServiceUnavailableErrorResponseBody
object
Service unavailable
2 properties 2 required
V1AssetsReefer
object
Reefer-specific details
4 properties
longitude
number
The longitude of the asset in decimal degrees.
V1AssetCurrentLocationsResponse
object
Basic information of an asset
6 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

samsara-assets-api-openapi.yml Raw ↑

Other APIs Samsara publishes across the network.

Samsara Activity API
Samsara Addresses API
Samsara Aemp API
Samsara Applications 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
Samsara Carrier API
Where this information came from

This is an independent, third-party profile of Samsara Assets 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.