samsara-api 3.0.0__py3-none-any.whl → 4.0.1__py3-none-any.whl

samsara/legacy_ap_is/client.py

@@ -0,0 +1,879 @@
+# 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.defects_response import DefectsResponse
+from ..types.drivers_vehicle_assignments_get_drivers_vehicle_assignments_response_body import (
+    DriversVehicleAssignmentsGetDriversVehicleAssignmentsResponseBody,
+)
+from ..types.dvirs_list_response import DvirsListResponse
+from ..types.idling_reports_get_vehicle_idling_reports_response_body import (
+    IdlingReportsGetVehicleIdlingReportsResponseBody,
+)
+from ..types.vehicles_driver_assignments_get_vehicles_driver_assignments_response_body import (
+    VehiclesDriverAssignmentsGetVehiclesDriverAssignmentsResponseBody,
+)
+from .raw_client import AsyncRawLegacyApIsClient, RawLegacyApIsClient
+from .types.get_drivers_vehicle_assignments_request_driver_activation_status import (
+    GetDriversVehicleAssignmentsRequestDriverActivationStatus,
+)
+
+
+class LegacyApIsClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._raw_client = RawLegacyApIsClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> RawLegacyApIsClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        RawLegacyApIsClient
+        """
+        return self._raw_client
+
+    def get_dvir_defects(
+        self,
+        *,
+        start_time: str,
+        end_time: str,
+        limit: typing.Optional[int] = None,
+        after: typing.Optional[str] = None,
+        is_resolved: typing.Optional[bool] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> DefectsResponse:
+        """
+        **Note: This is a legacy endpoint, consider using [this endpoint](https://developers.samsara.com/reference/streamdefects) instead. The endpoint will continue to function as documented.**
+
+        Returns a list of DVIR defects in an organization, filtered by creation time. The maximum time period you can query for is 30 days.
+
+         **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.
+
+        To use this endpoint, select **Read Defects** under the Maintenance 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>
+
+        Parameters
+        ----------
+        start_time : str
+            A start time in RFC 3339 format. Millisecond precision and timezones are supported. (Examples: 2019-06-13T19:08:25Z, 2019-06-13T19:08:25.455Z, OR 2015-09-15T14:00:12-04:00). *The maximum time period you can query for is 30 days.*
+
+        end_time : str
+            An end time in RFC 3339 format. Millisecond precision and timezones are supported. (Examples: 2019-06-13T19:08:25Z, 2019-06-13T19:08:25.455Z, OR 2015-09-15T14:00:12-04:00). *The maximum time period you can query for is 30 days.*
+
+        limit : typing.Optional[int]
+            The limit for how many objects will be in the response. Default and max for this value is 512 objects.
+
+        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.
+
+        is_resolved : typing.Optional[bool]
+            A filter on the data based on resolution status. Example: `isResolved=true`
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        DefectsResponse
+            List of all DVIR defects in the organization
+
+        Examples
+        --------
+        from samsara import Samsara
+
+        client = Samsara(
+            token="YOUR_TOKEN",
+        )
+        client.legacy_ap_is.get_dvir_defects(
+            limit=1000000,
+            after="after",
+            start_time="startTime",
+            end_time="endTime",
+            is_resolved=True,
+        )
+        """
+        _response = self._raw_client.get_dvir_defects(
+            start_time=start_time,
+            end_time=end_time,
+            limit=limit,
+            after=after,
+            is_resolved=is_resolved,
+            request_options=request_options,
+        )
+        return _response.data
+
+    def get_drivers_vehicle_assignments(
+        self,
+        *,
+        driver_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        start_time: typing.Optional[str] = None,
+        end_time: typing.Optional[str] = None,
+        tag_ids: typing.Optional[str] = None,
+        parent_tag_ids: typing.Optional[str] = None,
+        driver_activation_status: typing.Optional[GetDriversVehicleAssignmentsRequestDriverActivationStatus] = None,
+        after: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> DriversVehicleAssignmentsGetDriversVehicleAssignmentsResponseBody:
+        """
+        **Note: This is a legacy endpoint, consider using [this endpoint](https://developers.samsara.com/reference/getdrivervehicleassignments) instead. The endpoint will continue to function as documented.** Get all vehicle assignments for the requested drivers in the requested time range. The only type of assignment supported right now are assignments created through the driver app.
+
+         <b>Rate limit:</b> 25 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 Assignments** under the Assignments 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
+        ----------
+        driver_ids : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+             A filter on the data based on this comma-separated list of driver IDs and externalIds. Example: `driverIds=1234,5678,payroll:4841`
+
+        start_time : typing.Optional[str]
+             A start time in RFC 3339 format. Defaults to now if not provided. Millisecond precision and timezones are supported. (Examples: 2019-06-13T19:08:25Z, 2019-06-13T19:08:25.455Z, OR 2015-09-15T14:00:12-04:00). The maximum allowed startTime-endTime range is 7 days.
+
+        end_time : typing.Optional[str]
+             An end time in RFC 3339 format. Defaults to now if not provided. Millisecond precision and timezones are supported. (Examples: 2019-06-13T19:08:25Z, 2019-06-13T19:08:25.455Z, OR 2015-09-15T14:00:12-04:00). The maximum allowed startTime-endTime range is 7 days.
+
+        tag_ids : typing.Optional[str]
+             A filter on the data based on this comma-separated list of driver tag IDs. Example: `tagIds=1234,5678`
+
+        parent_tag_ids : typing.Optional[str]
+             A filter on the data based on this comma-separated list of driver parent tag IDs, for use by orgs with tag hierarchies. Specifying a parent tag will implicitly include all descendent tags of the parent tag. Example: `parentTagIds=345,678`
+
+        driver_activation_status : typing.Optional[GetDriversVehicleAssignmentsRequestDriverActivationStatus]
+            If value is `deactivated`, only drivers that are deactivated will appear in the response. This parameter will default to `active` if not provided (fetching only active drivers).  Valid values: `active`, `deactivated`
+
+        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
+        -------
+        DriversVehicleAssignmentsGetDriversVehicleAssignmentsResponseBody
+            OK response.
+
+        Examples
+        --------
+        from samsara import Samsara
+
+        client = Samsara(
+            token="YOUR_TOKEN",
+        )
+        client.legacy_ap_is.get_drivers_vehicle_assignments(
+            start_time="startTime",
+            end_time="endTime",
+            tag_ids="tagIds",
+            parent_tag_ids="parentTagIds",
+            driver_activation_status="active",
+            after="after",
+        )
+        """
+        _response = self._raw_client.get_drivers_vehicle_assignments(
+            driver_ids=driver_ids,
+            start_time=start_time,
+            end_time=end_time,
+            tag_ids=tag_ids,
+            parent_tag_ids=parent_tag_ids,
+            driver_activation_status=driver_activation_status,
+            after=after,
+            request_options=request_options,
+        )
+        return _response.data
+
+    def get_dvir_history(
+        self,
+        *,
+        start_time: str,
+        end_time: str,
+        limit: typing.Optional[int] = None,
+        after: typing.Optional[str] = None,
+        parent_tag_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        tag_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> DvirsListResponse:
+        """
+        **Note: This is a legacy endpoint, consider using [this endpoint](https://developers.samsara.com/reference/getdvirs) instead. The endpoint will continue to function as documented.**
+
+         Returns a list of all DVIRs in an organization.
+
+         **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.
+
+        To use this endpoint, select **Read DVIRs** under the Maintenance 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>
+
+        Parameters
+        ----------
+        start_time : str
+            A start time in RFC 3339 format. Millisecond precision and timezones are supported. (Examples: 2019-06-13T19:08:25Z, 2019-06-13T19:08:25.455Z, OR 2015-09-15T14:00:12-04:00).
+
+        end_time : str
+            An end time in RFC 3339 format. Millisecond precision and timezones are supported. (Examples: 2019-06-13T19:08:25Z, 2019-06-13T19:08:25.455Z, OR 2015-09-15T14:00:12-04:00).
+
+        limit : typing.Optional[int]
+            The limit for how many objects will be in the response. Default and max for this value is 512 objects.
+
+        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.
+
+        parent_tag_ids : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            A filter on the data based on this comma-separated list of parent tag IDs, for use by orgs with tag hierarchies. Specifying a parent tag will implicitly include all descendent tags of the parent tag. Example: `parentTagIds=345,678`
+
+        tag_ids : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            A filter on the data based on this comma-separated list of tag IDs. Example: `tagIds=1234,5678`
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        DvirsListResponse
+            List of all DVIRs in the organization
+
+        Examples
+        --------
+        from samsara import Samsara
+
+        client = Samsara(
+            token="YOUR_TOKEN",
+        )
+        client.legacy_ap_is.get_dvir_history(
+            limit=1000000,
+            after="after",
+            start_time="startTime",
+            end_time="endTime",
+        )
+        """
+        _response = self._raw_client.get_dvir_history(
+            start_time=start_time,
+            end_time=end_time,
+            limit=limit,
+            after=after,
+            parent_tag_ids=parent_tag_ids,
+            tag_ids=tag_ids,
+            request_options=request_options,
+        )
+        return _response.data
+
+    def get_vehicle_idling_reports(
+        self,
+        *,
+        start_time: str,
+        end_time: str,
+        after: typing.Optional[str] = None,
+        limit: typing.Optional[int] = None,
+        vehicle_ids: typing.Optional[str] = None,
+        tag_ids: typing.Optional[str] = None,
+        parent_tag_ids: typing.Optional[str] = None,
+        is_pto_active: typing.Optional[bool] = None,
+        min_idling_duration_minutes: typing.Optional[int] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> IdlingReportsGetVehicleIdlingReportsResponseBody:
+        """
+        **Note: This is a legacy endpoint, consider using [this endpoint](https://developers.samsara.com/reference/getidlingevents) instead. The endpoint will continue to function as documented.** Get all vehicle idling reports for the requested time duration.
+
+         <b>Rate limit:</b> 25 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 Fuel & Energy** under the Fuel & Energy 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
+        ----------
+        start_time : str
+             A start time in RFC 3339 format. Defaults to now if not provided. Millisecond precision and timezones are supported. Note that the most recent 72 hours of data may still be processing and is subject to change and latency, so it is not recommended to request data for the most recent 72 hours. (Examples: 2019-06-13T19:08:25Z, 2019-06-13T19:08:25.455Z, OR 2015-09-15T14:00:12-04:00).
+
+        end_time : str
+             An end time in RFC 3339 format. Defaults to now if not provided. Millisecond precision and timezones are supported. Note that the most recent 72 hours of data may still be processing and is subject to change and latency, so it is not recommended to request data for the most recent 72 hours. (Examples: 2019-06-13T19:08:25Z, 2019-06-13T19:08:25.455Z, OR 2015-09-15T14:00:12-04:00).
+
+        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.
+
+        limit : typing.Optional[int]
+            The limit for how many objects will be in the response. Default and max for this value is 512 objects.
+
+        vehicle_ids : typing.Optional[str]
+             A filter on the data based on this comma-separated list of vehicle IDs and externalIds. Example: `vehicleIds=1234,5678,samsara.vin:1HGBH41JXMN109186`
+
+        tag_ids : typing.Optional[str]
+             A filter on the data based on this comma-separated list of tag IDs. Example: `tagIds=1234,5678`
+
+        parent_tag_ids : typing.Optional[str]
+             A filter on the data based on this comma-separated list of parent tag IDs, for use by orgs with tag hierarchies. Specifying a parent tag will implicitly include all descendent tags of the parent tag. Example: `parentTagIds=345,678`
+
+        is_pto_active : typing.Optional[bool]
+            A filter on the data based on power take-off being active or inactive.
+
+        min_idling_duration_minutes : typing.Optional[int]
+            A filter on the data based on a minimum idling duration.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        IdlingReportsGetVehicleIdlingReportsResponseBody
+            OK response.
+
+        Examples
+        --------
+        from samsara import Samsara
+
+        client = Samsara(
+            token="YOUR_TOKEN",
+        )
+        client.legacy_ap_is.get_vehicle_idling_reports(
+            after="after",
+            limit=1,
+            start_time="startTime",
+            end_time="endTime",
+            vehicle_ids="vehicleIds",
+            tag_ids="tagIds",
+            parent_tag_ids="parentTagIds",
+            is_pto_active=True,
+            min_idling_duration_minutes=1,
+        )
+        """
+        _response = self._raw_client.get_vehicle_idling_reports(
+            start_time=start_time,
+            end_time=end_time,
+            after=after,
+            limit=limit,
+            vehicle_ids=vehicle_ids,
+            tag_ids=tag_ids,
+            parent_tag_ids=parent_tag_ids,
+            is_pto_active=is_pto_active,
+            min_idling_duration_minutes=min_idling_duration_minutes,
+            request_options=request_options,
+        )
+        return _response.data
+
+    def get_vehicles_driver_assignments(
+        self,
+        *,
+        start_time: typing.Optional[str] = None,
+        end_time: typing.Optional[str] = None,
+        vehicle_ids: typing.Optional[str] = None,
+        tag_ids: typing.Optional[str] = None,
+        parent_tag_ids: typing.Optional[str] = None,
+        after: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> VehiclesDriverAssignmentsGetVehiclesDriverAssignmentsResponseBody:
+        """
+        **Note: This is a legacy endpoint, consider using [this endpoint](https://developers.samsara.com/reference/getdrivervehicleassignments) instead. The endpoint will continue to function as documented.** Get all driver assignments for the requested vehicles in the requested time range. The only type of assignment supported right now are assignments created through the driver app.
+
+         <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 Assignments** under the Assignments 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
+        ----------
+        start_time : typing.Optional[str]
+             A start time in RFC 3339 format. Defaults to now if not provided. Millisecond precision and timezones are supported. (Examples: 2019-06-13T19:08:25Z, 2019-06-13T19:08:25.455Z, OR 2015-09-15T14:00:12-04:00). The maximum allowed startTime-endTime range is 7 days.
+
+        end_time : typing.Optional[str]
+             An end time in RFC 3339 format. Defaults to now if not provided. Millisecond precision and timezones are supported. (Examples: 2019-06-13T19:08:25Z, 2019-06-13T19:08:25.455Z, OR 2015-09-15T14:00:12-04:00). The maximum allowed startTime-endTime range is 7 days.
+
+        vehicle_ids : typing.Optional[str]
+             A filter on the data based on this comma-separated list of vehicle IDs and externalIds. Example: `vehicleIds=1234,5678,samsara.vin:1HGBH41JXMN109186`
+
+        tag_ids : typing.Optional[str]
+             A filter on the data based on this comma-separated list of tag IDs. Example: `tagIds=1234,5678`
+
+        parent_tag_ids : typing.Optional[str]
+             A filter on the data based on this comma-separated list of parent tag IDs, for use by orgs with tag hierarchies. Specifying a parent tag will implicitly include all descendent tags of the parent tag. Example: `parentTagIds=345,678`
+
+        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
+        -------
+        VehiclesDriverAssignmentsGetVehiclesDriverAssignmentsResponseBody
+            OK response.
+
+        Examples
+        --------
+        from samsara import Samsara
+
+        client = Samsara(
+            token="YOUR_TOKEN",
+        )
+        client.legacy_ap_is.get_vehicles_driver_assignments(
+            start_time="startTime",
+            end_time="endTime",
+            vehicle_ids="vehicleIds",
+            tag_ids="tagIds",
+            parent_tag_ids="parentTagIds",
+            after="after",
+        )
+        """
+        _response = self._raw_client.get_vehicles_driver_assignments(
+            start_time=start_time,
+            end_time=end_time,
+            vehicle_ids=vehicle_ids,
+            tag_ids=tag_ids,
+            parent_tag_ids=parent_tag_ids,
+            after=after,
+            request_options=request_options,
+        )
+        return _response.data
+
+
+class AsyncLegacyApIsClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._raw_client = AsyncRawLegacyApIsClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> AsyncRawLegacyApIsClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        AsyncRawLegacyApIsClient
+        """
+        return self._raw_client
+
+    async def get_dvir_defects(
+        self,
+        *,
+        start_time: str,
+        end_time: str,
+        limit: typing.Optional[int] = None,
+        after: typing.Optional[str] = None,
+        is_resolved: typing.Optional[bool] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> DefectsResponse:
+        """
+        **Note: This is a legacy endpoint, consider using [this endpoint](https://developers.samsara.com/reference/streamdefects) instead. The endpoint will continue to function as documented.**
+
+        Returns a list of DVIR defects in an organization, filtered by creation time. The maximum time period you can query for is 30 days.
+
+         **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.
+
+        To use this endpoint, select **Read Defects** under the Maintenance 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>
+
+        Parameters
+        ----------
+        start_time : str
+            A start time in RFC 3339 format. Millisecond precision and timezones are supported. (Examples: 2019-06-13T19:08:25Z, 2019-06-13T19:08:25.455Z, OR 2015-09-15T14:00:12-04:00). *The maximum time period you can query for is 30 days.*
+
+        end_time : str
+            An end time in RFC 3339 format. Millisecond precision and timezones are supported. (Examples: 2019-06-13T19:08:25Z, 2019-06-13T19:08:25.455Z, OR 2015-09-15T14:00:12-04:00). *The maximum time period you can query for is 30 days.*
+
+        limit : typing.Optional[int]
+            The limit for how many objects will be in the response. Default and max for this value is 512 objects.
+
+        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.
+
+        is_resolved : typing.Optional[bool]
+            A filter on the data based on resolution status. Example: `isResolved=true`
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        DefectsResponse
+            List of all DVIR defects in the organization
+
+        Examples
+        --------
+        import asyncio
+
+        from samsara import AsyncSamsara
+
+        client = AsyncSamsara(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.legacy_ap_is.get_dvir_defects(
+                limit=1000000,
+                after="after",
+                start_time="startTime",
+                end_time="endTime",
+                is_resolved=True,
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.get_dvir_defects(
+            start_time=start_time,
+            end_time=end_time,
+            limit=limit,
+            after=after,
+            is_resolved=is_resolved,
+            request_options=request_options,
+        )
+        return _response.data
+
+    async def get_drivers_vehicle_assignments(
+        self,
+        *,
+        driver_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        start_time: typing.Optional[str] = None,
+        end_time: typing.Optional[str] = None,
+        tag_ids: typing.Optional[str] = None,
+        parent_tag_ids: typing.Optional[str] = None,
+        driver_activation_status: typing.Optional[GetDriversVehicleAssignmentsRequestDriverActivationStatus] = None,
+        after: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> DriversVehicleAssignmentsGetDriversVehicleAssignmentsResponseBody:
+        """
+        **Note: This is a legacy endpoint, consider using [this endpoint](https://developers.samsara.com/reference/getdrivervehicleassignments) instead. The endpoint will continue to function as documented.** Get all vehicle assignments for the requested drivers in the requested time range. The only type of assignment supported right now are assignments created through the driver app.
+
+         <b>Rate limit:</b> 25 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 Assignments** under the Assignments 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
+        ----------
+        driver_ids : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+             A filter on the data based on this comma-separated list of driver IDs and externalIds. Example: `driverIds=1234,5678,payroll:4841`
+
+        start_time : typing.Optional[str]
+             A start time in RFC 3339 format. Defaults to now if not provided. Millisecond precision and timezones are supported. (Examples: 2019-06-13T19:08:25Z, 2019-06-13T19:08:25.455Z, OR 2015-09-15T14:00:12-04:00). The maximum allowed startTime-endTime range is 7 days.
+
+        end_time : typing.Optional[str]
+             An end time in RFC 3339 format. Defaults to now if not provided. Millisecond precision and timezones are supported. (Examples: 2019-06-13T19:08:25Z, 2019-06-13T19:08:25.455Z, OR 2015-09-15T14:00:12-04:00). The maximum allowed startTime-endTime range is 7 days.
+
+        tag_ids : typing.Optional[str]
+             A filter on the data based on this comma-separated list of driver tag IDs. Example: `tagIds=1234,5678`
+
+        parent_tag_ids : typing.Optional[str]
+             A filter on the data based on this comma-separated list of driver parent tag IDs, for use by orgs with tag hierarchies. Specifying a parent tag will implicitly include all descendent tags of the parent tag. Example: `parentTagIds=345,678`
+
+        driver_activation_status : typing.Optional[GetDriversVehicleAssignmentsRequestDriverActivationStatus]
+            If value is `deactivated`, only drivers that are deactivated will appear in the response. This parameter will default to `active` if not provided (fetching only active drivers).  Valid values: `active`, `deactivated`
+
+        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
+        -------
+        DriversVehicleAssignmentsGetDriversVehicleAssignmentsResponseBody
+            OK response.
+
+        Examples
+        --------
+        import asyncio
+
+        from samsara import AsyncSamsara
+
+        client = AsyncSamsara(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.legacy_ap_is.get_drivers_vehicle_assignments(
+                start_time="startTime",
+                end_time="endTime",
+                tag_ids="tagIds",
+                parent_tag_ids="parentTagIds",
+                driver_activation_status="active",
+                after="after",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.get_drivers_vehicle_assignments(
+            driver_ids=driver_ids,
+            start_time=start_time,
+            end_time=end_time,
+            tag_ids=tag_ids,
+            parent_tag_ids=parent_tag_ids,
+            driver_activation_status=driver_activation_status,
+            after=after,
+            request_options=request_options,
+        )
+        return _response.data
+
+    async def get_dvir_history(
+        self,
+        *,
+        start_time: str,
+        end_time: str,
+        limit: typing.Optional[int] = None,
+        after: typing.Optional[str] = None,
+        parent_tag_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        tag_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> DvirsListResponse:
+        """
+        **Note: This is a legacy endpoint, consider using [this endpoint](https://developers.samsara.com/reference/getdvirs) instead. The endpoint will continue to function as documented.**
+
+         Returns a list of all DVIRs in an organization.
+
+         **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.
+
+        To use this endpoint, select **Read DVIRs** under the Maintenance 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>
+
+        Parameters
+        ----------
+        start_time : str
+            A start time in RFC 3339 format. Millisecond precision and timezones are supported. (Examples: 2019-06-13T19:08:25Z, 2019-06-13T19:08:25.455Z, OR 2015-09-15T14:00:12-04:00).
+
+        end_time : str
+            An end time in RFC 3339 format. Millisecond precision and timezones are supported. (Examples: 2019-06-13T19:08:25Z, 2019-06-13T19:08:25.455Z, OR 2015-09-15T14:00:12-04:00).
+
+        limit : typing.Optional[int]
+            The limit for how many objects will be in the response. Default and max for this value is 512 objects.
+
+        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.
+
+        parent_tag_ids : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            A filter on the data based on this comma-separated list of parent tag IDs, for use by orgs with tag hierarchies. Specifying a parent tag will implicitly include all descendent tags of the parent tag. Example: `parentTagIds=345,678`
+
+        tag_ids : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            A filter on the data based on this comma-separated list of tag IDs. Example: `tagIds=1234,5678`
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        DvirsListResponse
+            List of all DVIRs in the organization
+
+        Examples
+        --------
+        import asyncio
+
+        from samsara import AsyncSamsara
+
+        client = AsyncSamsara(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.legacy_ap_is.get_dvir_history(
+                limit=1000000,
+                after="after",
+                start_time="startTime",
+                end_time="endTime",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.get_dvir_history(
+            start_time=start_time,
+            end_time=end_time,
+            limit=limit,
+            after=after,
+            parent_tag_ids=parent_tag_ids,
+            tag_ids=tag_ids,
+            request_options=request_options,
+        )
+        return _response.data
+
+    async def get_vehicle_idling_reports(
+        self,
+        *,
+        start_time: str,
+        end_time: str,
+        after: typing.Optional[str] = None,
+        limit: typing.Optional[int] = None,
+        vehicle_ids: typing.Optional[str] = None,
+        tag_ids: typing.Optional[str] = None,
+        parent_tag_ids: typing.Optional[str] = None,
+        is_pto_active: typing.Optional[bool] = None,
+        min_idling_duration_minutes: typing.Optional[int] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> IdlingReportsGetVehicleIdlingReportsResponseBody:
+        """
+        **Note: This is a legacy endpoint, consider using [this endpoint](https://developers.samsara.com/reference/getidlingevents) instead. The endpoint will continue to function as documented.** Get all vehicle idling reports for the requested time duration.
+
+         <b>Rate limit:</b> 25 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 Fuel & Energy** under the Fuel & Energy 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
+        ----------
+        start_time : str
+             A start time in RFC 3339 format. Defaults to now if not provided. Millisecond precision and timezones are supported. Note that the most recent 72 hours of data may still be processing and is subject to change and latency, so it is not recommended to request data for the most recent 72 hours. (Examples: 2019-06-13T19:08:25Z, 2019-06-13T19:08:25.455Z, OR 2015-09-15T14:00:12-04:00).
+
+        end_time : str
+             An end time in RFC 3339 format. Defaults to now if not provided. Millisecond precision and timezones are supported. Note that the most recent 72 hours of data may still be processing and is subject to change and latency, so it is not recommended to request data for the most recent 72 hours. (Examples: 2019-06-13T19:08:25Z, 2019-06-13T19:08:25.455Z, OR 2015-09-15T14:00:12-04:00).
+
+        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.
+
+        limit : typing.Optional[int]
+            The limit for how many objects will be in the response. Default and max for this value is 512 objects.
+
+        vehicle_ids : typing.Optional[str]
+             A filter on the data based on this comma-separated list of vehicle IDs and externalIds. Example: `vehicleIds=1234,5678,samsara.vin:1HGBH41JXMN109186`
+
+        tag_ids : typing.Optional[str]
+             A filter on the data based on this comma-separated list of tag IDs. Example: `tagIds=1234,5678`
+
+        parent_tag_ids : typing.Optional[str]
+             A filter on the data based on this comma-separated list of parent tag IDs, for use by orgs with tag hierarchies. Specifying a parent tag will implicitly include all descendent tags of the parent tag. Example: `parentTagIds=345,678`
+
+        is_pto_active : typing.Optional[bool]
+            A filter on the data based on power take-off being active or inactive.
+
+        min_idling_duration_minutes : typing.Optional[int]
+            A filter on the data based on a minimum idling duration.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        IdlingReportsGetVehicleIdlingReportsResponseBody
+            OK response.
+
+        Examples
+        --------
+        import asyncio
+
+        from samsara import AsyncSamsara
+
+        client = AsyncSamsara(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.legacy_ap_is.get_vehicle_idling_reports(
+                after="after",
+                limit=1,
+                start_time="startTime",
+                end_time="endTime",
+                vehicle_ids="vehicleIds",
+                tag_ids="tagIds",
+                parent_tag_ids="parentTagIds",
+                is_pto_active=True,
+                min_idling_duration_minutes=1,
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.get_vehicle_idling_reports(
+            start_time=start_time,
+            end_time=end_time,
+            after=after,
+            limit=limit,
+            vehicle_ids=vehicle_ids,
+            tag_ids=tag_ids,
+            parent_tag_ids=parent_tag_ids,
+            is_pto_active=is_pto_active,
+            min_idling_duration_minutes=min_idling_duration_minutes,
+            request_options=request_options,
+        )
+        return _response.data
+
+    async def get_vehicles_driver_assignments(
+        self,
+        *,
+        start_time: typing.Optional[str] = None,
+        end_time: typing.Optional[str] = None,
+        vehicle_ids: typing.Optional[str] = None,
+        tag_ids: typing.Optional[str] = None,
+        parent_tag_ids: typing.Optional[str] = None,
+        after: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> VehiclesDriverAssignmentsGetVehiclesDriverAssignmentsResponseBody:
+        """
+        **Note: This is a legacy endpoint, consider using [this endpoint](https://developers.samsara.com/reference/getdrivervehicleassignments) instead. The endpoint will continue to function as documented.** Get all driver assignments for the requested vehicles in the requested time range. The only type of assignment supported right now are assignments created through the driver app.
+
+         <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 Assignments** under the Assignments 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
+        ----------
+        start_time : typing.Optional[str]
+             A start time in RFC 3339 format. Defaults to now if not provided. Millisecond precision and timezones are supported. (Examples: 2019-06-13T19:08:25Z, 2019-06-13T19:08:25.455Z, OR 2015-09-15T14:00:12-04:00). The maximum allowed startTime-endTime range is 7 days.
+
+        end_time : typing.Optional[str]
+             An end time in RFC 3339 format. Defaults to now if not provided. Millisecond precision and timezones are supported. (Examples: 2019-06-13T19:08:25Z, 2019-06-13T19:08:25.455Z, OR 2015-09-15T14:00:12-04:00). The maximum allowed startTime-endTime range is 7 days.
+
+        vehicle_ids : typing.Optional[str]
+             A filter on the data based on this comma-separated list of vehicle IDs and externalIds. Example: `vehicleIds=1234,5678,samsara.vin:1HGBH41JXMN109186`
+
+        tag_ids : typing.Optional[str]
+             A filter on the data based on this comma-separated list of tag IDs. Example: `tagIds=1234,5678`
+
+        parent_tag_ids : typing.Optional[str]
+             A filter on the data based on this comma-separated list of parent tag IDs, for use by orgs with tag hierarchies. Specifying a parent tag will implicitly include all descendent tags of the parent tag. Example: `parentTagIds=345,678`
+
+        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
+        -------
+        VehiclesDriverAssignmentsGetVehiclesDriverAssignmentsResponseBody
+            OK response.
+
+        Examples
+        --------
+        import asyncio
+
+        from samsara import AsyncSamsara
+
+        client = AsyncSamsara(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.legacy_ap_is.get_vehicles_driver_assignments(
+                start_time="startTime",
+                end_time="endTime",
+                vehicle_ids="vehicleIds",
+                tag_ids="tagIds",
+                parent_tag_ids="parentTagIds",
+                after="after",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.get_vehicles_driver_assignments(
+            start_time=start_time,
+            end_time=end_time,
+            vehicle_ids=vehicle_ids,
+            tag_ids=tag_ids,
+            parent_tag_ids=parent_tag_ids,
+            after=after,
+            request_options=request_options,
+        )
+        return _response.data