release: 7.4.0 (#117)

* fix(types): allow pyright to infer TypedDict types within SequenceNotStr

* chore: add missing docstrings

* feat: Add timezone field to Delay schema

* chore(internal): add missing files argument to base client

* feat: Update bulk API spec: make event required, document profile.email req…

* release: 7.4.0

---------

Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>

Author: stainless-app[bot]

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "7.3.0"
+  ".": "7.4.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 77
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/courier%2Fcourier-59c9efb45644c91ba21c8efaa0af53637071483ed661d5f99f27a15996624ac2.yml
-openapi_spec_hash: 0e1d703ca5e68a4d1f1489c04eb43765
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/courier%2Fcourier-9859cb664d1a9de0323c857e96cf41d0a5ac5c5903c501059f36bf62553b1583.yml
+openapi_spec_hash: d29149d60504eba35c63f583ce4bf0bc
 config_hash: 3ec521d062b05b81c22bc1a25bfe3d02

CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 7.4.0 (2025-12-16)
+
+Full Changelog: [v7.3.0...v7.4.0](https://github.com/trycourier/courier-python/compare/v7.3.0...v7.4.0)
+
+### Features
+
+* Add timezone field to Delay schema ([85b8c6f](https://github.com/trycourier/courier-python/commit/85b8c6f5fca9a68321d16c2927ea89cf509813d7))
+* Update bulk API spec: make event required, document profile.email req… ([1b99e93](https://github.com/trycourier/courier-python/commit/1b99e9336b2f38487b873962a81e9ffd2b82f019))
+
+
+### Bug Fixes
+
+* **types:** allow pyright to infer TypedDict types within SequenceNotStr ([ab5f2d0](https://github.com/trycourier/courier-python/commit/ab5f2d0b7e4f0534e3fff420f7f1ea6c159693bf))
+
+
+### Chores
+
+* add missing docstrings ([ea1dec0](https://github.com/trycourier/courier-python/commit/ea1dec0951b56ee5420d3c81d0fcbd5442ae726f))
+* **internal:** add missing files argument to base client ([a6fba70](https://github.com/trycourier/courier-python/commit/a6fba70d97a444af4c6c06c9adeb539051ceaee8))
+
 ## 7.3.0 (2025-12-08)
 
 Full Changelog: [v7.2.0...v7.3.0](https://github.com/trycourier/courier-python/compare/v7.2.0...v7.3.0)

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "trycourier"
-version = "7.3.0"
+version = "7.4.0"
 description = "The official Python library for the Courier API"
 dynamic = ["readme"]
 license = "Apache-2.0"

src/courier/_base_client.py

@@ -1247,9 +1247,12 @@ def patch(
         *,
         cast_to: Type[ResponseT],
         body: Body | None = None,
+        files: RequestFiles | None = None,
         options: RequestOptions = {},
     ) -> ResponseT:
-        opts = FinalRequestOptions.construct(method="patch", url=path, json_data=body, **options)
+        opts = FinalRequestOptions.construct(
+            method="patch", url=path, json_data=body, files=to_httpx_files(files), **options
+        )
         return self.request(cast_to, opts)
 
     def put(
@@ -1767,9 +1770,12 @@ async def patch(
         *,
         cast_to: Type[ResponseT],
         body: Body | None = None,
+        files: RequestFiles | None = None,
         options: RequestOptions = {},
     ) -> ResponseT:
-        opts = FinalRequestOptions.construct(method="patch", url=path, json_data=body, **options)
+        opts = FinalRequestOptions.construct(
+            method="patch", url=path, json_data=body, files=to_httpx_files(files), **options
+        )
         return await self.request(cast_to, opts)
 
     async def put(

src/courier/_types.py

@@ -243,6 +243,9 @@ class HttpxSendArgs(TypedDict, total=False):
 if TYPE_CHECKING:
     # This works because str.__contains__ does not accept object (either in typeshed or at runtime)
     # https://github.com/hauntsaninja/useful_types/blob/5e9710f3875107d068e7679fd7fec9cfab0eff3b/useful_types/__init__.py#L285
+    #
+    # Note: index() and count() methods are intentionally omitted to allow pyright to properly
+    # infer TypedDict types when dict literals are used in lists assigned to SequenceNotStr.
     class SequenceNotStr(Protocol[_T_co]):
         @overload
         def __getitem__(self, index: SupportsIndex, /) -> _T_co: ...
@@ -251,8 +254,6 @@ def __getitem__(self, index: slice, /) -> Sequence[_T_co]: ...
         def __contains__(self, value: object, /) -> bool: ...
         def __len__(self) -> int: ...
         def __iter__(self) -> Iterator[_T_co]: ...
-        def index(self, value: Any, start: int = 0, stop: int = ..., /) -> int: ...
-        def count(self, value: Any, /) -> int: ...
         def __reversed__(self) -> Iterator[_T_co]: ...
 else:
     # just point this to a normal `Sequence` at runtime to avoid having to special case

src/courier/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "courier"
-__version__ = "7.3.0"  # x-release-please-version
+__version__ = "7.4.0"  # x-release-please-version

src/courier/resources/bulk.py

@@ -60,7 +60,11 @@ def add_users(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> None:
         """
-        Ingest user data into a Bulk Job
+        Ingest user data into a Bulk Job.
+
+        **Important**: For email-based bulk jobs, each user must include `profile.email`
+        for provider routing to work correctly. The `to.email` field is not sufficient
+        for email provider routing.
 
         Args:
           extra_headers: Send extra headers
@@ -95,9 +99,22 @@ def create_job(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> BulkCreateJobResponse:
         """
-        Create a bulk job
+        Creates a new bulk job for sending messages to multiple recipients.
+
+        **Required**: `message.event` (event ID or notification ID)
+
+        **Optional (V2 format)**: `message.template` (notification ID) or
+        `message.content` (Elemental content) can be provided to override the
+        notification associated with the event.
 
         Args:
+          message:
+              Bulk message definition. Supports two formats:
+
+              - V1 format: Requires `event` field (event ID or notification ID)
+              - V2 format: Optionally use `template` (notification ID) or `content` (Elemental
+                content) in addition to `event`
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -257,7 +274,11 @@ async def add_users(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> None:
         """
-        Ingest user data into a Bulk Job
+        Ingest user data into a Bulk Job.
+
+        **Important**: For email-based bulk jobs, each user must include `profile.email`
+        for provider routing to work correctly. The `to.email` field is not sufficient
+        for email provider routing.
 
         Args:
           extra_headers: Send extra headers
@@ -292,9 +313,22 @@ async def create_job(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> BulkCreateJobResponse:
         """
-        Create a bulk job
+        Creates a new bulk job for sending messages to multiple recipients.
+
+        **Required**: `message.event` (event ID or notification ID)
+
+        **Optional (V2 format)**: `message.template` (notification ID) or
+        `message.content` (Elemental content) can be provided to override the
+        notification associated with the event.
 
         Args:
+          message:
+              Bulk message definition. Supports two formats:
+
+              - V1 format: Requires `event` field (event ID or notification ID)
+              - V2 format: Optionally use `template` (notification ID) or `content` (Elemental
+                content) in addition to `event`
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request

src/courier/types/bulk_create_job_params.py

@@ -11,3 +11,9 @@
 
 class BulkCreateJobParams(TypedDict, total=False):
     message: Required[InboundBulkMessageParam]
+    """Bulk message definition. Supports two formats:
+
+    - V1 format: Requires `event` field (event ID or notification ID)
+    - V2 format: Optionally use `template` (notification ID) or `content` (Elemental
+      content) in addition to `event`
+    """

src/courier/types/bulk_retrieve_job_response.py

@@ -10,6 +10,12 @@
 
 class Job(BaseModel):
     definition: InboundBulkMessage
+    """Bulk message definition. Supports two formats:
+
+    - V1 format: Requires `event` field (event ID or notification ID)
+    - V2 format: Optionally use `template` (notification ID) or `content` (Elemental
+      content) in addition to `event`
+    """
 
     enqueued: int