[preview] Create a tachograph file upload.

post

https://api.samsara.com/preview/fleet/tachograph/file-uploads

Reserve a tachograph file upload and return a presigned URL. Upload the file bytes directly to the URL with the returned headers. The driver or device the file belongs to is resolved from the file contents after upload.

Rate limit: 100 requests/min (learn more about rate limits here).

To use this endpoint, select Write Tachograph (EU) under the Compliance category when creating or editing an API token. Learn More.

Endpoints in this section are in Preview. These APIs are not functional and are instead for soliciting feedback from our API users on the intended design of this API. Additionally, it is not guaranteed that we will be releasing an endpoint included in this section to production. This means that developers should NOT rely on these APIs to build business critical applications

Samsara may change the structure of a preview API's interface without versioning or any notice to API users.
When an endpoint becomes generally available, it will be announced in the API changelog.

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…

Body Params

Request body for reserving a tachograph file upload.

contentMd5

string

required

Base64-encoded MD5 digest of the file bytes (base64(md5(bytes))). Used as the Content-MD5 integrity check enforced by object storage on upload.

contentType

string

enum

required

The MIME content type of the file. The upload is sent to object storage as raw bytes. Valid values: application/octet-stream

Allowed:

fileSizeBytes

integer

required

≥ 1

The size of the file in bytes. Enforced as the Content-Length on upload and validated against the maximum allowed tachograph file size.

fileType

string

enum

required

The kind of tachograph file being uploaded. The driver or device the file belongs to is resolved from the file contents, not from this field. Valid values: driverCard, vehicleUnit

Allowed:

Responses

200OK response.

401Unauthorized response.

404Not Found response.

405Method Not Allowed response.

429Too Many Requests response.

500Internal Server Error response.

501Not Implemented response.

502Bad Gateway response.

503Service Unavailable response.

504Gateway Timeout response.

defaultBad Request response.