samsara-api 0.0.1__py3-none-any.whl → 0.0.2__py3-none-any.whl

samsara/form_submissions/raw_client.py

@@ -7,6 +7,7 @@ from json.decoder import JSONDecodeError
 from ..core.api_error import ApiError
 from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
 from ..core.http_response import AsyncHttpResponse, HttpResponse
+from ..core.pagination import AsyncPager, BaseHttpResponse, SyncPager
 from ..core.pydantic_utilities import parse_obj_as
 from ..core.request_options import RequestOptions
 from ..core.serialization import convert_and_respect_annotation_metadata
@@ -26,13 +27,14 @@ from ..types.form_submission_request_assigned_to_request_body import FormSubmiss
 from ..types.form_submission_request_field_input_object_request_body import (
     FormSubmissionRequestFieldInputObjectRequestBody,
 )
+from ..types.form_submission_response_object_response_body import FormSubmissionResponseObjectResponseBody
 from ..types.form_submissions_get_form_submissions_response_body import FormSubmissionsGetFormSubmissionsResponseBody
 from ..types.form_submissions_get_form_submissions_stream_response_body import (
     FormSubmissionsGetFormSubmissionsStreamResponseBody,
 )
 from ..types.form_submissions_patch_form_submission_response_body import FormSubmissionsPatchFormSubmissionResponseBody
 from ..types.form_submissions_post_form_submission_response_body import FormSubmissionsPostFormSubmissionResponseBody
-from ..types.form_template_reference_object_request_body import FormTemplateReferenceObjectRequestBody
+from ..types.form_template_request_object_request_body import FormTemplateRequestObjectRequestBody
 from .types.form_submissions_patch_form_submission_request_body_status import (
     FormSubmissionsPatchFormSubmissionRequestBodyStatus,
 )
@@ -53,13 +55,11 @@ class RawFormSubmissionsClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> HttpResponse[FormSubmissionsGetFormSubmissionsResponseBody]:
         """
-        Returns all form submissions data for the specified IDs.
-
-        **Beta:** This endpoint is in beta and is likely to change before being broadly available. Reach out to your Samsara Representative to have Forms APIs enabled for your organization.
+        Returns all form submissions data for the specified list of IDs.
 
          <b>Rate limit:</b> 5 requests/sec (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).
 
-        To use this endpoint, select **Read Form Submissions** under the Closed Beta category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
+        To use this endpoint, select **Read Form Submissions** under the Forms category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
 
 
          **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.
@@ -70,7 +70,7 @@ class RawFormSubmissionsClient:
             A comma-separated list containing up to 100 form submission IDs to filter on. Can be either a unique Samsara ID or an [external ID](https://developers.samsara.com/docs/external-ids) for the form submission.
 
         include : typing.Optional[typing.Union[str, typing.Sequence[str]]]
-            A comma-separated list of strings indicating whether to return additional information. Valid values: `externalIds`, `fieldLabels`
+            A comma-separated list of strings indicating whether to return additional information. Valid values: `externalIds`
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -206,7 +206,7 @@ class RawFormSubmissionsClient:
     def create(
         self,
         *,
-        form_template: FormTemplateReferenceObjectRequestBody,
+        form_template: FormTemplateRequestObjectRequestBody,
         assigned_to: typing.Optional[FormSubmissionRequestAssignedToRequestBody] = OMIT,
         due_at_time: typing.Optional[dt.datetime] = OMIT,
         fields: typing.Optional[typing.Sequence[FormSubmissionRequestFieldInputObjectRequestBody]] = OMIT,
@@ -216,20 +216,18 @@ class RawFormSubmissionsClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> HttpResponse[FormSubmissionsPostFormSubmissionResponseBody]:
         """
-        Creates a form submission.
-
-        **Beta:** This endpoint is in beta and is likely to change before being broadly available. Reach out to your Samsara Representative to have Forms APIs enabled for your organization.
+        Creates a form submission and assigns it to an individual worker. This endpoint can be used to create an empty or partially complete form submission and assign it to a worker.
 
          <b>Rate limit:</b> 100 requests/min (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).
 
-        To use this endpoint, select **Write Form Submissions** under the Closed Beta category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
+        To use this endpoint, select **Write Form Submissions** under the Forms category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
 
 
          **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.
 
         Parameters
         ----------
-        form_template : FormTemplateReferenceObjectRequestBody
+        form_template : FormTemplateRequestObjectRequestBody
 
         assigned_to : typing.Optional[FormSubmissionRequestAssignedToRequestBody]
 
