Samsara Submissions API
The Submissions API from Samsara — 3 operation(s) for submissions.
Samsara Submissions API is one of 90 APIs that Samsara publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Submissions. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and a GitHub repository.
This API exposes 6 operations across 3 paths, and defines 108 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/.
6 operations
3 paths
108 schemas
3 GET1 PATCH2 POST
Metadata
The identity and technical contract details declared by the specification.
Authentication & Security 1
Samsara Submissions API declares
1 security scheme
for authenticating requests.
It accepts HTTP bearer tokens (AccessTokenHeader).
By default, every request must be authenticated.
Paths & Operations 6
Across 3 paths, the API surfaces 6 operations — 3 GET, 1 PATCH, 2 POST. Each is listed below with its method, path, parameters, and response codes.
Submissions 6
GET
/form-submissions
[beta] Get a List of Specified Form Submissions.
PATCH
/form-submissions
[beta] Update a Single Form Submission.
POST
/form-submissions
[beta] Create a Form Submission.
GET
/form-submissions/pdf-exports
[beta] Return a PDF Export for a Form Submission.
POST
/form-submissions/pdf-exports
[beta] Create a PDF Export for a Form Submission.
GET
/form-submissions/stream
[beta] Get a Stream of Filtered Form Submissions.
Schemas 108
The contract defines 108 schemas that model the data the API accepts and returns. The most detailed are FormSubmissionResponseObjectResponseBody (17 properties), FormsFieldInputObjectResponseBody (16 properties), FormsTableCellObjectResponseBody (10 properties), FormSubmissionRequestFieldInputObjectRequestBody (10 properties). Each schema is shown below with its type and property counts.
FormSubmissionsGetFormSubmissionsGatewayTimeoutErrorResponseBody
object
Gateway timeout
2 properties
2 required
FormsPersonValueObjectResponseBody
object
The value of a person form input field.
1 property
1 required
FormSubmissionsPatchFormSubmissionMethodNotAllowedErrorResponseBody
object
Method not allowed
2 properties
2 required
FormSubmissionsPatchFormSubmissionUnauthorizedErrorResponseBody
object
Unauthorized
2 properties
2 required
FormSubmissionsGetFormSubmissionsPdfExportsBadRequestErrorResponseBody
object
Bad Request parameters
2 properties
2 required
FormsMediaRecordObjectResponseBody
object
Forms media record object.
4 properties
2 required
FormSubmissionsGetFormSubmissionsPdfExportsResponseBody
object
1 property
1 required
FormSubmissionsGetFormSubmissionsBadRequestErrorResponseBody
object
Bad Request parameters
2 properties
2 required
FormSubmissionRequestTableValueObjectRequestBody
object
The value of a table form input field. Only valid for table form input fields.
1 property
1 required
FormSubmissionsGetFormSubmissionsStreamNotFoundErrorResponseBody
object
Resource not found
2 properties
2 required
FormSubmissionsGetFormSubmissionsPdfExportsUnauthorizedErrorResponseBody
object
Unauthorized
2 properties
2 required
FormsNumberValueObjectResponseBody
object
The value of a number form input field.
1 property
1 required
FormSubmissionsGetFormSubmissionsStreamServiceUnavailableErrorResponseBody
object
Service unavailable
2 properties
2 required
FormSubmissionsGetFormSubmissionsPdfExportsNotFoundErrorResponseBody
object
Resource not found
2 properties
2 required
FormSubmissionsGetFormSubmissionsStreamUnauthorizedErrorResponseBody
object
Unauthorized
2 properties
2 required
FormSubmissionsPostFormSubmissionBadRequestErrorResponseBody
object
Bad Request parameters
2 properties
2 required
FormsTableValueObjectResponseBody
object
The value of a table form input field.
2 properties
2 required
FormSubmissionsPatchFormSubmissionGatewayTimeoutErrorResponseBody
object
Gateway timeout
2 properties
2 required
FormSubmissionPdfExportResponseObjectResponseBody
object
Form Submission PDF export response object.
9 properties
5 required
FormSubmissionsPostFormSubmissionsPdfExportsTooManyRequestsErrorResponseBody
object
Too many requests
2 properties
2 required
FormSubmissionsPatchFormSubmissionNotFoundErrorResponseBody
object
Resource not found
2 properties
2 required
FormSubmissionsGetFormSubmissionsInternalServerErrorResponseBody
object
An internal server error occurred
2 properties
2 required
FormSubmissionRequestTableCellObjectRequestBody
object
The value of a cell in a table row.
8 properties
2 required
FormSubmissionsGetFormSubmissionsServiceUnavailableErrorResponseBody
object
Service unavailable
2 properties
2 required
FormSubmissionsGetFormSubmissionsStreamTooManyRequestsErrorResponseBody
object
Too many requests
2 properties
2 required
FormSubmissionsPatchFormSubmissionRequestBody
object
Form submission fields to update.
5 properties
1 required
FormsScoreObjectResponseBody
object
Forms score object.
3 properties
3 required
FormSubmissionRequestDateTimeValueObjectRequestBody
object
The value of a datetime form input field. Only valid for datetime form input fields.
1 property
1 required
FormSubmissionsPatchFormSubmissionBadGatewayErrorResponseBody
object
Bad Gateway
2 properties
2 required
FormSubmissionRequestPersonObjectRequestBody
object
Person object.
1 property
1 required
FormsPolymorphicUserObjectResponseBody
object
User or driver object.
2 properties
2 required
FormSubmissionsPostFormSubmissionResponseBody
object
1 property
1 required
GoaPaginationResponseResponseBody
object
Pagination parameters.
2 properties
2 required
FormsAssetObjectResponseBody
object
Tracked or untracked (i.e. manually entered) asset object.
3 properties
1 required
FormSubmissionsPostFormSubmissionsPdfExportsBadGatewayErrorResponseBody
object
Bad Gateway
2 properties
2 required
FormSubmissionsGetFormSubmissionsStreamGatewayTimeoutErrorResponseBody
object
Gateway timeout
2 properties
2 required
FormSubmissionsPostFormSubmissionServiceUnavailableErrorResponseBody
object
Service unavailable
2 properties
2 required
FormsPersonObjectResponseBody
object
Tracked or untracked (i.e. manually entered) person object.
3 properties
1 required
FormSubmissionsGetFormSubmissionsNotImplementedErrorResponseBody
object
Requested endpoint is not yet implemented
2 properties
2 required
FormSubmissionRequestFieldInputObjectRequestBody
object
Forms input field request body object.
10 properties
2 required
FormsTableColumnObjectResponseBody
object
Defines a column in a table form input field.
3 properties
3 required
FormSubmissionsGetFormSubmissionsMethodNotAllowedErrorResponseBody
object
Method not allowed
2 properties
2 required
FormSubmissionsGetFormSubmissionsPdfExportsServiceUnavailableErrorResponseBody
object
Service unavailable
2 properties
2 required
FormSubmissionsGetFormSubmissionsPdfExportsTooManyRequestsErrorResponseBody
object
Too many requests
2 properties
2 required
FormSubmissionsGetFormSubmissionsStreamResponseBody
object
2 properties
2 required
FormSubmissionsGetFormSubmissionsStreamBadGatewayErrorResponseBody
object
Bad Gateway
2 properties
2 required
FormSubmissionsGetFormSubmissionsStreamInternalServerErrorResponseBody
object
An internal server error occurred
2 properties
2 required
FormSubmissionsPostFormSubmissionsPdfExportsGatewayTimeoutErrorResponseBody
object
Gateway timeout
2 properties
2 required
FormSubmissionsGetFormSubmissionsPdfExportsInternalServerErrorResponseBody
object
An internal server error occurred
2 properties
2 required
FormsLocationObjectResponseBody
object
Form template location object.
2 properties
2 required
FormTemplateReferenceObjectResponseBody
object
Form template reference object.
2 properties
2 required
FormSubmissionsPatchFormSubmissionServiceUnavailableErrorResponseBody
object
Service unavailable
2 properties
2 required
FormTemplateReferenceObjectRequestBody
object
Form template reference object.
2 properties
2 required
FormSubmissionsPostFormSubmissionNotImplementedErrorResponseBody
object
Requested endpoint is not yet implemented
2 properties
2 required
FormSubmissionsPatchFormSubmissionTooManyRequestsErrorResponseBody
object
Too many requests
2 properties
2 required
FormSubmissionsPostFormSubmissionRequestBody
object
Form submission fields to create.
6 properties
2 required
FormSubmissionsPostFormSubmissionNotFoundErrorResponseBody
object
Resource not found
2 properties
2 required
FormSubmissionsGetFormSubmissionsNotFoundErrorResponseBody
object
Resource not found
2 properties
2 required
FormSubmissionsPostFormSubmissionsPdfExportsNotFoundErrorResponseBody
object
Resource not found
2 properties
2 required
FormSubmissionsPostFormSubmissionUnauthorizedErrorResponseBody
object
Unauthorized
2 properties
2 required
FormsAssetValueObjectResponseBody
object
The value of an asset form input field.
1 property
1 required
FormSubmissionsGetFormSubmissionsPdfExportsNotImplementedErrorResponseBody
object
Requested endpoint is not yet implemented
2 properties
2 required
FormSubmissionsGetFormSubmissionsStreamNotImplementedErrorResponseBody
object
Requested endpoint is not yet implemented
2 properties
2 required
FormSubmissionsGetFormSubmissionsStreamMethodNotAllowedErrorResponseBody
object
Method not allowed
2 properties
2 required
FormSubmissionsGetFormSubmissionsPdfExportsGatewayTimeoutErrorResponseBody
object
Gateway timeout
2 properties
2 required
FormSubmissionRequestTableRowObjectRequestBody
object
The value of a row in a table form input field.
2 properties
2 required
FormSubmissionsPostFormSubmissionsPdfExportsUnauthorizedErrorResponseBody
object
Unauthorized
2 properties
2 required
FormSubmissionRequestAssignedToRequestBody
object
Form submission assignee update object
2 properties
2 required
FormSubmissionsGetFormSubmissionsResponseBody
object
1 property
1 required
FormSubmissionRequestNumberValueObjectRequestBody
object
The value of a number form input field. Only valid for number form input fields.
1 property
1 required
FormSubmissionRequestAssetValueObjectRequestBody
object
The value of an asset form input field. Only valid for asset form input fields.
1 property
1 required
FormSubmissionsPostFormSubmissionTooManyRequestsErrorResponseBody
object
Too many requests
2 properties
2 required
FormSubmissionRequestCheckBoxesValueObjectRequestBody
object
The value of a check boxes form input field. Only valid for check boxes form input fields.
1 property
1 required
FormSubmissionsGetFormSubmissionsPdfExportsBadGatewayErrorResponseBody
object
Bad Gateway
2 properties
2 required
FormsTableRowObjectResponseBody
object
Defines a row in a table form input field.
2 properties
2 required
FormsMediaValueObjectResponseBody
object
The value of a media form input field.
1 property
1 required
FormSubmissionsPostFormSubmissionsPdfExportsResponseBody
object
1 property
1 required
FormSubmissionsGetFormSubmissionsBadGatewayErrorResponseBody
object
Bad Gateway
2 properties
2 required
FormSubmissionsPatchFormSubmissionResponseBody
object
1 property
1 required
FormsIssueCreatedByFieldObjectResponseBody
object
Issue created from this form input field input object.
2 properties
1 required
FormSubmissionRequestAssetObjectRequestBody
object
Asset object.
1 property
1 required
FormSubmissionsPatchFormSubmissionBadRequestErrorResponseBody
object
Bad Request parameters
2 properties
2 required
FormSubmissionsPatchFormSubmissionNotImplementedErrorResponseBody
object
Requested endpoint is not yet implemented
2 properties
2 required
FormSubmissionsGetFormSubmissionsTooManyRequestsErrorResponseBody
object
Too many requests
2 properties
2 required
FormSubmissionRequestTextValueObjectRequestBody
object
The value of a text form input field. Only valid for text form input fields.
1 property
1 required
FormSubmissionsPostFormSubmissionGatewayTimeoutErrorResponseBody
object
Gateway timeout
2 properties
2 required
FormSubmissionRequestMultipleChoiceValueObjectRequestBody
object
The value of a multiple choice form input field. Only valid for multiple choice form input fields.
1 property
1 required
FormSubmissionsPostFormSubmissionBadGatewayErrorResponseBody
object
Bad Gateway
2 properties
2 required
FormSubmissionRequestPersonValueObjectRequestBody
object
The value of an person form input field. Only valid for person form input fields.
1 property
1 required
FormSubmissionsGetFormSubmissionsUnauthorizedErrorResponseBody
object
Unauthorized
2 properties
2 required
FormSubmissionsGetFormSubmissionsPdfExportsMethodNotAllowedErrorResponseBody
object
Method not allowed
2 properties
2 required
FormsTextValueObjectResponseBody
object
The value of a text form input field.
1 property
1 required
FormSubmissionsPostFormSubmissionsPdfExportsBadRequestErrorResponseBody
object
Bad Request parameters
2 properties
2 required
FormsFieldInputObjectResponseBody
object
Forms input field object.
16 properties
2 required
FormSubmissionsPostFormSubmissionsPdfExportsServiceUnavailableErrorResponseBody
object
Service unavailable
2 properties
2 required
FormSubmissionsPostFormSubmissionsPdfExportsInternalServerErrorResponseBody
object
An internal server error occurred
2 properties
2 required
FormsTableCellObjectResponseBody
object
Defines a cell in a table row.
10 properties
2 required
FormSubmissionResponseObjectResponseBody
object
Form Submission response object.
17 properties
8 required
FormsSignatureValueObjectResponseBody
object
The value of a signature form input field.
1 property
1 required
FormSubmissionsPatchFormSubmissionInternalServerErrorResponseBody
object
An internal server error occurred
2 properties
2 required
FormsCheckBoxesValueObjectResponseBody
object
The value of a check boxes form input field.
1 property
1 required
FormSubmissionsPostFormSubmissionsPdfExportsMethodNotAllowedErrorResponseBody
object
Method not allowed
2 properties
2 required
FormsMultipleChoiceValueObjectResponseBody
object
The value of a multiple choice form input field.
1 property
1 required
FormsDateTimeValueObjectResponseBody
object
The value of a datetime form input field.
2 properties
2 required
FormSubmissionsPostFormSubmissionInternalServerErrorResponseBody
object
An internal server error occurred
2 properties
2 required
FormSubmissionsGetFormSubmissionsStreamBadRequestErrorResponseBody
object
Bad Request parameters
2 properties
2 required
FormSubmissionsPostFormSubmissionsPdfExportsNotImplementedErrorResponseBody
object
Requested endpoint is not yet implemented
2 properties
2 required
FormSubmissionsPostFormSubmissionMethodNotAllowedErrorResponseBody
object
Method not allowed
2 properties
2 required
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from Samsara 12
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
#Submissions
Where this information came from
This is an independent, third-party profile of Samsara Submissions 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.