release: 4.19.1 (#99)

stainless-app[bot] · claude · web-flow · commit b15ca7d8adf2 · 2026-07-09T16:08:55.000-07:00
* codegen metadata

* ci(docs): generate docs on the PR, publish Postman from the raw spec (#157)

* ci(docs): generate docs on the PR, publish Postman from the raw spec

Move the mintlify-docs sync off the post-merge Stainless build and onto the
PR, right after the preview generation — restoring the pre-#136 "docs PR from
the PR" flow. The post-merge build was flaky: a downstream SDK target (usually
cli) failing, or Stainless's content cache skipping a re-run of the same
commit, silently blocked the docs sync.

- sync_docs now runs on pull_request (needs: preview) and creates/updates the
  docs PR (branch api-spec-&lt;pr&gt;) from the PR's own code-sample-decorated spec.
  No auto-merge — a human merges the docs PR once this PR lands, matching the
  original flow.
- publish_postman builds the collection straight from specs/openapi.yml (the
  converter ignores x-codeSamples), so it no longer depends on the Stainless
  build, and publishes the live public collection only on merge to main (push
  is path-filtered to specs/**).
- sdk_release keeps the Stainless build@main that cuts the per-language SDK
  release PRs; it no longer gates docs or Postman, so a cli flake is just a
  re-run.

Also reword the bulk-replace tenant_id param ("Update" -&gt; "Replace") to
exercise the new PR-based docs generation.

Co-Authored-By: Claude Opus 4.8 &lt;noreply@anthropic.com&gt;

* docs(readme): document PR-time docs sync and raw-spec Postman flow

Rewrite the 'What happens in CI' section to match the restructured
workflow: docs sync now runs on the PR right after generation (no
auto-merge), and Postman/SDK-release run on merge — Postman built from
specs/openapi.yml, sdk_release no longer gating docs.

Co-Authored-By: Claude Opus 4.8 &lt;noreply@anthropic.com&gt;

* ci(e2e): pass COURIER_RESENDABLE_MESSAGE_ID through to the e2e run

The resend test reads COURIER_RESENDABLE_MESSAGE_ID (repo secret exists,
listed in node/.env.example) but it was never mapped into the e2e env
block, so env() fell back to "" and courier.messages.resend("") hit
POST /messages//resend -&gt; 404. Wire the secret through.

Co-Authored-By: Claude Opus 4.8 &lt;noreply@anthropic.com&gt;

---------

Co-authored-by: Claude Opus 4.8 &lt;noreply@anthropic.com&gt;

* codegen metadata

* release: 4.19.1

---------

Co-authored-by: stainless-app[bot] &lt;142633134+stainless-app[bot]@users.noreply.github.com&gt;
Co-authored-by: Claude Opus 4.8 &lt;noreply@anthropic.com&gt;
diff --git a/.release-please-manifest.json b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "4.19.0"
+  ".": "4.19.1"
 }
diff --git a/.stats.yml b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 138
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/courier/courier-cba470b0c221bcfbe2e8bf51276292285a60a05a4c0b47f5f741706adf1205fc.yml
-openapi_spec_hash: c9f1b73fb32f39243d9d95a667ea3341
-config_hash: 6025fdbfe31c3b2d57a71f9885d37294
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/courier/courier-e8d4bd51bf260b8a6cb9875718e36eab95d4e8d9490cd6c5c669eb69b82c2bf8.yml
+openapi_spec_hash: bf321581a238ae891debcc5bb59dd501
+config_hash: 6c3a754258f0f77e9032a90a478ab76d
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,9 @@
 # Changelog
 
+## 4.19.1 (2026-07-09)
+
+Full Changelog: [v4.19.0...v4.19.1](https://github.com/trycourier/courier-ruby/compare/v4.19.0...v4.19.1)
+
 ## 4.19.0 (2026-07-09)
 
 Full Changelog: [v4.18.2...v4.19.0](https://github.com/trycourier/courier-ruby/compare/v4.18.2...v4.19.0)
diff --git a/Gemfile.lock b/Gemfile.lock
@@ -11,7 +11,7 @@ GIT
 PATH
   remote: .
   specs:
-    trycourier (4.19.0)
+    trycourier (4.19.1)
       cgi
       connection_pool
 
diff --git a/lib/courier/models/users/preference_bulk_replace_params.rb b/lib/courier/models/users/preference_bulk_replace_params.rb
@@ -23,7 +23,7 @@ class PreferenceBulkReplaceParams < Courier::Internal::Type::BaseModel
                  -> { Courier::Internal::Type::ArrayOf[Courier::Users::PreferenceBulkReplaceParams::Topic] }
 
         # @!attribute tenant_id
-        #   Update the preferences of a user for this specific tenant context.
+        #   Replace the preferences of a user for this specific tenant context.
         #
         #   @return [String, nil]
         optional :tenant_id, String, nil?: true
@@ -36,7 +36,7 @@ class PreferenceBulkReplaceParams < Courier::Internal::Type::BaseModel
         #
         #   @param topics [Array<Courier::Models::Users::PreferenceBulkReplaceParams::Topic>] The complete set of topic overrides for the user. Up to 50 topics may be provide
         #
-        #   @param tenant_id [String, nil] Update the preferences of a user for this specific tenant context.
+        #   @param tenant_id [String, nil] Replace the preferences of a user for this specific tenant context.
         #
         #   @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
 
diff --git a/lib/courier/resources/users/preferences.rb b/lib/courier/resources/users/preferences.rb
@@ -59,7 +59,7 @@ def retrieve(user_id, params = {})
         #
         # @param topics [Array<Courier::Models::Users::PreferenceBulkReplaceParams::Topic>] Body param: The complete set of topic overrides for the user. Up to 50 topics ma
         #
-        # @param tenant_id [String, nil] Query param: Update the preferences of a user for this specific tenant context.
+        # @param tenant_id [String, nil] Query param: Replace the preferences of a user for this specific tenant context.
         #
         # @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}, nil]
         #
diff --git a/lib/courier/version.rb b/lib/courier/version.rb
@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Courier
-  VERSION = "4.19.0"
+  VERSION = "4.19.1"
 end
diff --git a/rbi/courier/models/users/preference_bulk_replace_params.rbi b/rbi/courier/models/users/preference_bulk_replace_params.rbi
@@ -26,7 +26,7 @@ module Courier
         end
         attr_accessor :topics
 
-        # Update the preferences of a user for this specific tenant context.
+        # Replace the preferences of a user for this specific tenant context.
         sig { returns(T.nilable(String)) }
         attr_accessor :tenant_id
 
@@ -47,7 +47,7 @@ module Courier
           # provided. Any existing override not listed here is reset to its topic default;
           # an empty array resets every existing override.
           topics:,
-          # Update the preferences of a user for this specific tenant context.
+          # Replace the preferences of a user for this specific tenant context.
           tenant_id: nil,
           request_options: {}
         )
diff --git a/rbi/courier/resources/users/preferences.rbi b/rbi/courier/resources/users/preferences.rbi
@@ -58,7 +58,7 @@ module Courier
           # may be provided. Any existing override not listed here is reset to its topic
           # default; an empty array resets every existing override.
           topics:,
-          # Query param: Update the preferences of a user for this specific tenant context.
+          # Query param: Replace the preferences of a user for this specific tenant context.
           tenant_id: nil,
           request_options: {}
         )

Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,3 @@`
`1`	`1`	`{`
`2`		`- ".": "4.19.0"`
	`2`	`+ ".": "4.19.1"`
`3`	`3`	`}`
Original file line number	Diff line number	Diff line change
`@@ -23,7 +23,7 @@ class PreferenceBulkReplaceParams < Courier::Internal::Type::BaseModel`
`23`	`23`	`-> { Courier::Internal::Type::ArrayOf[Courier::Users::PreferenceBulkReplaceParams::Topic] }`
`24`	`24`
`25`	`25`	`# @!attribute tenant_id`
`26`		`- # Update the preferences of a user for this specific tenant context.`
	`26`	`+ # Replace the preferences of a user for this specific tenant context.`
`27`	`27`	`#`
`28`	`28`	`# @return [String, nil]`
`29`	`29`	`optional :tenant_id, String, nil?: true`
`@@ -36,7 +36,7 @@ class PreferenceBulkReplaceParams < Courier::Internal::Type::BaseModel`
`36`	`36`	`#`
`37`	`37`	`# @param topics [Array<Courier::Models::Users::PreferenceBulkReplaceParams::Topic>] The complete set of topic overrides for the user. Up to 50 topics may be provide`
`38`	`38`	`#`
`39`		`- # @param tenant_id [String, nil] Update the preferences of a user for this specific tenant context.`
	`39`	`+ # @param tenant_id [String, nil] Replace the preferences of a user for this specific tenant context.`
`40`	`40`	`#`
`41`	`41`	`# @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]`
`42`	`42`
Original file line number	Diff line number	Diff line change
`@@ -59,7 +59,7 @@ def retrieve(user_id, params = {})`
`59`	`59`	`#`
`60`	`60`	`# @param topics [Array<Courier::Models::Users::PreferenceBulkReplaceParams::Topic>] Body param: The complete set of topic overrides for the user. Up to 50 topics ma`
`61`	`61`	`#`
`62`		`- # @param tenant_id [String, nil] Query param: Update the preferences of a user for this specific tenant context.`
	`62`	`+ # @param tenant_id [String, nil] Query param: Replace the preferences of a user for this specific tenant context.`
`63`	`63`	`#`
`64`	`64`	`# @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}, nil]`
`65`	`65`	`#`
Original file line number	Diff line number	Diff line change
`@@ -58,7 +58,7 @@ module Courier`
`58`	`58`	`# may be provided. Any existing override not listed here is reset to its topic`
`59`	`59`	`# default; an empty array resets every existing override.`
`60`	`60`	`topics:,`
`61`		`- # Query param: Update the preferences of a user for this specific tenant context.`
	`61`	`+ # Query param: Replace the preferences of a user for this specific tenant context.`
`62`	`62`	`tenant_id: nil,`
`63`	`63`	`request_options: {}`
`64`	`64`	`)`