release: 7.1.0 (#113)

stainless-app[bot] · web-flow · commit 30e8fcd26ac6 · 2025-11-18T15:13:30.000-08:00
* codegen metadata

* codegen metadata

* feat: NPM enabled

* codegen metadata

* codegen metadata

* feat: Test

* feat: JWT scope updates

* codegen metadata

* release: 7.1.0

---------

Co-authored-by: stainless-app[bot] &lt;142633134+stainless-app[bot]@users.noreply.github.com&gt;
diff --git a/.release-please-manifest.json b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "7.0.1"
+  ".": "7.1.0"
 }
diff --git a/.stats.yml b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 77
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/courier%2Fcourier-33d5d7c18097451b2abe61ea5a694efd6fbff5dca21e62ffd59ea37ec0bd569b.yml
-openapi_spec_hash: 5da629173a97d334c5b2253d0a6e22b3
-config_hash: 1dfe9dc0d55d828e116bd0f89061c3c5
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/courier%2Fcourier-ef9e41c6e60cc3c2a745acf0f0b6130555b4f88fd8b092eb11c84418b2e16481.yml
+openapi_spec_hash: f9a7f141a9bbae15c1e240ed6a3a3601
+config_hash: 3ec521d062b05b81c22bc1a25bfe3d02
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,15 @@
 # Changelog
 
