Release 0.0.76

Author: fern-api[bot]

README.md

@@ -80,6 +80,14 @@ client = AgentMail(
 response = client.inboxes.with_raw_response.create(...)
 print(response.headers)  # access the response headers
 print(response.data)  # access the underlying object
+pager = client.inboxes.list(...)
+print(pager.response.headers)  # access the response headers for the first page
+for item in pager:
+    print(item)  # access the underlying object(s)
+for page in pager.iter_pages():
+    print(page.response.headers)  # access the response headers for each page
+    for item in page:
+        print(item)  # access the underlying object(s)
 ```
 
 ### Retries

pyproject.toml

@@ -3,7 +3,7 @@ name = "agentmail"
 
 [tool.poetry]
 name = "agentmail"
-version = "0.0.75"
+version = "0.0.76"
 description = ""
 readme = "README.md"
 authors = []

reference.md

@@ -18,7 +18,12 @@ from agentmail import AgentMail
 client = AgentMail(
     api_key="YOUR_API_KEY",
 )
-client.inboxes.list()
+response = client.inboxes.list()
+for item in response:
+    yield item
+# alternatively, you can paginate page-by-page
+for page in response.iter_pages():
+    yield page
 
 ```
 </dd>
@@ -271,7 +276,12 @@ from agentmail import AgentMail
 client = AgentMail(
     api_key="YOUR_API_KEY",
 )
-client.pods.list()
+response = client.pods.list()
+for item in response:
+    yield item
+# alternatively, you can paginate page-by-page
+for page in response.iter_pages():
+    yield page
 
 ```
 </dd>
@@ -508,7 +518,12 @@ from agentmail import AgentMail
 client = AgentMail(
     api_key="YOUR_API_KEY",
 )
-client.webhooks.list()
+response = client.webhooks.list()
+for item in response:
+    yield item
+# alternatively, you can paginate page-by-page
+for page in response.iter_pages():
+    yield page
 
 ```
 </dd>
@@ -764,7 +779,12 @@ from agentmail import AgentMail
 client = AgentMail(
     api_key="YOUR_API_KEY",
 )
-client.api_keys.list()
+response = client.api_keys.list()
+for item in response:
+    yield item
+# alternatively, you can paginate page-by-page
+for page in response.iter_pages():
+    yield page
 
 ```
 </dd>
@@ -939,7 +959,12 @@ from agentmail import AgentMail
 client = AgentMail(
     api_key="YOUR_API_KEY",
 )
-client.domains.list()
+response = client.domains.list()
+for item in response:
+    yield item
+# alternatively, you can paginate page-by-page
+for page in response.iter_pages():
+    yield page
 
 ```
 </dd>
@@ -1291,7 +1316,12 @@ from agentmail import AgentMail
 client = AgentMail(
     api_key="YOUR_API_KEY",
 )
-client.drafts.list()
+response = client.drafts.list()
+for item in response:
+    yield item
+# alternatively, you can paginate page-by-page
+for page in response.iter_pages():
+    yield page
 
 ```
 </dd>
@@ -1442,9 +1472,14 @@ from agentmail import AgentMail
 client = AgentMail(
     api_key="YOUR_API_KEY",
 )
-client.inboxes.drafts.list(
+response = client.inboxes.drafts.list(
     inbox_id="inbox_id",
 )
+for item in response:
+    yield item
+# alternatively, you can paginate page-by-page
+for page in response.iter_pages():
+    yield page
 
 ```
 </dd>
@@ -2031,9 +2066,14 @@ from agentmail import AgentMail
 client = AgentMail(
     api_key="YOUR_API_KEY",
 )
-client.inboxes.messages.list(
+response = client.inboxes.messages.list(
     inbox_id="inbox_id",
 )
+for item in response:
+    yield item
+# alternatively, you can paginate page-by-page
+for page in response.iter_pages():
+    yield page
 
 ```
 </dd>
@@ -2767,9 +2807,14 @@ from agentmail import AgentMail
 client = AgentMail(
     api_key="YOUR_API_KEY",
 )
-client.inboxes.threads.list(
+response = client.inboxes.threads.list(
     inbox_id="inbox_id",
 )
+for item in response:
+    yield item
+# alternatively, you can paginate page-by-page
+for page in response.iter_pages():
+    yield page
 
 ```
 </dd>
@@ -3156,9 +3201,14 @@ from agentmail import AgentMail
 client = AgentMail(
     api_key="YOUR_API_KEY",
 )
-client.pods.domains.list(
+response = client.pods.domains.list(
     pod_id="pod_id",
 )
+for item in response:
+    yield item
+# alternatively, you can paginate page-by-page
+for page in response.iter_pages():
+    yield page
 
 ```
 </dd>
@@ -3400,9 +3450,14 @@ from agentmail import AgentMail
 client = AgentMail(
     api_key="YOUR_API_KEY",
 )
-client.pods.drafts.list(
+response = client.pods.drafts.list(
     pod_id="pod_id",
 )
+for item in response:
+    yield item
+# alternatively, you can paginate page-by-page
+for page in response.iter_pages():
+    yield page
 
 ```
 </dd>
@@ -3570,9 +3625,14 @@ from agentmail import AgentMail
 client = AgentMail(
     api_key="YOUR_API_KEY",
 )
-client.pods.inboxes.list(
+response = client.pods.inboxes.list(
     pod_id="pod_id",
 )
+for item in response:
+    yield item
+# alternatively, you can paginate page-by-page
+for page in response.iter_pages():
+    yield page
 
 ```
 </dd>
@@ -3893,9 +3953,14 @@ from agentmail import AgentMail
 client = AgentMail(
     api_key="YOUR_API_KEY",
 )
-client.pods.threads.list(
+response = client.pods.threads.list(
     pod_id="pod_id",
 )
+for item in response:
+    yield item
+# alternatively, you can paginate page-by-page
+for page in response.iter_pages():
+    yield page
 
 ```
 </dd>
@@ -4137,7 +4202,12 @@ from agentmail import AgentMail
 client = AgentMail(
     api_key="YOUR_API_KEY",
 )
-client.threads.list()
+response = client.threads.list()
+for item in response:
+    yield item
+# alternatively, you can paginate page-by-page
+for page in response.iter_pages():
+    yield page
 
 ```
 </dd>

src/agentmail/api_keys/client.py

@@ -3,13 +3,14 @@
 import typing
 
 from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from ..core.pagination import AsyncPager, SyncPager
 from ..core.request_options import RequestOptions
 from ..types.limit import Limit
 from ..types.page_token import PageToken
 from .raw_client import AsyncRawApiKeysClient, RawApiKeysClient
+from .types.api_key import ApiKey
 from .types.api_key_id import ApiKeyId
 from .types.create_api_key_response import CreateApiKeyResponse
-from .types.list_api_keys_response import ListApiKeysResponse
 from .types.name import Name
 
 # this is used as the default value for optional parameters
@@ -37,7 +38,7 @@ def list(
         limit: typing.Optional[Limit] = None,
         page_token: typing.Optional[PageToken] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> ListApiKeysResponse:
+    ) -> SyncPager[ApiKey]:
         """
         Parameters
         ----------
@@ -50,7 +51,7 @@ def list(
 
         Returns
         -------
-        ListApiKeysResponse
+        SyncPager[ApiKey]
 
         Examples
         --------
@@ -59,10 +60,14 @@ def list(
         client = AgentMail(
             api_key="YOUR_API_KEY",
         )
-        client.api_keys.list()
+        response = client.api_keys.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, page_token=page_token, request_options=request_options)
-        return _response.data
+        return self._raw_client.list(limit=limit, page_token=page_token, request_options=request_options)
 
     def create(self, *, name: Name, request_options: typing.Optional[RequestOptions] = None) -> CreateApiKeyResponse:
         """
@@ -140,7 +145,7 @@ async def list(
         limit: typing.Optional[Limit] = None,
         page_token: typing.Optional[PageToken] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> ListApiKeysResponse:
+    ) -> AsyncPager[ApiKey]:
         """
         Parameters
         ----------
@@ -153,7 +158,7 @@ async def list(
 
         Returns
         -------
-        ListApiKeysResponse
+        AsyncPager[ApiKey]
 
         Examples
         --------
@@ -167,13 +172,18 @@ async def list(
 
 
         async def main() -> None:
-            await client.api_keys.list()
+            response = await client.api_keys.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, page_token=page_token, request_options=request_options)
-        return _response.data
+        return await self._raw_client.list(limit=limit, page_token=page_token, request_options=request_options)
 
     async def create(
         self, *, name: Name, request_options: typing.Optional[RequestOptions] = None