release: 4.20.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "4.19.2"
+  ".": "4.20.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 138
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/courier/courier-11e1931d767cef402bbed5a965746d1933ae72db0f41881860593a0b1424fd80.yml
-openapi_spec_hash: 9def941805f233f8761c4bdae88f6137
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/courier/courier-1ba05406f99c844cf7b32fe80c399017d00c504563f211caf66dfbccf8dd146d.yml
+openapi_spec_hash: be1b9b8a351560da21bbe3b53fd04905
 config_hash: 6c3a754258f0f77e9032a90a478ab76d

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 4.20.0 (2026-07-13)
+
+Full Changelog: [v4.19.2...v4.20.0](https://github.com/trycourier/courier-ruby/compare/v4.19.2...v4.20.0)
+
+### Features
+
+* Merge pull request [#149](https://github.com/trycourier/courier-ruby/issues/149) from trycourier/geraldosilva/c-19201-notification-template-subscription-topic-id ([cd697fa](https://github.com/trycourier/courier-ruby/commit/cd697fa2d3b49db32db582dae1789ab03706ced5))
+
 ## 4.19.2 (2026-07-10)
 
 Full Changelog: [v4.19.1...v4.19.2](https://github.com/trycourier/courier-ruby/compare/v4.19.1...v4.19.2)

Gemfile.lock

@@ -11,7 +11,7 @@ GIT
 PATH
   remote: .
   specs:
-    trycourier (4.19.2)
+    trycourier (4.20.0)
       cgi
       connection_pool
 

lib/courier/models/notification_template_summary.rb

@@ -35,6 +35,13 @@ class NotificationTemplateSummary < Courier::Internal::Type::BaseModel
       #   @return [Array<String>]
       required :tags, Courier::Internal::Type::ArrayOf[String]
 
+      # @!attribute subscription_topic_id
+      #   The linked subscription (preference) topic of the published version. Omitted
+      #   when no topic is linked or the template has never been published.
+      #
+      #   @return [String, nil]
+      optional :subscription_topic_id, String
+
       # @!attribute updated
       #   Epoch milliseconds of last update.
       #
@@ -47,7 +54,10 @@ class NotificationTemplateSummary < Courier::Internal::Type::BaseModel
       #   @return [String, nil]
       optional :updater, String
 
-      # @!method initialize(id:, created:, creator:, name:, state:, tags:, updated: nil, updater: nil)
+      # @!method initialize(id:, created:, creator:, name:, state:, tags:, subscription_topic_id: nil, updated: nil, updater: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Courier::Models::NotificationTemplateSummary} for more details.
+      #
       #   V2 (CDS) template summary returned in list responses.
       #
       #   @param id [String]
@@ -62,6 +72,8 @@ class NotificationTemplateSummary < Courier::Internal::Type::BaseModel
       #
       #   @param tags [Array<String>]
       #
+      #   @param subscription_topic_id [String] The linked subscription (preference) topic of the published version. Omitted whe
+      #
       #   @param updated [Integer] Epoch milliseconds of last update.
       #
       #   @param updater [String] User ID of the last updater.

lib/courier/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Courier
-  VERSION = "4.19.2"
+  VERSION = "4.20.0"
 end

rbi/courier/models/notification_template_summary.rbi

@@ -31,6 +31,14 @@ module Courier
       sig { returns(T::Array[String]) }
       attr_accessor :tags
 
+      # The linked subscription (preference) topic of the published version. Omitted
+      # when no topic is linked or the template has never been published.
+      sig { returns(T.nilable(String)) }
+      attr_reader :subscription_topic_id
+
+      sig { params(subscription_topic_id: String).void }
+      attr_writer :subscription_topic_id
+
       # Epoch milliseconds of last update.
       sig { returns(T.nilable(Integer)) }
       attr_reader :updated
@@ -54,6 +62,7 @@ module Courier
           name: String,
           state: Courier::NotificationTemplateSummary::State::OrSymbol,
           tags: T::Array[String],
+          subscription_topic_id: String,
           updated: Integer,
           updater: String
         ).returns(T.attached_class)
@@ -67,6 +76,9 @@ module Courier
         name:,
         state:,
         tags:,
+        # The linked subscription (preference) topic of the published version. Omitted
+        # when no topic is linked or the template has never been published.
+        subscription_topic_id: nil,
         # Epoch milliseconds of last update.
         updated: nil,
         # User ID of the last updater.
@@ -83,6 +95,7 @@ module Courier
             name: String,
             state: Courier::NotificationTemplateSummary::State::TaggedSymbol,
             tags: T::Array[String],
+            subscription_topic_id: String,
             updated: Integer,
             updater: String
           }

sig/courier/models/notification_template_summary.rbs

@@ -8,6 +8,7 @@ module Courier
         name: String,
         state: Courier::Models::NotificationTemplateSummary::state,
         tags: ::Array[String],
+        subscription_topic_id: String,
         updated: Integer,
         updater: String
       }
@@ -25,6 +26,10 @@ module Courier
 
       attr_accessor tags: ::Array[String]
 
+      attr_reader subscription_topic_id: String?
+
+      def subscription_topic_id=: (String) -> String
+
       attr_reader updated: Integer?
 
       def updated=: (Integer) -> Integer
@@ -40,6 +45,7 @@ module Courier
         name: String,
         state: Courier::Models::NotificationTemplateSummary::state,
         tags: ::Array[String],
+        ?subscription_topic_id: String,
         ?updated: Integer,
         ?updater: String
       ) -> void
@@ -51,6 +57,7 @@ module Courier
         name: String,
         state: Courier::Models::NotificationTemplateSummary::state,
         tags: ::Array[String],
+        subscription_topic_id: String,
         updated: Integer,
         updater: String
       }