+## 7.1.0 (2025-11-18)
+
+Full Changelog: [v7.0.1...v7.1.0](https://github.com/trycourier/courier-python/compare/v7.0.1...v7.1.0)
+
+### Features
+
+* JWT scope updates ([79503e5](https://github.com/trycourier/courier-python/commit/79503e5c99993a0a81fdc8da9eb8553c541cf6af))
+* NPM enabled ([a93573b](https://github.com/trycourier/courier-python/commit/a93573b77947d06113262e73b48c7aaba74e1832))
+* Test ([cdeccac](https://github.com/trycourier/courier-python/commit/cdeccac6ac1d08ba5864b8e1a9b05b4ae5ae983f))
+
 ## 7.0.1 (2025-11-12)
 
 Full Changelog: [v7.0.0...v7.0.1](https://github.com/trycourier/courier-python/compare/v7.0.0...v7.0.1)
diff --git a/pyproject.toml b/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "trycourier"
-version = "7.0.1"
+version = "7.1.0"
 description = "The official Python library for the Courier API"
 dynamic = ["readme"]
 license = "Apache-2.0"
diff --git a/src/courier/_version.py b/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.0.1"  # x-release-please-version
+__version__ = "7.1.0"  # x-release-please-version
diff --git a/src/courier/resources/auth.py b/src/courier/resources/auth.py
@@ -57,6 +57,36 @@ def issue_token(
         Returns a new access token.
 
         Args:
+          expires_in:
+              Duration for token expiration. Accepts various time formats:
+
+              - "2 hours" - 2 hours from now
+              - "1d" - 1 day
+              - "3 days" - 3 days
+              - "10h" - 10 hours
+              - "2.5 hrs" - 2.5 hours
+              - "1m" - 1 minute
+              - "5s" - 5 seconds
+              - "1y" - 1 year
+
+          scope:
+              Available scopes:
+
+              - `user_id:<user-id>` - Defines which user the token will be scoped to. Multiple
+                can be listed if needed. Ex `user_id:pigeon user_id:bluebird`.
+              - `read:messages` - Read messages.
+              - `read:user-tokens` - Read user push tokens.
+              - `write:user-tokens` - Write user push tokens.
+              - `read:brands[:<brand_id>]` - Read brands, optionally restricted to a specific
+                brand_id. Examples `read:brands`, `read:brands:my_brand`.
+              - `write:brands[:<brand_id>]` - Write brands, optionally restricted to a
+                specific brand_id. Examples `write:brands`, `write:brands:my_brand`.
+              - `inbox:read:messages` - Read inbox messages.
+              - `inbox:write:events` - Write inbox events, such as mark message as read.
+              - `read:preferences` - Read user preferences.
+              - `write:preferences` - Write user preferences. Example:
+                `user_id:user123 write:user-tokens inbox:read:messages inbox:write:events read:preferences write:preferences read:brands`
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -117,6 +147,36 @@ async def issue_token(
         Returns a new access token.
 
         Args:
+          expires_in:
+              Duration for token expiration. Accepts various time formats:
+
+              - "2 hours" - 2 hours from now
+              - "1d" - 1 day
+              - "3 days" - 3 days
+              - "10h" - 10 hours
+              - "2.5 hrs" - 2.5 hours
+              - "1m" - 1 minute
+              - "5s" - 5 seconds
+              - "1y" - 1 year
+
+          scope:
+              Available scopes:
+
+              - `user_id:<user-id>` - Defines which user the token will be scoped to. Multiple
+                can be listed if needed. Ex `user_id:pigeon user_id:bluebird`.
+              - `read:messages` - Read messages.
+              - `read:user-tokens` - Read user push tokens.
+              - `write:user-tokens` - Write user push tokens.
+              - `read:brands[:<brand_id>]` - Read brands, optionally restricted to a specific
+                brand_id. Examples `read:brands`, `read:brands:my_brand`.
+              - `write:brands[:<brand_id>]` - Write brands, optionally restricted to a
+                specific brand_id. Examples `write:brands`, `write:brands:my_brand`.
+              - `inbox:read:messages` - Read inbox messages.
+              - `inbox:write:events` - Write inbox events, such as mark message as read.
+              - `read:preferences` - Read user preferences.
+              - `write:preferences` - Write user preferences. Example:
+                `user_id:user123 write:user-tokens inbox:read:messages inbox:write:events read:preferences write:preferences read:brands`
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
diff --git a/src/courier/resources/send.py b/src/courier/resources/send.py
@@ -53,7 +53,7 @@ def message(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> SendMessageResponse:
         """
-        API to send a message to one or more recipients.
+        Send a message to one or more recipients.
 
         Args:
           message: The message property has the following primary top-level properties. They define
@@ -109,7 +109,7 @@ async def message(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> SendMessageResponse:
         """
-        API to send a message to one or more recipients.
+        Send a message to one or more recipients.
 
         Args:
           message: The message property has the following primary top-level properties. They define
diff --git a/src/courier/types/auth_issue_token_params.py b/src/courier/types/auth_issue_token_params.py
@@ -9,5 +9,33 @@
 
 class AuthIssueTokenParams(TypedDict, total=False):
     expires_in: Required[str]
+    """Duration for token expiration. Accepts various time formats:
+
+    - "2 hours" - 2 hours from now
+    - "1d" - 1 day
+    - "3 days" - 3 days
+    - "10h" - 10 hours
+    - "2.5 hrs" - 2.5 hours
+    - "1m" - 1 minute
+    - "5s" - 5 seconds
+    - "1y" - 1 year
+    """
 
     scope: Required[str]
+    """Available scopes:
+
+    - `user_id:<user-id>` - Defines which user the token will be scoped to. Multiple
+      can be listed if needed. Ex `user_id:pigeon user_id:bluebird`.
+    - `read:messages` - Read messages.
+    - `read:user-tokens` - Read user push tokens.
+    - `write:user-tokens` - Write user push tokens.
+    - `read:brands[:<brand_id>]` - Read brands, optionally restricted to a specific
+      brand_id. Examples `read:brands`, `read:brands:my_brand`.
+    - `write:brands[:<brand_id>]` - Write brands, optionally restricted to a
+      specific brand_id. Examples `write:brands`, `write:brands:my_brand`.
+    - `inbox:read:messages` - Read inbox messages.
+    - `inbox:write:events` - Write inbox events, such as mark message as read.
+    - `read:preferences` - Read user preferences.
+    - `write:preferences` - Write user preferences. Example:
+      `user_id:user123 write:user-tokens inbox:read:messages inbox:write:events read:preferences write:preferences read:brands`
+    """
diff --git a/tests/api_resources/test_auth.py b/tests/api_resources/test_auth.py
@@ -21,17 +21,17 @@ class TestAuth:
     @parametrize
     def test_method_issue_token(self, client: Courier) -> None:
         auth = client.auth.issue_token(
-            expires_in="expires_in",
-            scope="scope",
+            expires_in="$YOUR_NUMBER days",
+            scope="user_id:$YOUR_USER_ID write:user-tokens inbox:read:messages inbox:write:events read:preferences write:preferences read:brands",
         )
         assert_matches_type(AuthIssueTokenResponse, auth, path=["response"])
 
     @pytest.mark.skip(reason="Prism tests are disabled")
     @parametrize
     def test_raw_response_issue_token(self, client: Courier) -> None:
         response = client.auth.with_raw_response.issue_token(
-            expires_in="expires_in",
-            scope="scope",
+            expires_in="$YOUR_NUMBER days",
+            scope="user_id:$YOUR_USER_ID write:user-tokens inbox:read:messages inbox:write:events read:preferences write:preferences read:brands",
         )
 
         assert response.is_closed is True
@@ -43,8 +43,8 @@ def test_raw_response_issue_token(self, client: Courier) -> None:
     @parametrize
     def test_streaming_response_issue_token(self, client: Courier) -> None:
         with client.auth.with_streaming_response.issue_token(
-            expires_in="expires_in",
-            scope="scope",
+            expires_in="$YOUR_NUMBER days",
+            scope="user_id:$YOUR_USER_ID write:user-tokens inbox:read:messages inbox:write:events read:preferences write:preferences read:brands",
         ) as response:
             assert not response.is_closed
             assert response.http_request.headers.get("X-Stainless-Lang") == "python"
@@ -64,17 +64,17 @@ class TestAsyncAuth:
     @parametrize
     async def test_method_issue_token(self, async_client: AsyncCourier) -> None:
         auth = await async_client.auth.issue_token(
-            expires_in="expires_in",
-            scope="scope",
+            expires_in="$YOUR_NUMBER days",
+            scope="user_id:$YOUR_USER_ID write:user-tokens inbox:read:messages inbox:write:events read:preferences write:preferences read:brands",
         )
         assert_matches_type(AuthIssueTokenResponse, auth, path=["response"])
 
     @pytest.mark.skip(reason="Prism tests are disabled")
     @parametrize
     async def test_raw_response_issue_token(self, async_client: AsyncCourier) -> None:
         response = await async_client.auth.with_raw_response.issue_token(
-            expires_in="expires_in",
-            scope="scope",
+            expires_in="$YOUR_NUMBER days",
+            scope="user_id:$YOUR_USER_ID write:user-tokens inbox:read:messages inbox:write:events read:preferences write:preferences read:brands",
         )
 
         assert response.is_closed is True
@@ -86,8 +86,8 @@ async def test_raw_response_issue_token(self, async_client: AsyncCourier) -> Non
     @parametrize
     async def test_streaming_response_issue_token(self, async_client: AsyncCourier) -> None:
         async with async_client.auth.with_streaming_response.issue_token(
-            expires_in="expires_in",
-            scope="scope",
+            expires_in="$YOUR_NUMBER days",
+            scope="user_id:$YOUR_USER_ID write:user-tokens inbox:read:messages inbox:write:events read:preferences write:preferences read:brands",
         ) as response:
             assert not response.is_closed
             assert response.http_request.headers.get("X-Stainless-Lang") == "python"

Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,3 @@`
`1`	`1`	`{`
`2`		`- ".": "7.0.1"`
	`2`	`+ ".": "7.1.0"`
`3`	`3`	`}`