fix conflicts

Author: drish

.github/workflows/ci.yaml

@@ -9,9 +9,9 @@ jobs:
       matrix:
         python-version: ["3.8", "3.9", "3.10", "3.11"]
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v6
       - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v2
+        uses: actions/setup-python@v6
         with:
           python-version: ${{ matrix.python-version }}
       - name: Install dependencies
@@ -28,17 +28,17 @@ jobs:
         os: [ubuntu-latest]
         python-version: ["3.8", "3.9", "3.10", "3.11"]
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v6
       - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v2
+        uses: actions/setup-python@v6
         with:
           python-version: ${{ matrix.python-version }}
       - name: Install dependencies
         run: pip install tox
       - name: Test with pytest and generate coverage file
         run: tox -e py
       - name: Upload coverage report to codecov
-        uses: codecov/codecov-action@v1
+        uses: codecov/codecov-action@v5
         if: success()
         with:
           file: coverage.xml

Dockerfile

@@ -1,4 +1,4 @@
-FROM python:3.13.4
+FROM python:3.14.3
 
 RUN pip install --upgrade pip
 

README.md

@@ -52,7 +52,7 @@ params: resend.Emails.SendParams = {
     ],
 }
 
-email: resend.Email = resend.Emails.send(params)
+email: resend.Emails.SendResponse = resend.Emails.send(params)
 print(email)
 ```
 

examples/api_keys.py

@@ -10,15 +10,31 @@
     "name": "example.com",
 }
 
-key: resend.ApiKey = resend.ApiKeys.create(params=create_params)
+created_key: resend.ApiKeys.CreateApiKeyResponse = resend.ApiKeys.create(
+    params=create_params
+)
 print("Created new api key")
-print(f"Key id: {key['id']} and token: {key['token']}")
+print(f"Key id: {created_key['id']} and token: {created_key['token']}")
 
 keys: resend.ApiKeys.ListResponse = resend.ApiKeys.list()
 for key in keys["data"]:
     print(key["id"])
     print(key["name"])
     print(key["created_at"])
 
-if len(keys) > 0:
+print("\n--- Using pagination parameters ---")
+if keys["data"]:
+    paginated_params: resend.ApiKeys.ListParams = {
+        "limit": 8,
+        "after": keys["data"][0]["id"],
+    }
+    paginated_keys: resend.ApiKeys.ListResponse = resend.ApiKeys.list(
+        params=paginated_params
+    )
+    print(f"Retrieved {len(paginated_keys['data'])} keys with pagination")
+    print(f"Has more keys: {paginated_keys['has_more']}")
+else:
+    print("No keys available for pagination example")
+
+if len(keys["data"]) > 0:
     resend.ApiKeys.remove(api_key_id=keys["data"][0]["id"])

examples/api_keys_async.py

@@ -16,15 +16,15 @@ async def main() -> None:
         "name": "example.com",
     }
 
-    key: resend.ApiKey = await resend.ApiKeys.create_async(params=create_params)
+    key = await resend.ApiKeys.create_async(params=create_params)
     print("Created new api key")
     print(f"Key id: {key['id']} and token: {key['token']}")
 
     keys: resend.ApiKeys.ListResponse = await resend.ApiKeys.list_async()
-    for key in keys["data"]:
-        print(key["id"])
-        print(key["name"])
-        print(key["created_at"])
+    for k in keys["data"]:
+        print(k["id"])
+        print(k["name"])
+        print(k["created_at"])
 
     if len(keys["data"]) > 0:
         await resend.ApiKeys.remove_async(api_key_id=keys["data"][0]["id"])

examples/audiences.py

@@ -10,7 +10,9 @@
 create_params: resend.Audiences.CreateParams = {
     "name": "New Audience from Python SDK",
 }
-audience: resend.Audience = resend.Audiences.create(create_params)
+audience: resend.Audiences.CreateAudienceResponse = resend.Audiences.create(
+    create_params
+)
 print(f"Created audience: {audience['id']}")
 print(audience)
 
@@ -19,7 +21,24 @@
 
 audiences: resend.Audiences.ListResponse = resend.Audiences.list()
 print("List of audiences:", [a["id"] for a in audiences["data"]])
+print(f"Has more audiences: {audiences['has_more']}")
 
-rmed: resend.Audience = resend.Audiences.remove(id=audience["id"])
-print(f"Deleted audience")
+print("\n--- Using pagination parameters ---")
+if audiences["data"]:
+    paginated_params: resend.Audiences.ListParams = {
+        "limit": 5,
+        "after": audiences["data"][0]["id"],
+    }
+    paginated_audiences: resend.Audiences.ListResponse = resend.Audiences.list(
+        params=paginated_params
+    )
+    print(f"Retrieved {len(paginated_audiences['data'])} audiences with pagination")
+    print(f"Has more audiences: {paginated_audiences['has_more']}")
+else:
+    print("No audiences available for pagination example")
+
+rmed: resend.Audiences.RemoveAudienceResponse = resend.Audiences.remove(
+    id=audience["id"]
+)
+print(f"Deleted audience with ID: {audience['id']}")
 print(rmed)

examples/audiences_async.py

@@ -1,6 +1,5 @@
 import asyncio
 import os
-from typing import List
 
 import resend
 
@@ -12,21 +11,25 @@
 
 
 async def main() -> None:
-    create_params: resend.Audiences.CreateParams = {
-        "name": "New Audience from Python SDK (Async)",
+    create_params: resend.Segments.CreateParams = {
+        "name": "New Segment from Python SDK (Async)",
     }
-    audience: resend.Audience = await resend.Audiences.create_async(create_params)
-    print(f"Created audience: {audience['id']}")
-    print(audience)
-
-    aud: resend.Audience = await resend.Audiences.get_async(audience["id"])
-    print("Retrieved audience: ", aud)
-
-    audiences: resend.Audiences.ListResponse = await resend.Audiences.list_async()
-    print("List of audiences:", [a["id"] for a in audiences["data"]])
-
-    rmed: resend.Audience = await resend.Audiences.remove_async(id=audience["id"])
-    print(f"Deleted audience")
+    segment: resend.Segments.CreateSegmentResponse = await resend.Segments.create_async(
+        create_params
+    )
+    print(f"Created segment: {segment['id']}")
+    print(segment)
+
+    seg: resend.Segment = await resend.Segments.get_async(segment["id"])
+    print("Retrieved segment: ", seg)
+
+    segments: resend.Segments.ListResponse = await resend.Segments.list_async()
+    print("List of segments:", [s["id"] for s in segments["data"]])
+
+    rmed: resend.Segments.RemoveSegmentResponse = await resend.Segments.remove_async(
+        id=segment["id"]
+    )
+    print("Deleted segment")
     print(rmed)
 
 

examples/batch_email_send.py

@@ -49,3 +49,45 @@
     print("Failed to send batch emails")
     print(f"Error: {err}")
     exit(1)
+
+try:
+    # Send batch emails with permissive validation mode
+    print("sending with permissive validation mode")
+
+    # Example with some invalid emails to demonstrate error handling
+    mixed_params: List[resend.Emails.SendParams] = [
+        {
+            "from": "onboarding@resend.dev",
+            "to": ["delivered@resend.dev"],
+            "subject": "Valid email",
+            "html": "<strong>This should work!</strong>",
+        },
+        {
+            "from": "onboarding@resend.dev",
+            "to": [],  # Invalid - empty to field
+            "subject": "Invalid email",
+            "html": "<strong>This should fail!</strong>",
+        },
+    ]
+
+    options_permissive: resend.Batch.SendOptions = {
+        "batch_validation": "permissive",
+    }
+
+    result: resend.Batch.SendResponse = resend.Batch.send(
+        mixed_params, options=options_permissive
+    )
+
+    print(f"Successfully sent {len(result['data'])} emails:")
+    for email in result["data"]:
+        print(f"  Email id: {email['id']}")
+
+    if "errors" in result and result["errors"]:
+        print(f"Validation errors for {len(result['errors'])} emails:")
+        for error in result["errors"]:
+            print(f"  Index {error['index']}: {error['message']}")
+
+except resend.exceptions.ResendError as err:
+    print("Failed to send batch emails")
+    print(f"Error: {err}")
+    exit(1)

examples/broadcasts.py

@@ -1,8 +1,6 @@
 import os
-from typing import List
 
 import resend
-import resend.broadcasts
 
 if not os.environ["RESEND_API_KEY"]:
     raise EnvironmentError("RESEND_API_KEY is missing")
@@ -21,7 +19,7 @@
 }
 
 broadcast: resend.Broadcasts.CreateResponse = resend.Broadcasts.create(create_params)
-print("Created broadcast !")
+print("Created broadcast with ID: {}".format(broadcast["id"]))
 print(broadcast)
 
 update_params: resend.Broadcasts.UpdateParams = {
@@ -60,4 +58,19 @@
 
 list_response: resend.Broadcasts.ListResponse = resend.Broadcasts.list()
 print("List of broadcasts !\n")
-print(list_response)
+print(f"Found {len(list_response['data'])} broadcasts")
+print(f"Has more broadcasts: {list_response['has_more']}")
+
+print("\n--- Using pagination parameters ---")
+if list_response["data"]:
+    paginated_params: resend.Broadcasts.ListParams = {
+        "limit": 3,
+        "after": list_response["data"][0]["id"],
+    }
+    paginated_broadcasts: resend.Broadcasts.ListResponse = resend.Broadcasts.list(
+        params=paginated_params
+    )
+    print(f"Retrieved {len(paginated_broadcasts['data'])} broadcasts with pagination")
+    print(f"Has more broadcasts: {paginated_broadcasts['has_more']}")
+else:
+    print("No broadcasts available for pagination example")

examples/contact_properties.py

@@ -0,0 +1,50 @@
+import os
+
+import resend
+
+if not os.environ["RESEND_API_KEY"]:
+    raise EnvironmentError("RESEND_API_KEY is missing")
+
+# Create a contact property
+create_params: resend.ContactProperties.CreateParams = {
+    "key": "age",
+    "type": "number",
+    "fallback_value": 0,
+}
+create_response: resend.ContactProperties.CreateResponse = (
+    resend.ContactProperties.create(create_params)
+)
+print(f"Created contact property: {create_response}")
+
+# List all contact properties
+list_response: resend.ContactProperties.ListResponse = resend.ContactProperties.list()
+print(f"Contact properties: {list_response}")
+
+# List with pagination
+list_params: resend.ContactProperties.ListParams = {"limit": 10}
+paginated_response: resend.ContactProperties.ListResponse = (
+    resend.ContactProperties.list(list_params)
+)
+print(f"Limited contact properties: {paginated_response}")
+print(f"Has more: {paginated_response.get('has_more', False)}")
+
+# Get a specific contact property
+property_id: str = create_response["id"]
+property_details: resend.ContactProperty = resend.ContactProperties.get(property_id)
+print(f"Contact property details: {property_details}")
+
+# Update a contact property
+update_params: resend.ContactProperties.UpdateParams = {
+    "id": property_id,
+    "fallback_value": 18,
+}
+update_response: resend.ContactProperties.UpdateResponse = (
+    resend.ContactProperties.update(update_params)
+)
+print(f"Updated contact property: {update_response}")
+
+# Remove a contact property
+remove_response: resend.ContactProperties.RemoveResponse = (
+    resend.ContactProperties.remove(property_id)
+)
+print(f"Removed contact property: {remove_response}")