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

samsara/{drivers/tachograph_files → tachograph/driver}/client.py

@@ -4,26 +4,96 @@ import typing
 
 from ...core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
 from ...core.request_options import RequestOptions
+from ...types.driver_tachograph_activity_response import DriverTachographActivityResponse
 from ...types.tachograph_driver_files_response import TachographDriverFilesResponse
-from .raw_client import AsyncRawTachographFilesClient, RawTachographFilesClient
+from .raw_client import AsyncRawDriverClient, RawDriverClient
 
 
-class TachographFilesClient:
+class DriverClient:
     def __init__(self, *, client_wrapper: SyncClientWrapper):
-        self._raw_client = RawTachographFilesClient(client_wrapper=client_wrapper)
+        self._raw_client = RawDriverClient(client_wrapper=client_wrapper)
 
     @property
-    def with_raw_response(self) -> RawTachographFilesClient:
+    def with_raw_response(self) -> RawDriverClient:
         """
         Retrieves a raw implementation of this client that returns raw responses.
 
         Returns
         -------
-        RawTachographFilesClient
+        RawDriverClient
         """
         return self._raw_client
 
-    def history(
+    def activity(
+        self,
+        *,
+        start_time: str,
+        end_time: str,
+        after: typing.Optional[str] = None,
+        driver_ids: typing.Optional[typing.Union[str, typing.Sequence[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,
+    ) -> DriverTachographActivityResponse:
+        """
+        Returns all known tachograph activity for all specified drivers in the time range.
+
+         **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 Tachograph (EU)** under the Compliance 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. It can't be more than 30 days past startTime. 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).
+
+        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.
+
+        driver_ids : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            A filter on the data based on this comma-separated list of driver IDs. Example: `driverIds=1234,5678`
+
+        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
+        -------
+        DriverTachographActivityResponse
+            List of all driver tachograph activities in a specified time range.
+
+        Examples
+        --------
+        from samsara import Samsara
+
+        client = Samsara(
+            token="YOUR_TOKEN",
+        )
+        client.tachograph.driver.activity(
+            start_time="startTime",
+            end_time="endTime",
+        )
+        """
+        _response = self._raw_client.activity(
+            start_time=start_time,
+            end_time=end_time,
+            after=after,
+            driver_ids=driver_ids,
+            parent_tag_ids=parent_tag_ids,
+            tag_ids=tag_ids,
+            request_options=request_options,
+        )
+        return _response.data
+
+    def files(
         self,
         *,
         start_time: str,
@@ -78,12 +148,12 @@ class TachographFilesClient:
         client = Samsara(
             token="YOUR_TOKEN",
         )
-        client.drivers.tachograph_files.history(
+        client.tachograph.driver.files(
             start_time="startTime",
             end_time="endTime",
         )
         """
-        _response = self._raw_client.history(
+        _response = self._raw_client.files(
             start_time=start_time,
             end_time=end_time,
             after=after,
@@ -95,22 +165,99 @@ class TachographFilesClient:
         return _response.data
 
 
-class AsyncTachographFilesClient:
+class AsyncDriverClient:
     def __init__(self, *, client_wrapper: AsyncClientWrapper):
-        self._raw_client = AsyncRawTachographFilesClient(client_wrapper=client_wrapper)
+        self._raw_client = AsyncRawDriverClient(client_wrapper=client_wrapper)
 
     @property
-    def with_raw_response(self) -> AsyncRawTachographFilesClient:
+    def with_raw_response(self) -> AsyncRawDriverClient:
         """
         Retrieves a raw implementation of this client that returns raw responses.
 
         Returns
         -------
-        AsyncRawTachographFilesClient
+        AsyncRawDriverClient
         """
         return self._raw_client
 
-    async def history(
+    async def activity(
+        self,
+        *,
+        start_time: str,
+        end_time: str,
+        after: typing.Optional[str] = None,
+        driver_ids: typing.Optional[typing.Union[str, typing.Sequence[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,
+    ) -> DriverTachographActivityResponse:
+        """
+        Returns all known tachograph activity for all specified drivers in the time range.
+
+         **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 Tachograph (EU)** under the Compliance 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. It can't be more than 30 days past startTime. 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).
+
+        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.
+
+        driver_ids : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            A filter on the data based on this comma-separated list of driver IDs. Example: `driverIds=1234,5678`
+
+        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
+        -------
+        DriverTachographActivityResponse
+            List of all driver tachograph activities in a specified time range.
+
+        Examples
+        --------
+        import asyncio
+
+        from samsara import AsyncSamsara
+
+        client = AsyncSamsara(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.tachograph.driver.activity(
+                start_time="startTime",
+                end_time="endTime",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.activity(
+            start_time=start_time,
+            end_time=end_time,
+            after=after,
+            driver_ids=driver_ids,
+            parent_tag_ids=parent_tag_ids,
+            tag_ids=tag_ids,
+            request_options=request_options,
+        )
+        return _response.data
+
+    async def files(
         self,
         *,
         start_time: str,
@@ -170,7 +317,7 @@ class AsyncTachographFilesClient:
 
 
         async def main() -> None:
-            await client.drivers.tachograph_files.history(
+            await client.tachograph.driver.files(
                 start_time="startTime",
                 end_time="endTime",
             )
@@ -178,7 +325,7 @@ class AsyncTachographFilesClient:
 
         asyncio.run(main())
         """
-        _response = await self._raw_client.history(
+        _response = await self._raw_client.files(
             start_time=start_time,
             end_time=end_time,
             after=after,

samsara/{drivers/tachograph_files → tachograph/driver}/raw_client.py

@@ -8,14 +8,89 @@ from ...core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
 from ...core.http_response import AsyncHttpResponse, HttpResponse
 from ...core.pydantic_utilities import parse_obj_as
 from ...core.request_options import RequestOptions
+from ...types.driver_tachograph_activity_response import DriverTachographActivityResponse
 from ...types.tachograph_driver_files_response import TachographDriverFilesResponse
 
 
-class RawTachographFilesClient:
+class RawDriverClient:
     def __init__(self, *, client_wrapper: SyncClientWrapper):
         self._client_wrapper = client_wrapper
 
-    def history(
+    def activity(
+        self,
+        *,
+        start_time: str,
+        end_time: str,
+        after: typing.Optional[str] = None,
+        driver_ids: typing.Optional[typing.Union[str, typing.Sequence[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,
+    ) -> HttpResponse[DriverTachographActivityResponse]:
+        """
+        Returns all known tachograph activity for all specified drivers in the time range.
+
+         **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 Tachograph (EU)** under the Compliance 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. It can't be more than 30 days past startTime. 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).
+
+        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.
+
+        driver_ids : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            A filter on the data based on this comma-separated list of driver IDs. Example: `driverIds=1234,5678`
+
+        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
+        -------
+        HttpResponse[DriverTachographActivityResponse]
+            List of all driver tachograph activities in a specified time range.
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "fleet/drivers/tachograph-activity/history",
+            method="GET",
+            params={
+                "after": after,
+                "startTime": start_time,
+                "endTime": end_time,
+                "driverIds": driver_ids,
+                "parentTagIds": parent_tag_ids,
+                "tagIds": tag_ids,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    DriverTachographActivityResponse,
+                    parse_obj_as(
+                        type_=DriverTachographActivityResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    def files(
         self,
         *,
         start_time: str,
@@ -92,11 +167,85 @@ class RawTachographFilesClient:
         raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
 
 
-class AsyncRawTachographFilesClient:
+class AsyncRawDriverClient:
     def __init__(self, *, client_wrapper: AsyncClientWrapper):
         self._client_wrapper = client_wrapper
 
-    async def history(
+    async def activity(
+        self,
+        *,
+        start_time: str,
+        end_time: str,
+        after: typing.Optional[str] = None,
+        driver_ids: typing.Optional[typing.Union[str, typing.Sequence[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,
+    ) -> AsyncHttpResponse[DriverTachographActivityResponse]:
+        """
+        Returns all known tachograph activity for all specified drivers in the time range.
+
+         **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 Tachograph (EU)** under the Compliance 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. It can't be more than 30 days past startTime. 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).
+
+        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.
+
+        driver_ids : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            A filter on the data based on this comma-separated list of driver IDs. Example: `driverIds=1234,5678`
+
+        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
+        -------
+        AsyncHttpResponse[DriverTachographActivityResponse]
+            List of all driver tachograph activities in a specified time range.
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "fleet/drivers/tachograph-activity/history",
+            method="GET",
+            params={
+                "after": after,
+                "startTime": start_time,
+                "endTime": end_time,
+                "driverIds": driver_ids,
+                "parentTagIds": parent_tag_ids,
+                "tagIds": tag_ids,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    DriverTachographActivityResponse,
+                    parse_obj_as(
+                        type_=DriverTachographActivityResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    async def files(
         self,
         *,
         start_time: str,

samsara/tachograph/raw_client.py

@@ -0,0 +1,13 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+
+
+class RawTachographClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+
+class AsyncRawTachographClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._client_wrapper = client_wrapper

samsara/{vehicles/tachograph_files → tachograph/vehicles}/client.py

@@ -5,25 +5,25 @@ import typing
 from ...core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
 from ...core.request_options import RequestOptions
 from ...types.tachograph_vehicle_files_response import TachographVehicleFilesResponse
-from .raw_client import AsyncRawTachographFilesClient, RawTachographFilesClient
+from .raw_client import AsyncRawVehiclesClient, RawVehiclesClient
 
 
-class TachographFilesClient:
+class VehiclesClient:
     def __init__(self, *, client_wrapper: SyncClientWrapper):
-        self._raw_client = RawTachographFilesClient(client_wrapper=client_wrapper)
+        self._raw_client = RawVehiclesClient(client_wrapper=client_wrapper)
 
     @property
-    def with_raw_response(self) -> RawTachographFilesClient:
+    def with_raw_response(self) -> RawVehiclesClient:
         """
         Retrieves a raw implementation of this client that returns raw responses.
 
         Returns
         -------
-        RawTachographFilesClient
+        RawVehiclesClient
         """
         return self._raw_client
 
-    def history(
+    def files(
         self,
         *,
         start_time: str,
@@ -78,12 +78,12 @@ class TachographFilesClient:
         client = Samsara(
             token="YOUR_TOKEN",
         )
-        client.vehicles.tachograph_files.history(
+        client.tachograph.vehicles.files(
             start_time="startTime",
             end_time="endTime",
         )
         """
-        _response = self._raw_client.history(
+        _response = self._raw_client.files(
             start_time=start_time,
             end_time=end_time,
             after=after,
@@ -95,22 +95,22 @@ class TachographFilesClient:
         return _response.data
 
 
-class AsyncTachographFilesClient:
+class AsyncVehiclesClient:
     def __init__(self, *, client_wrapper: AsyncClientWrapper):
-        self._raw_client = AsyncRawTachographFilesClient(client_wrapper=client_wrapper)
+        self._raw_client = AsyncRawVehiclesClient(client_wrapper=client_wrapper)
 
     @property
-    def with_raw_response(self) -> AsyncRawTachographFilesClient:
+    def with_raw_response(self) -> AsyncRawVehiclesClient:
         """
         Retrieves a raw implementation of this client that returns raw responses.
 
         Returns
         -------
-        AsyncRawTachographFilesClient
+        AsyncRawVehiclesClient
         """
         return self._raw_client
 
-    async def history(
+    async def files(
         self,
         *,
         start_time: str,
@@ -170,7 +170,7 @@ class AsyncTachographFilesClient:
 
 
         async def main() -> None:
-            await client.vehicles.tachograph_files.history(
+            await client.tachograph.vehicles.files(
                 start_time="startTime",
                 end_time="endTime",
             )
@@ -178,7 +178,7 @@ class AsyncTachographFilesClient:
 
         asyncio.run(main())
         """
-        _response = await self._raw_client.history(
+        _response = await self._raw_client.files(
             start_time=start_time,
             end_time=end_time,
             after=after,

samsara/{vehicles/tachograph_files → tachograph/vehicles}/raw_client.py

@@ -11,11 +11,11 @@ from ...core.request_options import RequestOptions
 from ...types.tachograph_vehicle_files_response import TachographVehicleFilesResponse
 
 
-class RawTachographFilesClient:
+class RawVehiclesClient:
     def __init__(self, *, client_wrapper: SyncClientWrapper):
         self._client_wrapper = client_wrapper
 
-    def history(
+    def files(
         self,
         *,
         start_time: str,
@@ -92,11 +92,11 @@ class RawTachographFilesClient:
         raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
 
 
-class AsyncRawTachographFilesClient:
+class AsyncRawVehiclesClient:
     def __init__(self, *, client_wrapper: AsyncClientWrapper):
         self._client_wrapper = client_wrapper
 
-    async def history(
+    async def files(
         self,
         *,
         start_time: str,

samsara/tags/client.py

@@ -3,8 +3,9 @@
 import typing
 
 from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from ..core.pagination import AsyncPager, SyncPager
 from ..core.request_options import RequestOptions
-from ..types.list_tags_response import ListTagsResponse
+from ..types.tag import Tag
 from ..types.tag_response import TagResponse
 from ..types.tagged_object_id import TaggedObjectId
 from .raw_client import AsyncRawTagsClient, RawTagsClient
@@ -34,7 +35,7 @@ class TagsClient:
         limit: typing.Optional[int] = None,
         after: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> ListTagsResponse:
+    ) -> SyncPager[Tag]:
         """
         Return all of the tags for an organization.
 
@@ -55,7 +56,7 @@ class TagsClient:
 
         Returns
         -------
-        ListTagsResponse
+        SyncPager[Tag]
             List of tags.
 
         Examples
@@ -65,10 +66,14 @@ class TagsClient:
         client = Samsara(
             token="YOUR_TOKEN",
         )
-        client.tags.list()
+        response = client.tags.list()
+        for item in response:
+            yield item
+        # alternatively, you can paginate page-by-page
+        for page in response.iter_pages():
+            yield page
         """
-        _response = self._raw_client.list(limit=limit, after=after, request_options=request_options)
-        return _response.data
+        return self._raw_client.list(limit=limit, after=after, request_options=request_options)
 
     def create(
         self,
@@ -422,7 +427,7 @@ class AsyncTagsClient:
         limit: typing.Optional[int] = None,
         after: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> ListTagsResponse:
+    ) -> AsyncPager[Tag]:
         """
         Return all of the tags for an organization.
 
@@ -443,7 +448,7 @@ class AsyncTagsClient:
 
         Returns
         -------
-        ListTagsResponse
+        AsyncPager[Tag]
             List of tags.
 
         Examples
@@ -458,13 +463,18 @@ class AsyncTagsClient:
 
 
         async def main() -> None:
-            await client.tags.list()
+            response = await client.tags.list()
+            async for item in response:
+                yield item
+
+            # alternatively, you can paginate page-by-page
+            async for page in response.iter_pages():
+                yield page
 
 
         asyncio.run(main())
         """
-        _response = await self._raw_client.list(limit=limit, after=after, request_options=request_options)
-        return _response.data
+        return await self._raw_client.list(limit=limit, after=after, request_options=request_options)
 
     async def create(
         self,