@@ -270,7 +268,7 @@ class RawFormSubmissionsClient:
                     direction="write",
                 ),
                 "formTemplate": convert_and_respect_annotation_metadata(
-                    object_=form_template, annotation=FormTemplateReferenceObjectRequestBody, direction="write"
+                    object_=form_template, annotation=FormTemplateRequestObjectRequestBody, direction="write"
                 ),
                 "isRequired": is_required,
                 "routeStopId": route_stop_id,
@@ -413,11 +411,9 @@ class RawFormSubmissionsClient:
         """
         Updates an instance of a form submission.
 
-        **Beta:** This endpoint is in beta and is likely to change before being broadly available. Reach out to your Samsara Representative to have Forms APIs enabled for your organization.
-
          <b>Rate limit:</b> 100 requests/min (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).
 
-        To use this endpoint, select **Write Form Submissions** under the Closed Beta category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
+        To use this endpoint, select **Write Form Submissions** under the Forms category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
 
 
          **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.
@@ -605,15 +601,13 @@ class RawFormSubmissionsClient:
         include: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         assigned_to_route_stop_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> HttpResponse[FormSubmissionsGetFormSubmissionsStreamResponseBody]:
+    ) -> SyncPager[FormSubmissionResponseObjectResponseBody]:
         """
         Returns all form submissions data that has been created or modified for your organization based on the time parameters passed in. Results are paginated and are sorted by last modified date. If you include an endTime, the endpoint will return data up until that point (exclusive). If you don’t include an endTime, you can continue to poll the API real-time with the pagination cursor that gets returned on every call.
 
-        **Beta:** This endpoint is in beta and is likely to change before being broadly available. Reach out to your Samsara Representative to have Forms APIs enabled for your organization.
-
          <b>Rate limit:</b> 5 requests/sec (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).
 
-        To use this endpoint, select **Read Form Submissions** under the Closed Beta category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
+        To use this endpoint, select **Read Form Submissions** under the Forms category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
 
 
          **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.
@@ -639,7 +633,7 @@ class RawFormSubmissionsClient:
             A comma-separated list containing up to 50 user IDs to filter data to.
 
         include : typing.Optional[typing.Union[str, typing.Sequence[str]]]
-            A comma-separated list of strings indicating whether to return additional information. Valid values: `externalIds`, `fieldLabels`
+            A comma-separated list of strings indicating whether to return additional information. Valid values: `externalIds`
 
         assigned_to_route_stop_ids : typing.Optional[typing.Union[str, typing.Sequence[str]]]
             A comma-separated list containing up to 50 route stop IDs to filter data to.
@@ -649,7 +643,7 @@ class RawFormSubmissionsClient:
 
         Returns
         -------
-        HttpResponse[FormSubmissionsGetFormSubmissionsStreamResponseBody]
+        SyncPager[FormSubmissionResponseObjectResponseBody]
             OK response.
         """
         _response = self._client_wrapper.httpx_client.request(
@@ -669,14 +663,33 @@ class RawFormSubmissionsClient:
         )
         try:
             if 200 <= _response.status_code < 300:
-                _data = typing.cast(
+                _parsed_response = typing.cast(
                     FormSubmissionsGetFormSubmissionsStreamResponseBody,
                     parse_obj_as(
                         type_=FormSubmissionsGetFormSubmissionsStreamResponseBody,  # type: ignore
                         object_=_response.json(),
                     ),
                 )
-                return HttpResponse(response=_response, data=_data)
+                _items = _parsed_response.data
+                _has_next = False
+                _get_next = None
+                if _parsed_response.pagination is not None:
+                    _parsed_next = _parsed_response.pagination.end_cursor
+                    _has_next = _parsed_next is not None and _parsed_next != ""
+                    _get_next = lambda: self.stream(
+                        start_time=start_time,
+                        end_time=end_time,
+                        after=_parsed_next,
+                        form_template_ids=form_template_ids,
+                        user_ids=user_ids,
+                        driver_ids=driver_ids,
+                        include=include,
+                        assigned_to_route_stop_ids=assigned_to_route_stop_ids,
+                        request_options=request_options,
+                    )
+                return SyncPager(
+                    has_next=_has_next, items=_items, get_next=_get_next, response=BaseHttpResponse(response=_response)
+                )
             if _response.status_code == 401:
                 raise UnauthorizedError(
                     headers=dict(_response.headers),
@@ -794,13 +807,11 @@ class AsyncRawFormSubmissionsClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AsyncHttpResponse[FormSubmissionsGetFormSubmissionsResponseBody]:
         """
-        Returns all form submissions data for the specified IDs.
-
-        **Beta:** This endpoint is in beta and is likely to change before being broadly available. Reach out to your Samsara Representative to have Forms APIs enabled for your organization.
+        Returns all form submissions data for the specified list of IDs.
 
          <b>Rate limit:</b> 5 requests/sec (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).
 
