Note: This spec powers our API reference documentation, and is kept up-to-date with our API. This spec is provided as an optional resource for your convenience, but it has not been officially tested for use with code-generation libraries. Samsara frequently updates and refactors this spec to improve our API reference documentation.
Visit developers.samsara.com for getting started guides, reference documentation, and more!
We use swagger (also known as Open API) to document our REST APIs. There are two swagger files in this repo:
swagger.jsonswagger-legacy.json
Samsara is currently in the process of releasing a new generation of our APIs. You can read more about the new generation here, but suffice to say that the new generation contains many improvements to the first one.
swagger.json should be your go-to reference for Samsara's Open APIs. It contains the most recently released APIs, as well as any legacy APIs necessary to maintain feature parity. You can find the reference documentation here.
swagger-legacy.json is the Open API spec containing all of our legacy APIs, and should only be used if you need to use a legacy API for an old implementation. You can find the reference documentation for this set of APIs here.
Find out how to get started at developers.samsara.com