feat(api): improve raw MIME error handling

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 32
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/ark%2Fark-e3ff3c6b072d4d238c3a65297b743136d16ab74ca841c8931a9606a7cb7f1e02.yml
-openapi_spec_hash: 99861f96d1cc6aa31dfe3a2460adf46b
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/ark%2Fark-c7a958bca7912840fb91bf86ed7f4b6c292afd8d0a1a7f1091f9b067be87f786.yml
+openapi_spec_hash: d64cce1d9d6d329cf8a870b20c3aed62
 config_hash: d547cc5e7cc41bda64fd8db0d7cb1279

src/ark/resources/emails.py

@@ -499,7 +499,9 @@ def send_raw(
         Use this for advanced use cases or
         when migrating from systems that generate raw email content.
 
-        The `rawMessage` field should contain the base64-encoded raw email.
+        **Important:** The `rawMessage` field must be base64-encoded. Your raw MIME
+        message (with headers like From, To, Subject, Content-Type, followed by a blank
+        line and the body) must be encoded to base64 before sending.
 
         Args:
           from_: Sender email address. Must be from a verified domain.
@@ -512,7 +514,11 @@ def send_raw(
 
               The domain portion must match a verified sending domain in your account.
 
-          raw_message: Base64-encoded RFC 2822 MIME message
+          raw_message: Base64-encoded RFC 2822 MIME message.
+
+              **You must base64-encode your raw email before sending.** The raw email should
+              include headers (From, To, Subject, Content-Type, etc.) followed by a blank line
+              and the message body.
 
           to: Recipient email addresses
 
@@ -1006,7 +1012,9 @@ async def send_raw(
         Use this for advanced use cases or
         when migrating from systems that generate raw email content.
 
-        The `rawMessage` field should contain the base64-encoded raw email.
+        **Important:** The `rawMessage` field must be base64-encoded. Your raw MIME
+        message (with headers like From, To, Subject, Content-Type, followed by a blank
+        line and the body) must be encoded to base64 before sending.
 
         Args:
           from_: Sender email address. Must be from a verified domain.
@@ -1019,7 +1027,11 @@ async def send_raw(
 
               The domain portion must match a verified sending domain in your account.
 
-          raw_message: Base64-encoded RFC 2822 MIME message
+          raw_message: Base64-encoded RFC 2822 MIME message.
+
+              **You must base64-encode your raw email before sending.** The raw email should
+              include headers (From, To, Subject, Content-Type, etc.) followed by a blank line
+              and the message body.
 
           to: Recipient email addresses
 

src/ark/types/email_send_raw_params.py

@@ -25,7 +25,12 @@ class EmailSendRawParams(TypedDict, total=False):
     """
 
     raw_message: Required[Annotated[str, PropertyInfo(alias="rawMessage")]]
-    """Base64-encoded RFC 2822 MIME message"""
+    """Base64-encoded RFC 2822 MIME message.
+
+    **You must base64-encode your raw email before sending.** The raw email should
+    include headers (From, To, Subject, Content-Type, etc.) followed by a blank line
+    and the message body.
+    """
 
     to: Required[SequenceNotStr[str]]
     """Recipient email addresses"""