-        To use this endpoint, select **Read Form Submissions** under the Closed Beta category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
+        To use this endpoint, select **Read Form Submissions** under the Forms category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
 
 
          **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.
@@ -811,7 +822,7 @@ class AsyncRawFormSubmissionsClient:
             A comma-separated list containing up to 100 form submission IDs to filter on. Can be either a unique Samsara ID or an [external ID](https://developers.samsara.com/docs/external-ids) for the form submission.
 
         include : typing.Optional[typing.Union[str, typing.Sequence[str]]]
-            A comma-separated list of strings indicating whether to return additional information. Valid values: `externalIds`, `fieldLabels`
+            A comma-separated list of strings indicating whether to return additional information. Valid values: `externalIds`
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -947,7 +958,7 @@ class AsyncRawFormSubmissionsClient:
     async def create(
         self,
         *,
-        form_template: FormTemplateReferenceObjectRequestBody,
+        form_template: FormTemplateRequestObjectRequestBody,
         assigned_to: typing.Optional[FormSubmissionRequestAssignedToRequestBody] = OMIT,
         due_at_time: typing.Optional[dt.datetime] = OMIT,
         fields: typing.Optional[typing.Sequence[FormSubmissionRequestFieldInputObjectRequestBody]] = OMIT,
@@ -957,20 +968,18 @@ class AsyncRawFormSubmissionsClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AsyncHttpResponse[FormSubmissionsPostFormSubmissionResponseBody]:
         """
-        Creates a form submission.
-
-        **Beta:** This endpoint is in beta and is likely to change before being broadly available. Reach out to your Samsara Representative to have Forms APIs enabled for your organization.
+        Creates a form submission and assigns it to an individual worker. This endpoint can be used to create an empty or partially complete form submission and assign it to a worker.
 
          <b>Rate limit:</b> 100 requests/min (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).
 
-        To use this endpoint, select **Write Form Submissions** under the Closed Beta category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
+        To use this endpoint, select **Write Form Submissions** under the Forms category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
 
 
          **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.
 
         Parameters
         ----------
-        form_template : FormTemplateReferenceObjectRequestBody
+        form_template : FormTemplateRequestObjectRequestBody
 
         assigned_to : typing.Optional[FormSubmissionRequestAssignedToRequestBody]
 
@@ -1011,7 +1020,7 @@ class AsyncRawFormSubmissionsClient:
                     direction="write",
                 ),
                 "formTemplate": convert_and_respect_annotation_metadata(
-                    object_=form_template, annotation=FormTemplateReferenceObjectRequestBody, direction="write"
+                    object_=form_template, annotation=FormTemplateRequestObjectRequestBody, direction="write"
                 ),
                 "isRequired": is_required,
                 "routeStopId": route_stop_id,
@@ -1154,11 +1163,9 @@ class AsyncRawFormSubmissionsClient:
         """
         Updates an instance of a form submission.
 
-        **Beta:** This endpoint is in beta and is likely to change before being broadly available. Reach out to your Samsara Representative to have Forms APIs enabled for your organization.
-
          <b>Rate limit:</b> 100 requests/min (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).
 
-        To use this endpoint, select **Write Form Submissions** under the Closed Beta category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
+        To use this endpoint, select **Write Form Submissions** under the Forms category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
 
 
          **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.
@@ -1346,15 +1353,13 @@ class AsyncRawFormSubmissionsClient:
         include: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         assigned_to_route_stop_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> AsyncHttpResponse[FormSubmissionsGetFormSubmissionsStreamResponseBody]:
+    ) -> AsyncPager[FormSubmissionResponseObjectResponseBody]:
         """
         Returns all form submissions data that has been created or modified for your organization based on the time parameters passed in. Results are paginated and are sorted by last modified date. If you include an endTime, the endpoint will return data up until that point (exclusive). If you don’t include an endTime, you can continue to poll the API real-time with the pagination cursor that gets returned on every call.
 
-        **Beta:** This endpoint is in beta and is likely to change before being broadly available. Reach out to your Samsara Representative to have Forms APIs enabled for your organization.
-
          <b>Rate limit:</b> 5 requests/sec (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).
 
-        To use this endpoint, select **Read Form Submissions** under the Closed Beta category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
+        To use this endpoint, select **Read Form Submissions** under the Forms category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
 
 
          **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.
@@ -1380,7 +1385,7 @@ class AsyncRawFormSubmissionsClient:
             A comma-separated list containing up to 50 user IDs to filter data to.
 
         include : typing.Optional[typing.Union[str, typing.Sequence[str]]]
-            A comma-separated list of strings indicating whether to return additional information. Valid values: `externalIds`, `fieldLabels`
+            A comma-separated list of strings indicating whether to return additional information. Valid values: `externalIds`
 
         assigned_to_route_stop_ids : typing.Optional[typing.Union[str, typing.Sequence[str]]]
             A comma-separated list containing up to 50 route stop IDs to filter data to.
@@ -1390,7 +1395,7 @@ class AsyncRawFormSubmissionsClient:
 
         Returns
         -------
-        AsyncHttpResponse[FormSubmissionsGetFormSubmissionsStreamResponseBody]
+        AsyncPager[FormSubmissionResponseObjectResponseBody]
             OK response.
         """
         _response = await self._client_wrapper.httpx_client.request(
@@ -1410,14 +1415,36 @@ class AsyncRawFormSubmissionsClient:
         )
         try:
             if 200 <= _response.status_code < 300:
-                _data = typing.cast(
+                _parsed_response = typing.cast(
                     FormSubmissionsGetFormSubmissionsStreamResponseBody,
                     parse_obj_as(
                         type_=FormSubmissionsGetFormSubmissionsStreamResponseBody,  # type: ignore
                         object_=_response.json(),
                     ),
                 )
-                return AsyncHttpResponse(response=_response, data=_data)
+                _items = _parsed_response.data
+                _has_next = False
+                _get_next = None
+                if _parsed_response.pagination is not None:
+                    _parsed_next = _parsed_response.pagination.end_cursor
+                    _has_next = _parsed_next is not None and _parsed_next != ""
+
+                    async def _get_next():
+                        return await self.stream(
+                            start_time=start_time,
+                            end_time=end_time,
+                            after=_parsed_next,
+                            form_template_ids=form_template_ids,
+                            user_ids=user_ids,
+                            driver_ids=driver_ids,
+                            include=include,
+                            assigned_to_route_stop_ids=assigned_to_route_stop_ids,
+                            request_options=request_options,
+                        )
+
+                return AsyncPager(
+                    has_next=_has_next, items=_items, get_next=_get_next, response=BaseHttpResponse(response=_response)
+                )
             if _response.status_code == 401:
                 raise UnauthorizedError(
                     headers=dict(_response.headers),

samsara/forms/client.py

@@ -0,0 +1,138 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from ..core.request_options import RequestOptions
+from ..types.form_templates_get_form_templates_response_body import FormTemplatesGetFormTemplatesResponseBody
+from .raw_client import AsyncRawFormsClient, RawFormsClient
+
+
+class FormsClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._raw_client = RawFormsClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> RawFormsClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        RawFormsClient
+        """
+        return self._raw_client
+
+    def get_form_templates(
+        self,
+        *,
+        ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        after: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> FormTemplatesGetFormTemplatesResponseBody:
+        """
+        Returns a list of the organization's form templates for the specified list of IDs. If no IDs are provided, all form templates for the organization will be returned.
+
+         <b>Rate limit:</b> 5 requests/sec (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).
+
+        To use this endpoint, select **Read Form Submissions** under the Forms category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
+
+
+         **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.
+
+        Parameters
+        ----------
+        ids : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            A comma-separated list containing up to 100 template IDs to filter on.
+
+        after : typing.Optional[str]
+             If specified, this should be the endCursor value from the previous page of results. When present, this request will return the next page of results that occur immediately after the previous page of results.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        FormTemplatesGetFormTemplatesResponseBody
+            OK response.
+
+        Examples
+        --------
+        from samsara import Samsara
+
+        client = Samsara(
+            token="YOUR_TOKEN",
+        )
+        client.forms.get_form_templates()
+        """
+        _response = self._raw_client.get_form_templates(ids=ids, after=after, request_options=request_options)
+        return _response.data
+
+
+class AsyncFormsClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._raw_client = AsyncRawFormsClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> AsyncRawFormsClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        AsyncRawFormsClient
+        """
+        return self._raw_client
+
+    async def get_form_templates(
+        self,
+        *,
+        ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        after: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> FormTemplatesGetFormTemplatesResponseBody:
+        """
+        Returns a list of the organization's form templates for the specified list of IDs. If no IDs are provided, all form templates for the organization will be returned.
+
+         <b>Rate limit:</b> 5 requests/sec (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).
+
+        To use this endpoint, select **Read Form Submissions** under the Forms category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
+
+
+         **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.
+
+        Parameters
+        ----------
+        ids : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            A comma-separated list containing up to 100 template IDs to filter on.
+
+        after : typing.Optional[str]
+             If specified, this should be the endCursor value from the previous page of results. When present, this request will return the next page of results that occur immediately after the previous page of results.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        FormTemplatesGetFormTemplatesResponseBody
+            OK response.
+
+        Examples
+        --------
+        import asyncio
+
+        from samsara import AsyncSamsara
+
+        client = AsyncSamsara(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.forms.get_form_templates()
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.get_form_templates(ids=ids, after=after, request_options=request_options)
+        return _response.data