agentmail 2.0.4__tar.gz → 2.0.6__tar.gz

{agentmail-2.0.4 → agentmail-2.0.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: agentmail
-Version: 2.0.4
+Version: 2.0.6
 Summary: 
 License: MIT
 Requires-Python: >=3.8,<4.0

{agentmail-2.0.4 → agentmail-2.0.6}/pyproject.toml

@@ -4,7 +4,7 @@ dynamic = ["version"]
 
 [tool.poetry]
 name = "agentmail"
-version = "2.0.4"
+version = "2.0.6"
 description = ""
 readme = "README.md"
 authors = []

{agentmail-2.0.4 → agentmail-2.0.6}/src/agentmail/__init__.py

@@ -59,7 +59,14 @@ if typing.TYPE_CHECKING:
         UpdateAccountRequest,
         UpdateAccountStatus,
     )
-    from .agent import AgentSignupRequest, AgentSignupResponse, AgentVerifyRequest, AgentVerifyResponse
+    from .agent import (
+        AgentAttachHumanRequest,
+        AgentAttachHumanResponse,
+        AgentSignupRequest,
+        AgentSignupResponse,
+        AgentVerifyRequest,
+        AgentVerifyResponse,
+    )
     from .api_keys import (
         AcceptDisclosure,
         ApiKey,
@@ -303,6 +310,8 @@ _dynamic_imports: typing.Dict[str, str] = {
     "AccountStatus": ".accounts",
     "Addresses": ".messages",
     "After": ".types",
+    "AgentAttachHumanRequest": ".agent",
+    "AgentAttachHumanResponse": ".agent",
     "AgentMail": ".client",
     "AgentMailEnvironment": ".environment",
     "AgentSignupRequest": ".agent",
@@ -606,6 +615,8 @@ __all__ = [
     "AccountStatus",
     "Addresses",
     "After",
+    "AgentAttachHumanRequest",
+    "AgentAttachHumanResponse",
     "AgentMail",
     "AgentMailEnvironment",
     "AgentSignupRequest",

{agentmail-2.0.4 → agentmail-2.0.6}/src/agentmail/agent/__init__.py

@@ -6,8 +6,17 @@ import typing
 from importlib import import_module
 
 if typing.TYPE_CHECKING:
-    from .types import AgentSignupRequest, AgentSignupResponse, AgentVerifyRequest, AgentVerifyResponse
+    from .types import (
+        AgentAttachHumanRequest,
+        AgentAttachHumanResponse,
+        AgentSignupRequest,
+        AgentSignupResponse,
+        AgentVerifyRequest,
+        AgentVerifyResponse,
+    )
 _dynamic_imports: typing.Dict[str, str] = {
+    "AgentAttachHumanRequest": ".types",
+    "AgentAttachHumanResponse": ".types",
     "AgentSignupRequest": ".types",
     "AgentSignupResponse": ".types",
     "AgentVerifyRequest": ".types",
@@ -36,4 +45,11 @@ def __dir__():
     return sorted(lazy_attrs)
 
 
-__all__ = ["AgentSignupRequest", "AgentSignupResponse", "AgentVerifyRequest", "AgentVerifyResponse"]
+__all__ = [
+    "AgentAttachHumanRequest",
+    "AgentAttachHumanResponse",
+    "AgentSignupRequest",
+    "AgentSignupResponse",
+    "AgentVerifyRequest",
+    "AgentVerifyResponse",
+]

{agentmail-2.0.4 → agentmail-2.0.6}/src/agentmail/agent/client.py

@@ -5,6 +5,7 @@ import typing
 from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
 from ..core.request_options import RequestOptions
 from .raw_client import AsyncRawAgentClient, RawAgentClient
+from .types.agent_attach_human_response import AgentAttachHumanResponse
 from .types.agent_signup_response import AgentSignupResponse
 from .types.agent_verify_response import AgentVerifyResponse
 
@@ -30,8 +31,8 @@ class AgentClient:
     def sign_up(
         self,
         *,
-        human_email: str,
         username: str,
+        human_email: typing.Optional[str] = OMIT,
         source: typing.Optional[str] = OMIT,
         referrer: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
@@ -41,6 +42,8 @@ class AgentClient:
 
         A 6-digit OTP is sent to the human's email for verification.
 
+        `human_email` is optional. Without it, the inbox can receive email but cannot send to anyone until a human is attached with the attach human endpoint. There is also no way to recover the API key, so store it durably. Calling sign-up again without `human_email` creates a new organization, which needs a different `username`: the original username stays with the lost organization's inbox.
+
         This endpoint is idempotent. Calling it again with the same `human_email` will rotate the API key and resend the OTP if expired.
 
         The returned API key has limited permissions until the organization is verified via the verify endpoint.
@@ -52,12 +55,13 @@ class AgentClient:
 
         Parameters
         ----------
-        human_email : str
-            Email address of the human who owns the agent. A 6-digit OTP will be sent to this address.
-
         username : str
             Username for the auto-created inbox (e.g. "my-agent" creates my-agent@agentmail.to).
 
+        human_email : typing.Optional[str]
+            Email address of the human who owns the agent. A 6-digit OTP will be sent to this address.
+            Omit it to get a receive-only inbox: it can receive email but cannot send until a human is attached with the attach human endpoint.
+
         source : typing.Optional[str]
             The SDK, framework, or platform issuing this sign-up (e.g. `agentmail-python`, `agentmail-cli`, `agentmail-mcp`).
             Identifies the caller — answers "who is signing up".
@@ -83,26 +87,70 @@ class AgentClient:
             api_key="YOUR_API_KEY",
         )
         client.agent.sign_up(
-            human_email="human_email",
             username="username",
         )
         """
         _response = self._raw_client.sign_up(
-            human_email=human_email,
             username=username,
+            human_email=human_email,
             source=source,
             referrer=referrer,
             request_options=request_options,
         )
         return _response.data
 
+    def attach_human(
+        self, *, human_email: str, request_options: typing.Optional[RequestOptions] = None
+    ) -> AgentAttachHumanResponse:
+        """
+        Attach a human to an unverified agent organization. A 6-digit OTP is sent to the human's email, which you then submit to the verify endpoint.
+
+        Use it after signing up without a `human_email`. Once the human is attached, the organization can send email to that human only, and verification lifts the remaining restrictions. For up to 5 minutes after attaching, sends to the human can still be rejected with a `429` daily send limit error while the API key's cached limits catch up. Wait and retry.
+
+        Calling it again with the same `human_email` does not rotate the API key. It resends the OTP if it was never delivered, or issues a new one if it expired. While the current OTP is still valid, calling it again keeps that OTP and its attempt count. If all 10 attempts are used up, wait until the OTP expires, 24 hours after it was issued, then call it again for a new one.
+
+        Calling it with a different `human_email` replaces the attached human and sends the new human an OTP. An organization can replace its human at most 2 times.
+
+        Only available until the organization is verified.
+
+        **CLI:**
+        ```bash
+        agentmail agent attach-human --human-email user@example.com
+        ```
+
+        Parameters
+        ----------
+        human_email : str
+            Email address of the human who owns the agent. A 6-digit OTP will be sent to this address.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AgentAttachHumanResponse
+
+        Examples
+        --------
+        from agentmail import AgentMail
+
+        client = AgentMail(
+            api_key="YOUR_API_KEY",
+        )
+        client.agent.attach_human(
+            human_email="human_email",
+        )
+        """
+        _response = self._raw_client.attach_human(human_email=human_email, request_options=request_options)
+        return _response.data
+
     def verify(self, *, otp_code: str, request_options: typing.Optional[RequestOptions] = None) -> AgentVerifyResponse:
         """
         Verify an agent organization using the 6-digit OTP sent to the human's email during sign-up.
 
         On success, the organization is upgraded from `agent_unverified` to `agent_verified`, the send allowlist is removed, and free plan entitlements are applied.
 
-        The OTP expires after 24 hours and allows a maximum of 10 attempts. If you run into any difficulties receiving the OTP code, you can also create an account on [console.agentmail.to](https://console.agentmail.to) using the human email address you provided to verify your account.
+        The OTP expires after 24 hours and allows a maximum of 10 attempts. If the OTP expired, call the attach human endpoint with the same `human_email` to get a new one without rotating the API key. Once all 10 attempts are used, even the correct OTP is rejected, and attach human keeps returning the same OTP until it expires, so wait for it to expire before asking for a new one. An organization that signed up without a `human_email` has no OTP until a human is attached. If you run into any difficulties receiving the OTP code, you can also create an account on [console.agentmail.to](https://console.agentmail.to) using the human email address you provided to verify your account.
 
         **CLI:**
         ```bash
@@ -154,8 +202,8 @@ class AsyncAgentClient:
     async def sign_up(
         self,
         *,
-        human_email: str,
         username: str,
+        human_email: typing.Optional[str] = OMIT,
         source: typing.Optional[str] = OMIT,
         referrer: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
@@ -165,6 +213,8 @@ class AsyncAgentClient:
 
         A 6-digit OTP is sent to the human's email for verification.
 
+        `human_email` is optional. Without it, the inbox can receive email but cannot send to anyone until a human is attached with the attach human endpoint. There is also no way to recover the API key, so store it durably. Calling sign-up again without `human_email` creates a new organization, which needs a different `username`: the original username stays with the lost organization's inbox.
+
         This endpoint is idempotent. Calling it again with the same `human_email` will rotate the API key and resend the OTP if expired.
 
         The returned API key has limited permissions until the organization is verified via the verify endpoint.
@@ -176,12 +226,13 @@ class AsyncAgentClient:
 
         Parameters
         ----------
-        human_email : str
-            Email address of the human who owns the agent. A 6-digit OTP will be sent to this address.
-
         username : str
             Username for the auto-created inbox (e.g. "my-agent" creates my-agent@agentmail.to).
 
+        human_email : typing.Optional[str]
+            Email address of the human who owns the agent. A 6-digit OTP will be sent to this address.
+            Omit it to get a receive-only inbox: it can receive email but cannot send until a human is attached with the attach human endpoint.
+
         source : typing.Optional[str]
             The SDK, framework, or platform issuing this sign-up (e.g. `agentmail-python`, `agentmail-cli`, `agentmail-mcp`).
             Identifies the caller — answers "who is signing up".
@@ -212,7 +263,6 @@ class AsyncAgentClient:
 
         async def main() -> None:
             await client.agent.sign_up(
-                human_email="human_email",
                 username="username",
             )
 
@@ -220,14 +270,67 @@ class AsyncAgentClient:
         asyncio.run(main())
         """
         _response = await self._raw_client.sign_up(
-            human_email=human_email,
             username=username,
+            human_email=human_email,
             source=source,
             referrer=referrer,
             request_options=request_options,
         )
         return _response.data
 
+    async def attach_human(
+        self, *, human_email: str, request_options: typing.Optional[RequestOptions] = None
+    ) -> AgentAttachHumanResponse:
+        """
+        Attach a human to an unverified agent organization. A 6-digit OTP is sent to the human's email, which you then submit to the verify endpoint.
+
+        Use it after signing up without a `human_email`. Once the human is attached, the organization can send email to that human only, and verification lifts the remaining restrictions. For up to 5 minutes after attaching, sends to the human can still be rejected with a `429` daily send limit error while the API key's cached limits catch up. Wait and retry.
+
+        Calling it again with the same `human_email` does not rotate the API key. It resends the OTP if it was never delivered, or issues a new one if it expired. While the current OTP is still valid, calling it again keeps that OTP and its attempt count. If all 10 attempts are used up, wait until the OTP expires, 24 hours after it was issued, then call it again for a new one.
+
+        Calling it with a different `human_email` replaces the attached human and sends the new human an OTP. An organization can replace its human at most 2 times.
+
+        Only available until the organization is verified.
+
+        **CLI:**
+        ```bash
+        agentmail agent attach-human --human-email user@example.com
+        ```
+
+        Parameters
+        ----------
+        human_email : str
+            Email address of the human who owns the agent. A 6-digit OTP will be sent to this address.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AgentAttachHumanResponse
+
+        Examples
+        --------
+        import asyncio
+
+        from agentmail import AsyncAgentMail
+
+        client = AsyncAgentMail(
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            await client.agent.attach_human(
+                human_email="human_email",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.attach_human(human_email=human_email, request_options=request_options)
+        return _response.data
+
     async def verify(
         self, *, otp_code: str, request_options: typing.Optional[RequestOptions] = None
     ) -> AgentVerifyResponse:
@@ -236,7 +339,7 @@ class AsyncAgentClient:
 
         On success, the organization is upgraded from `agent_unverified` to `agent_verified`, the send allowlist is removed, and free plan entitlements are applied.
 
-        The OTP expires after 24 hours and allows a maximum of 10 attempts. If you run into any difficulties receiving the OTP code, you can also create an account on [console.agentmail.to](https://console.agentmail.to) using the human email address you provided to verify your account.
+        The OTP expires after 24 hours and allows a maximum of 10 attempts. If the OTP expired, call the attach human endpoint with the same `human_email` to get a new one without rotating the API key. Once all 10 attempts are used, even the correct OTP is rejected, and attach human keeps returning the same OTP until it expires, so wait for it to expire before asking for a new one. An organization that signed up without a `human_email` has no OTP until a human is attached. If you run into any difficulties receiving the OTP code, you can also create an account on [console.agentmail.to](https://console.agentmail.to) using the human email address you provided to verify your account.
 
         **CLI:**
         ```bash

{agentmail-2.0.4 → agentmail-2.0.6}/src/agentmail/agent/raw_client.py

@@ -9,8 +9,11 @@ from ..core.http_response import AsyncHttpResponse, HttpResponse
 from ..core.parse_error import ParsingError
 from ..core.request_options import RequestOptions
 from ..core.unchecked_base_model import construct_type
+from ..errors.conflict_error import ConflictError
 from ..errors.validation_error import ValidationError as errors_validation_error_ValidationError
+from ..types.error_response import ErrorResponse
 from ..types.validation_error_response import ValidationErrorResponse
+from .types.agent_attach_human_response import AgentAttachHumanResponse
 from .types.agent_signup_response import AgentSignupResponse
 from .types.agent_verify_response import AgentVerifyResponse
 from pydantic import ValidationError as pydantic_ValidationError
@@ -26,8 +29,8 @@ class RawAgentClient:
     def sign_up(
         self,
         *,
-        human_email: str,
         username: str,
+        human_email: typing.Optional[str] = OMIT,
         source: typing.Optional[str] = OMIT,
         referrer: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
@@ -37,6 +40,8 @@ class RawAgentClient:
 
         A 6-digit OTP is sent to the human's email for verification.
 
+        `human_email` is optional. Without it, the inbox can receive email but cannot send to anyone until a human is attached with the attach human endpoint. There is also no way to recover the API key, so store it durably. Calling sign-up again without `human_email` creates a new organization, which needs a different `username`: the original username stays with the lost organization's inbox.
+
         This endpoint is idempotent. Calling it again with the same `human_email` will rotate the API key and resend the OTP if expired.
 
         The returned API key has limited permissions until the organization is verified via the verify endpoint.
@@ -48,12 +53,13 @@ class RawAgentClient:
 
         Parameters
         ----------
-        human_email : str
-            Email address of the human who owns the agent. A 6-digit OTP will be sent to this address.
-
         username : str
             Username for the auto-created inbox (e.g. "my-agent" creates my-agent@agentmail.to).
 
+        human_email : typing.Optional[str]
+            Email address of the human who owns the agent. A 6-digit OTP will be sent to this address.
+            Omit it to get a receive-only inbox: it can receive email but cannot send until a human is attached with the attach human endpoint.
+
         source : typing.Optional[str]
             The SDK, framework, or platform issuing this sign-up (e.g. `agentmail-python`, `agentmail-cli`, `agentmail-mcp`).
             Identifies the caller — answers "who is signing up".
@@ -114,6 +120,88 @@ class RawAgentClient:
             )
         raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
 
+    def attach_human(
+        self, *, human_email: str, request_options: typing.Optional[RequestOptions] = None
+    ) -> HttpResponse[AgentAttachHumanResponse]:
+        """
+        Attach a human to an unverified agent organization. A 6-digit OTP is sent to the human's email, which you then submit to the verify endpoint.
+
+        Use it after signing up without a `human_email`. Once the human is attached, the organization can send email to that human only, and verification lifts the remaining restrictions. For up to 5 minutes after attaching, sends to the human can still be rejected with a `429` daily send limit error while the API key's cached limits catch up. Wait and retry.
+
+        Calling it again with the same `human_email` does not rotate the API key. It resends the OTP if it was never delivered, or issues a new one if it expired. While the current OTP is still valid, calling it again keeps that OTP and its attempt count. If all 10 attempts are used up, wait until the OTP expires, 24 hours after it was issued, then call it again for a new one.
+
+        Calling it with a different `human_email` replaces the attached human and sends the new human an OTP. An organization can replace its human at most 2 times.
+
+        Only available until the organization is verified.
+
+        **CLI:**
+        ```bash
+        agentmail agent attach-human --human-email user@example.com
+        ```
+
+        Parameters
+        ----------
+        human_email : str
+            Email address of the human who owns the agent. A 6-digit OTP will be sent to this address.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[AgentAttachHumanResponse]
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "v0/agent/human",
+            base_url=self._client_wrapper.get_environment().http,
+            method="POST",
+            json={
+                "human_email": human_email,
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    AgentAttachHumanResponse,
+                    construct_type(
+                        type_=AgentAttachHumanResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise errors_validation_error_ValidationError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ValidationErrorResponse,
+                        construct_type(
+                            type_=ValidationErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 409:
+                raise ConflictError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        construct_type(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except pydantic_ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
     def verify(
         self, *, otp_code: str, request_options: typing.Optional[RequestOptions] = None
     ) -> HttpResponse[AgentVerifyResponse]:
@@ -122,7 +210,7 @@ class RawAgentClient:
 
         On success, the organization is upgraded from `agent_unverified` to `agent_verified`, the send allowlist is removed, and free plan entitlements are applied.
 
-        The OTP expires after 24 hours and allows a maximum of 10 attempts. If you run into any difficulties receiving the OTP code, you can also create an account on [console.agentmail.to](https://console.agentmail.to) using the human email address you provided to verify your account.
+        The OTP expires after 24 hours and allows a maximum of 10 attempts. If the OTP expired, call the attach human endpoint with the same `human_email` to get a new one without rotating the API key. Once all 10 attempts are used, even the correct OTP is rejected, and attach human keeps returning the same OTP until it expires, so wait for it to expire before asking for a new one. An organization that signed up without a `human_email` has no OTP until a human is attached. If you run into any difficulties receiving the OTP code, you can also create an account on [console.agentmail.to](https://console.agentmail.to) using the human email address you provided to verify your account.
 
         **CLI:**
         ```bash
@@ -178,8 +266,8 @@ class AsyncRawAgentClient:
     async def sign_up(
         self,
         *,
-        human_email: str,
         username: str,
+        human_email: typing.Optional[str] = OMIT,
         source: typing.Optional[str] = OMIT,
         referrer: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
@@ -189,6 +277,8 @@ class AsyncRawAgentClient:
 
         A 6-digit OTP is sent to the human's email for verification.
 
+        `human_email` is optional. Without it, the inbox can receive email but cannot send to anyone until a human is attached with the attach human endpoint. There is also no way to recover the API key, so store it durably. Calling sign-up again without `human_email` creates a new organization, which needs a different `username`: the original username stays with the lost organization's inbox.
+
         This endpoint is idempotent. Calling it again with the same `human_email` will rotate the API key and resend the OTP if expired.
 
         The returned API key has limited permissions until the organization is verified via the verify endpoint.
@@ -200,12 +290,13 @@ class AsyncRawAgentClient:
 
         Parameters
         ----------
-        human_email : str
-            Email address of the human who owns the agent. A 6-digit OTP will be sent to this address.
-
         username : str
             Username for the auto-created inbox (e.g. "my-agent" creates my-agent@agentmail.to).
 
+        human_email : typing.Optional[str]
+            Email address of the human who owns the agent. A 6-digit OTP will be sent to this address.
+            Omit it to get a receive-only inbox: it can receive email but cannot send until a human is attached with the attach human endpoint.
+
         source : typing.Optional[str]
             The SDK, framework, or platform issuing this sign-up (e.g. `agentmail-python`, `agentmail-cli`, `agentmail-mcp`).
             Identifies the caller — answers "who is signing up".
@@ -266,6 +357,88 @@ class AsyncRawAgentClient:
             )
         raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
 
+    async def attach_human(
+        self, *, human_email: str, request_options: typing.Optional[RequestOptions] = None
+    ) -> AsyncHttpResponse[AgentAttachHumanResponse]:
+        """
+        Attach a human to an unverified agent organization. A 6-digit OTP is sent to the human's email, which you then submit to the verify endpoint.
+
+        Use it after signing up without a `human_email`. Once the human is attached, the organization can send email to that human only, and verification lifts the remaining restrictions. For up to 5 minutes after attaching, sends to the human can still be rejected with a `429` daily send limit error while the API key's cached limits catch up. Wait and retry.
+
+        Calling it again with the same `human_email` does not rotate the API key. It resends the OTP if it was never delivered, or issues a new one if it expired. While the current OTP is still valid, calling it again keeps that OTP and its attempt count. If all 10 attempts are used up, wait until the OTP expires, 24 hours after it was issued, then call it again for a new one.
+
+        Calling it with a different `human_email` replaces the attached human and sends the new human an OTP. An organization can replace its human at most 2 times.
+
+        Only available until the organization is verified.
+
+        **CLI:**
+        ```bash
+        agentmail agent attach-human --human-email user@example.com
+        ```
+
+        Parameters
+        ----------
+        human_email : str
+            Email address of the human who owns the agent. A 6-digit OTP will be sent to this address.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[AgentAttachHumanResponse]
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "v0/agent/human",
+            base_url=self._client_wrapper.get_environment().http,
+            method="POST",
+            json={
+                "human_email": human_email,
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    AgentAttachHumanResponse,
+                    construct_type(
+                        type_=AgentAttachHumanResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise errors_validation_error_ValidationError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ValidationErrorResponse,
+                        construct_type(
+                            type_=ValidationErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 409:
+                raise ConflictError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        construct_type(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except pydantic_ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
     async def verify(
         self, *, otp_code: str, request_options: typing.Optional[RequestOptions] = None
     ) -> AsyncHttpResponse[AgentVerifyResponse]:
@@ -274,7 +447,7 @@ class AsyncRawAgentClient:
 
         On success, the organization is upgraded from `agent_unverified` to `agent_verified`, the send allowlist is removed, and free plan entitlements are applied.
 
-        The OTP expires after 24 hours and allows a maximum of 10 attempts. If you run into any difficulties receiving the OTP code, you can also create an account on [console.agentmail.to](https://console.agentmail.to) using the human email address you provided to verify your account.
+        The OTP expires after 24 hours and allows a maximum of 10 attempts. If the OTP expired, call the attach human endpoint with the same `human_email` to get a new one without rotating the API key. Once all 10 attempts are used, even the correct OTP is rejected, and attach human keeps returning the same OTP until it expires, so wait for it to expire before asking for a new one. An organization that signed up without a `human_email` has no OTP until a human is attached. If you run into any difficulties receiving the OTP code, you can also create an account on [console.agentmail.to](https://console.agentmail.to) using the human email address you provided to verify your account.
 
         **CLI:**
         ```bash

{agentmail-2.0.4 → agentmail-2.0.6}/src/agentmail/agent/types/__init__.py

@@ -6,11 +6,15 @@ import typing
 from importlib import import_module
 
 if typing.TYPE_CHECKING:
+    from .agent_attach_human_request import AgentAttachHumanRequest
+    from .agent_attach_human_response import AgentAttachHumanResponse
     from .agent_signup_request import AgentSignupRequest
     from .agent_signup_response import AgentSignupResponse
     from .agent_verify_request import AgentVerifyRequest
     from .agent_verify_response import AgentVerifyResponse
 _dynamic_imports: typing.Dict[str, str] = {
+    "AgentAttachHumanRequest": ".agent_attach_human_request",
+    "AgentAttachHumanResponse": ".agent_attach_human_response",
     "AgentSignupRequest": ".agent_signup_request",
     "AgentSignupResponse": ".agent_signup_response",
     "AgentVerifyRequest": ".agent_verify_request",
@@ -39,4 +43,11 @@ def __dir__():
     return sorted(lazy_attrs)
 
 
-__all__ = ["AgentSignupRequest", "AgentSignupResponse", "AgentVerifyRequest", "AgentVerifyResponse"]
+__all__ = [
+    "AgentAttachHumanRequest",
+    "AgentAttachHumanResponse",
+    "AgentSignupRequest",
+    "AgentSignupResponse",
+    "AgentVerifyRequest",
+    "AgentVerifyResponse",
+]

agentmail-2.0.6/src/agentmail/agent/types/agent_attach_human_request.py

@@ -0,0 +1,27 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ...core.pydantic_utilities import IS_PYDANTIC_V2
+from ...core.unchecked_base_model import UncheckedBaseModel
+
+
+class AgentAttachHumanRequest(UncheckedBaseModel):
+    """
+    Request body to attach a human to an agent organization.
+    """
+
+    human_email: str = pydantic.Field()
+    """
+    Email address of the human who owns the agent. A 6-digit OTP will be sent to this address.
+    """
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow