trycourier 4.10.1 → 4.10.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0f858f38c4f9b150bb7ae15d41485742e215ee802b55ebf66eaa03f2fbd1ac02
-  data.tar.gz: 42e013bd3562dfcce1b12bd980c02f481cd7f8c5290d364e16a3a395d957569b
+  metadata.gz: 2c653d07cd54be88e8b8328788188c56e6d62e7308f6bccf582769bd38b5e413
+  data.tar.gz: 9a025d1497b0e9383686ba5c849d2784be1195c7c21a52ba24d2491f6e5ebe71
 SHA512:
-  metadata.gz: 91849f5ef3635836ff2976f9bbcad8f337464d89aea6728e377a3c39b45db79116cb2bf13b0946f3d1ed98fa8f584b8e8a38fa0cd52b6cc186563e203c2ad583
-  data.tar.gz: 4dcd5c0b990e1e4e121078106637462a3894d5d8b5350bf1074e1101f695d7782e63691144d1255e680b4feeb1c15c91e3ac04bf9eb499593e4914828ce9e088
+  metadata.gz: ee312a1f98ddfd71c03692e23047237cd1205465687890e3d0dea3bd675acb6ed1ba30b340e67a85e9cd3d73017c09c29e5ef0a3946c4b6e2ccb806e7af29392
+  data.tar.gz: ac1e5417c4e7400965fc5efc5074e40cff4e5e4b5a4427795884cdba02869dbc54185252d2653c9599fe745b8a78e2fd0793675bf9a08b6a9d5d3903ee0139c8

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 4.10.2 (2026-04-14)
+
+Full Changelog: [v4.10.1...v4.10.2](https://github.com/trycourier/courier-ruby/compare/v4.10.1...v4.10.2)
+
+### Bug Fixes
+
+* **types:** flatten NotificationTemplateResponse model structure ([4c019eb](https://github.com/trycourier/courier-ruby/commit/4c019ebb34aaf3b6c37e778da95c593aa5faa409))
+* **types:** make note optional, flatten NotificationTemplateGetResponse ([05f8c8c](https://github.com/trycourier/courier-ruby/commit/05f8c8c41198a2f8156ac10ccf4a67fa84130350))
+
 ## 4.10.1 (2026-04-13)
 
 Full Changelog: [v4.10.0...v4.10.1](https://github.com/trycourier/courier-ruby/compare/v4.10.0...v4.10.1)

data/lib/courier/models/notification_list_response.rb

@@ -47,11 +47,6 @@ module Courier
           #   @return [Array<String>]
           required :event_ids, Courier::Internal::Type::ArrayOf[String]
 
-          # @!attribute note
-          #
-          #   @return [String]
-          required :note, String
-
           # @!attribute routing
           #
           #   @return [Courier::Models::MessageRouting]
@@ -67,6 +62,11 @@ module Courier
           #   @return [Integer]
           required :updated_at, Integer
 
+          # @!attribute note
+          #
+          #   @return [String, nil]
+          optional :note, String
+
           # @!attribute tags
           #
           #   @return [Courier::Models::NotificationListResponse::Result::Notification::Tags, nil]
@@ -77,21 +77,21 @@ module Courier
           #   @return [String, nil]
           optional :title, String, nil?: true
 
-          # @!method initialize(id:, created_at:, event_ids:, note:, routing:, topic_id:, updated_at:, tags: nil, title: nil)
+          # @!method initialize(id:, created_at:, event_ids:, routing:, topic_id:, updated_at:, note: nil, tags: nil, title: nil)
           #   @param id [String]
           #
           #   @param created_at [Integer]
           #
           #   @param event_ids [Array<String>] Array of event IDs associated with this notification
           #
-          #   @param note [String]
-          #
           #   @param routing [Courier::Models::MessageRouting]
           #
           #   @param topic_id [String]
           #
           #   @param updated_at [Integer]
           #
+          #   @param note [String]
+          #
           #   @param tags [Courier::Models::NotificationListResponse::Result::Notification::Tags, nil]
           #
           #   @param title [String, nil]

data/lib/courier/models/notification_template_create_request.rb

@@ -4,8 +4,8 @@ module Courier
   module Models
     class NotificationTemplateCreateRequest < Courier::Internal::Type::BaseModel
       # @!attribute notification
-      #   Full document shape used in POST and PUT request bodies, and returned inside the
-      #   GET response envelope.
+      #   Core template fields used in POST and PUT request bodies (nested under a
+      #   `notification` key) and returned at the top level in responses.
       #
       #   @return [Courier::Models::NotificationTemplatePayload]
       required :notification, -> { Courier::NotificationTemplatePayload }
@@ -23,7 +23,7 @@ module Courier
       #
       #   Request body for creating a notification template.
       #
-      #   @param notification [Courier::Models::NotificationTemplatePayload] Full document shape used in POST and PUT request bodies, and returned inside the
+      #   @param notification [Courier::Models::NotificationTemplatePayload] Core template fields used in POST and PUT request bodies (nested under a `notifi
       #
       #   @param state [Symbol, Courier::Models::NotificationTemplateCreateRequest::State] Template state after creation. Case-insensitive input, normalized to uppercase i
 

data/lib/courier/models/notification_template_payload.rb

@@ -40,8 +40,8 @@ module Courier
       required :tags, Courier::Internal::Type::ArrayOf[String]
 
       # @!method initialize(brand:, content:, name:, routing:, subscription:, tags:)
-      #   Full document shape used in POST and PUT request bodies, and returned inside the
-      #   GET response envelope.
+      #   Core template fields used in POST and PUT request bodies (nested under a
+      #   `notification` key) and returned at the top level in responses.
       #
       #   @param brand [Courier::Models::NotificationTemplatePayload::Brand, nil] Brand reference, or null for no brand.
       #

data/lib/courier/models/notification_template_response.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # @see Courier::Resources::Notifications#create
+    class NotificationTemplateResponse < Courier::Models::NotificationTemplatePayload
+      # @!attribute id
+      #   The template ID.
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute created
+      #   Epoch milliseconds when the template was created.
+      #
+      #   @return [Integer]
+      required :created, Integer
+
+      # @!attribute creator
+      #   User ID of the creator.
+      #
+      #   @return [String]
+      required :creator, String
+
+      # @!attribute state
+      #   The template state. Always uppercase.
+      #
+      #   @return [Symbol, Courier::Models::NotificationTemplateResponse::State]
+      required :state, enum: -> { Courier::NotificationTemplateResponse::State }
+
+      # @!attribute updated
+      #   Epoch milliseconds of last update.
+      #
+      #   @return [Integer, nil]
+      optional :updated, Integer
+
+      # @!attribute updater
+      #   User ID of the last updater.
+      #
+      #   @return [String, nil]
+      optional :updater, String
+
+      # @!method initialize(id:, created:, creator:, state:, updated: nil, updater: nil)
+      #   Response for GET /notifications/{id}, POST /notifications, and PUT
+      #   /notifications/{id}. Returns all template fields at the top level.
+      #
+      #   @param id [String] The template ID.
+      #
+      #   @param created [Integer] Epoch milliseconds when the template was created.
+      #
+      #   @param creator [String] User ID of the creator.
+      #
+      #   @param state [Symbol, Courier::Models::NotificationTemplateResponse::State] The template state. Always uppercase.
+      #
+      #   @param updated [Integer] Epoch milliseconds of last update.
+      #
+      #   @param updater [String] User ID of the last updater.
+
+      # The template state. Always uppercase.
+      module State
+        extend Courier::Internal::Type::Enum
+
+        DRAFT = :DRAFT
+        PUBLISHED = :PUBLISHED
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/courier/models/notification_template_update_request.rb

@@ -4,8 +4,8 @@ module Courier
   module Models
     class NotificationTemplateUpdateRequest < Courier::Internal::Type::BaseModel
       # @!attribute notification
-      #   Full document shape used in POST and PUT request bodies, and returned inside the
-      #   GET response envelope.
+      #   Core template fields used in POST and PUT request bodies (nested under a
+      #   `notification` key) and returned at the top level in responses.
       #
       #   @return [Courier::Models::NotificationTemplatePayload]
       required :notification, -> { Courier::NotificationTemplatePayload }
@@ -24,7 +24,7 @@ module Courier
       #   Request body for replacing a notification template. Same shape as create. All
       #   fields required (PUT = full replacement).
       #
-      #   @param notification [Courier::Models::NotificationTemplatePayload] Full document shape used in POST and PUT request bodies, and returned inside the
+      #   @param notification [Courier::Models::NotificationTemplatePayload] Core template fields used in POST and PUT request bodies (nested under a `notifi
       #
       #   @param state [Symbol, Courier::Models::NotificationTemplateUpdateRequest::State] Template state after update. Case-insensitive input, normalized to uppercase in
 

data/lib/courier/models.rb

@@ -297,12 +297,12 @@ module Courier
 
   NotificationTemplateCreateRequest = Courier::Models::NotificationTemplateCreateRequest
 
-  NotificationTemplateGetResponse = Courier::Models::NotificationTemplateGetResponse
-
   NotificationTemplatePayload = Courier::Models::NotificationTemplatePayload
 
   NotificationTemplatePublishRequest = Courier::Models::NotificationTemplatePublishRequest
 
+  NotificationTemplateResponse = Courier::Models::NotificationTemplateResponse
+
   NotificationTemplateState = Courier::Models::NotificationTemplateState
 
   NotificationTemplateSummary = Courier::Models::NotificationTemplateSummary

data/lib/courier/resources/notifications/checks.rb

@@ -4,11 +4,13 @@ module Courier
   module Resources
     class Notifications
       class Checks
+        # Replace the checks for a notification template submission.
+        #
         # @overload update(submission_id, id:, checks:, request_options: {})
         #
-        # @param submission_id [String] Path param
+        # @param submission_id [String] Path param: Submission ID.
         #
-        # @param id [String] Path param
+        # @param id [String] Path param: Notification template ID.
         #
         # @param checks [Array<Courier::Models::BaseCheck>] Body param
         #
@@ -32,10 +34,14 @@ module Courier
           )
         end
 
+        # Retrieve the checks for a notification template submission.
+        #
         # @overload list(submission_id, id:, request_options: {})
         #
-        # @param submission_id [String]
-        # @param id [String]
+        # @param submission_id [String] Submission ID.
+        #
+        # @param id [String] Notification template ID.
+        #
         # @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [Courier::Models::Notifications::CheckListResponse]
@@ -55,10 +61,14 @@ module Courier
           )
         end
 
+        # Cancel a notification template submission.
+        #
         # @overload delete(submission_id, id:, request_options: {})
         #
-        # @param submission_id [String]
-        # @param id [String]
+        # @param submission_id [String] Submission ID.
+        #
+        # @param id [String] Notification template ID.
+        #
         # @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [nil]

data/lib/courier/resources/notifications.rb

@@ -14,13 +14,13 @@ module Courier
       #
       # @overload create(notification:, state: nil, request_options: {})
       #
-      # @param notification [Courier::Models::NotificationTemplatePayload] Full document shape used in POST and PUT request bodies, and returned inside the
+      # @param notification [Courier::Models::NotificationTemplatePayload] Core template fields used in POST and PUT request bodies (nested under a `notifi
       #
       # @param state [Symbol, Courier::Models::NotificationTemplateCreateRequest::State] Template state after creation. Case-insensitive input, normalized to uppercase i
       #
       # @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Courier::Models::NotificationTemplateGetResponse]
+      # @return [Courier::Models::NotificationTemplateResponse]
       #
       # @see Courier::Models::NotificationCreateParams
       def create(params)
@@ -29,7 +29,7 @@ module Courier
           method: :post,
           path: "notifications",
           body: parsed,
-          model: Courier::NotificationTemplateGetResponse,
+          model: Courier::NotificationTemplateResponse,
           options: options
         )
       end
@@ -48,7 +48,7 @@ module Courier
       #
       # @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Courier::Models::NotificationTemplateGetResponse]
+      # @return [Courier::Models::NotificationTemplateResponse]
       #
       # @see Courier::Models::NotificationRetrieveParams
       def retrieve(id, params = {})
@@ -58,7 +58,7 @@ module Courier
           method: :get,
           path: ["notifications/%1$s", id],
           query: query,
-          model: Courier::NotificationTemplateGetResponse,
+          model: Courier::NotificationTemplateResponse,
           options: options
         )
       end
@@ -276,13 +276,13 @@ module Courier
       #
       # @param id [String] Template ID (nt\_ prefix).
       #
-      # @param notification [Courier::Models::NotificationTemplatePayload] Full document shape used in POST and PUT request bodies, and returned inside the
+      # @param notification [Courier::Models::NotificationTemplatePayload] Core template fields used in POST and PUT request bodies (nested under a `notifi
       #
       # @param state [Symbol, Courier::Models::NotificationTemplateUpdateRequest::State] Template state after update. Case-insensitive input, normalized to uppercase in
       #
       # @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Courier::Models::NotificationTemplateGetResponse]
+      # @return [Courier::Models::NotificationTemplateResponse]
       #
       # @see Courier::Models::NotificationReplaceParams
       def replace(id, params)
@@ -291,7 +291,7 @@ module Courier
           method: :put,
           path: ["notifications/%1$s", id],
           body: parsed,
-          model: Courier::NotificationTemplateGetResponse,
+          model: Courier::NotificationTemplateResponse,
           options: options
         )
       end

data/lib/courier/version.rb

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

data/lib/courier.rb

@@ -216,7 +216,7 @@ require_relative "courier/models/notifications/check_list_params"
 require_relative "courier/models/notifications/check_list_response"
 require_relative "courier/models/notifications/check_update_params"
 require_relative "courier/models/notifications/check_update_response"
-require_relative "courier/models/notification_template_get_response"
+require_relative "courier/models/notification_template_response"
 require_relative "courier/models/notification_template_state"
 require_relative "courier/models/notification_template_summary"
 require_relative "courier/models/notification_template_version_list_response"

data/rbi/courier/models/notification_list_response.rbi

@@ -89,9 +89,6 @@ module Courier
           sig { returns(T::Array[String]) }
           attr_accessor :event_ids
 
-          sig { returns(String) }
-          attr_accessor :note
-
           sig { returns(Courier::MessageRouting) }
           attr_reader :routing
 
@@ -104,6 +101,12 @@ module Courier
           sig { returns(Integer) }
           attr_accessor :updated_at
 
+          sig { returns(T.nilable(String)) }
+          attr_reader :note
+
+          sig { params(note: String).void }
+          attr_writer :note
+
           sig do
             returns(
               T.nilable(
@@ -131,10 +134,10 @@ module Courier
               id: String,
               created_at: Integer,
               event_ids: T::Array[String],
-              note: String,
               routing: Courier::MessageRouting::OrHash,
               topic_id: String,
               updated_at: Integer,
+              note: String,
               tags:
                 T.nilable(
                   Courier::Models::NotificationListResponse::Result::Notification::Tags::OrHash
@@ -147,10 +150,10 @@ module Courier
             created_at:,
             # Array of event IDs associated with this notification
             event_ids:,
-            note:,
             routing:,
             topic_id:,
             updated_at:,
+            note: nil,
             tags: nil,
             title: nil
           )
@@ -162,10 +165,10 @@ module Courier
                 id: String,
                 created_at: Integer,
                 event_ids: T::Array[String],
-                note: String,
                 routing: Courier::MessageRouting,
                 topic_id: String,
                 updated_at: Integer,
+                note: String,
                 tags:
                   T.nilable(
                     Courier::Models::NotificationListResponse::Result::Notification::Tags

data/rbi/courier/models/notification_template_create_request.rbi

@@ -11,8 +11,8 @@ module Courier
           )
         end
 
-      # Full document shape used in POST and PUT request bodies, and returned inside the
-      # GET response envelope.
+      # Core template fields used in POST and PUT request bodies (nested under a
+      # `notification` key) and returned at the top level in responses.
       sig { returns(Courier::NotificationTemplatePayload) }
       attr_reader :notification
 
@@ -45,8 +45,8 @@ module Courier
         ).returns(T.attached_class)
       end
       def self.new(
-        # Full document shape used in POST and PUT request bodies, and returned inside the
-        # GET response envelope.
+        # Core template fields used in POST and PUT request bodies (nested under a
+        # `notification` key) and returned at the top level in responses.
         notification:,
         # Template state after creation. Case-insensitive input, normalized to uppercase
         # in the response. Defaults to "DRAFT".

data/rbi/courier/models/notification_template_payload.rbi

@@ -65,8 +65,8 @@ module Courier
       sig { returns(T::Array[String]) }
       attr_accessor :tags
 
-      # Full document shape used in POST and PUT request bodies, and returned inside the
-      # GET response envelope.
+      # Core template fields used in POST and PUT request bodies (nested under a
+      # `notification` key) and returned at the top level in responses.
       sig do
         params(
           brand: T.nilable(Courier::NotificationTemplatePayload::Brand::OrHash),

data/rbi/courier/models/notification_template_response.rbi

@@ -0,0 +1,120 @@
+# typed: strong
+
+module Courier
+  module Models
+    class NotificationTemplateResponse < Courier::Models::NotificationTemplatePayload
+      OrHash =
+        T.type_alias do
+          T.any(
+            Courier::NotificationTemplateResponse,
+            Courier::Internal::AnyHash
+          )
+        end
+
+      # The template ID.
+      sig { returns(String) }
+      attr_accessor :id
+
+      # Epoch milliseconds when the template was created.
+      sig { returns(Integer) }
+      attr_accessor :created
+
+      # User ID of the creator.
+      sig { returns(String) }
+      attr_accessor :creator
+
+      # The template state. Always uppercase.
+      sig do
+        returns(Courier::NotificationTemplateResponse::State::TaggedSymbol)
+      end
+      attr_accessor :state
+
+      # Epoch milliseconds of last update.
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :updated
+
+      sig { params(updated: Integer).void }
+      attr_writer :updated
+
+      # User ID of the last updater.
+      sig { returns(T.nilable(String)) }
+      attr_reader :updater
+
+      sig { params(updater: String).void }
+      attr_writer :updater
+
+      # Response for GET /notifications/{id}, POST /notifications, and PUT
+      # /notifications/{id}. Returns all template fields at the top level.
+      sig do
+        params(
+          id: String,
+          created: Integer,
+          creator: String,
+          state: Courier::NotificationTemplateResponse::State::OrSymbol,
+          updated: Integer,
+          updater: String
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The template ID.
+        id:,
+        # Epoch milliseconds when the template was created.
+        created:,
+        # User ID of the creator.
+        creator:,
+        # The template state. Always uppercase.
+        state:,
+        # Epoch milliseconds of last update.
+        updated: nil,
+        # User ID of the last updater.
+        updater: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            id: String,
+            created: Integer,
+            creator: String,
+            state: Courier::NotificationTemplateResponse::State::TaggedSymbol,
+            updated: Integer,
+            updater: String
+          }
+        )
+      end
+      def to_hash
+      end
+
+      # The template state. Always uppercase.
+      module State
+        extend Courier::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Courier::NotificationTemplateResponse::State)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        DRAFT =
+          T.let(
+            :DRAFT,
+            Courier::NotificationTemplateResponse::State::TaggedSymbol
+          )
+        PUBLISHED =
+          T.let(
+            :PUBLISHED,
+            Courier::NotificationTemplateResponse::State::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[Courier::NotificationTemplateResponse::State::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/courier/models/notification_template_update_request.rbi

@@ -11,8 +11,8 @@ module Courier
           )
         end
 
-      # Full document shape used in POST and PUT request bodies, and returned inside the
-      # GET response envelope.
+      # Core template fields used in POST and PUT request bodies (nested under a
+      # `notification` key) and returned at the top level in responses.
       sig { returns(Courier::NotificationTemplatePayload) }
       attr_reader :notification
 
@@ -46,8 +46,8 @@ module Courier
         ).returns(T.attached_class)
       end
       def self.new(
-        # Full document shape used in POST and PUT request bodies, and returned inside the
-        # GET response envelope.
+        # Core template fields used in POST and PUT request bodies (nested under a
+        # `notification` key) and returned at the top level in responses.
         notification:,
         # Template state after update. Case-insensitive input, normalized to uppercase in
         # the response. Defaults to "DRAFT".

data/rbi/courier/models.rbi

@@ -266,14 +266,13 @@ module Courier
   NotificationTemplateCreateRequest =
     Courier::Models::NotificationTemplateCreateRequest
 
-  NotificationTemplateGetResponse =
-    Courier::Models::NotificationTemplateGetResponse
-
   NotificationTemplatePayload = Courier::Models::NotificationTemplatePayload
 
   NotificationTemplatePublishRequest =
     Courier::Models::NotificationTemplatePublishRequest
 
+  NotificationTemplateResponse = Courier::Models::NotificationTemplateResponse
+
   NotificationTemplateState = Courier::Models::NotificationTemplateState
 
   NotificationTemplateSummary = Courier::Models::NotificationTemplateSummary

data/rbi/courier/resources/notifications/checks.rbi

@@ -4,6 +4,7 @@ module Courier
   module Resources
     class Notifications
       class Checks
+        # Replace the checks for a notification template submission.
         sig do
           params(
             submission_id: String,
@@ -13,9 +14,9 @@ module Courier
           ).returns(Courier::Models::Notifications::CheckUpdateResponse)
         end
         def update(
-          # Path param
+          # Path param: Submission ID.
           submission_id,
-          # Path param
+          # Path param: Notification template ID.
           id:,
           # Body param
           checks:,
@@ -23,6 +24,7 @@ module Courier
         )
         end
 
+        # Retrieve the checks for a notification template submission.
         sig do
           params(
             submission_id: String,
@@ -30,9 +32,16 @@ module Courier
             request_options: Courier::RequestOptions::OrHash
           ).returns(Courier::Models::Notifications::CheckListResponse)
         end
-        def list(submission_id, id:, request_options: {})
+        def list(
+          # Submission ID.
+          submission_id,
+          # Notification template ID.
+          id:,
+          request_options: {}
+        )
         end
 
+        # Cancel a notification template submission.
         sig do
           params(
             submission_id: String,
@@ -40,7 +49,13 @@ module Courier
             request_options: Courier::RequestOptions::OrHash
           ).void
         end
-        def delete(submission_id, id:, request_options: {})
+        def delete(
+          # Submission ID.
+          submission_id,
+          # Notification template ID.
+          id:,
+          request_options: {}
+        )
         end
 
         # @api private

data/rbi/courier/resources/notifications.rbi

@@ -13,11 +13,11 @@ module Courier
           notification: Courier::NotificationTemplatePayload::OrHash,
           state: Courier::NotificationTemplateCreateRequest::State::OrSymbol,
           request_options: Courier::RequestOptions::OrHash
-        ).returns(Courier::NotificationTemplateGetResponse)
+        ).returns(Courier::NotificationTemplateResponse)
       end
       def create(
-        # Full document shape used in POST and PUT request bodies, and returned inside the
-        # GET response envelope.
+        # Core template fields used in POST and PUT request bodies (nested under a
+        # `notification` key) and returned at the top level in responses.
         notification:,
         # Template state after creation. Case-insensitive input, normalized to uppercase
         # in the response. Defaults to "DRAFT".
@@ -33,7 +33,7 @@ module Courier
           id: String,
           version: String,
           request_options: Courier::RequestOptions::OrHash
-        ).returns(Courier::NotificationTemplateGetResponse)
+        ).returns(Courier::NotificationTemplateResponse)
       end
       def retrieve(
         # Template ID (nt\_ prefix).
@@ -211,13 +211,13 @@ module Courier
           notification: Courier::NotificationTemplatePayload::OrHash,
           state: Courier::NotificationTemplateUpdateRequest::State::OrSymbol,
           request_options: Courier::RequestOptions::OrHash
-        ).returns(Courier::NotificationTemplateGetResponse)
+        ).returns(Courier::NotificationTemplateResponse)
       end
       def replace(
         # Template ID (nt\_ prefix).
         id,
-        # Full document shape used in POST and PUT request bodies, and returned inside the
-        # GET response envelope.
+        # Core template fields used in POST and PUT request bodies (nested under a
+        # `notification` key) and returned at the top level in responses.
         notification:,
         # Template state after update. Case-insensitive input, normalized to uppercase in
         # the response. Defaults to "DRAFT".

data/sig/courier/models/notification_list_response.rbs

@@ -33,10 +33,10 @@ module Courier
             id: String,
             created_at: Integer,
             event_ids: ::Array[String],
-            note: String,
             routing: Courier::MessageRouting,
             topic_id: String,
             updated_at: Integer,
+            note: String,
             tags: Courier::Models::NotificationListResponse::Result::Notification::Tags?,
             title: String?
           }
@@ -48,14 +48,16 @@ module Courier
 
           attr_accessor event_ids: ::Array[String]
 
-          attr_accessor note: String
-
           attr_accessor routing: Courier::MessageRouting
 
           attr_accessor topic_id: String
 
           attr_accessor updated_at: Integer
 
+          attr_reader note: String?
+
+          def note=: (String) -> String
+
           attr_accessor tags: Courier::Models::NotificationListResponse::Result::Notification::Tags?
 
           attr_accessor title: String?
@@ -64,10 +66,10 @@ module Courier
             id: String,
             created_at: Integer,
             event_ids: ::Array[String],
-            note: String,
             routing: Courier::MessageRouting,
             topic_id: String,
             updated_at: Integer,
+            ?note: String,
             ?tags: Courier::Models::NotificationListResponse::Result::Notification::Tags?,
             ?title: String?
           ) -> void
@@ -76,10 +78,10 @@ module Courier
             id: String,
             created_at: Integer,
             event_ids: ::Array[String],
-            note: String,
             routing: Courier::MessageRouting,
             topic_id: String,
             updated_at: Integer,
+            note: String,
             tags: Courier::Models::NotificationListResponse::Result::Notification::Tags?,
             title: String?
           }

data/sig/courier/models/notification_template_response.rbs

@@ -0,0 +1,70 @@
+module Courier
+  module Models
+    type notification_template_response =
+      {
+        id: String,
+        created: Integer,
+        creator: String,
+        state: Courier::Models::NotificationTemplateResponse::state,
+        updated: Integer,
+        updater: String
+      }
+
+    class NotificationTemplateResponse < Courier::Models::NotificationTemplatePayload
+      def id: -> String
+
+      def id=: (String _) -> String
+
+      def created: -> Integer
+
+      def created=: (Integer _) -> Integer
+
+      def creator: -> String
+
+      def creator=: (String _) -> String
+
+      def state: -> Courier::Models::NotificationTemplateResponse::state
+
+      def state=: (
+        Courier::Models::NotificationTemplateResponse::state _
+      ) -> Courier::Models::NotificationTemplateResponse::state
+
+      def updated: -> Integer?
+
+      def updated=: (Integer _) -> Integer
+
+      def updater: -> String?
+
+      def updater=: (String _) -> String
+
+      def initialize: (
+        id: String,
+        created: Integer,
+        creator: String,
+        state: Courier::Models::NotificationTemplateResponse::state,
+        ?updated: Integer,
+        ?updater: String
+      ) -> void
+
+      def to_hash: -> {
+        id: String,
+        created: Integer,
+        creator: String,
+        state: Courier::Models::NotificationTemplateResponse::state,
+        updated: Integer,
+        updater: String
+      }
+
+      type state = :DRAFT | :PUBLISHED
+
+      module State
+        extend Courier::Internal::Type::Enum
+
+        DRAFT: :DRAFT
+        PUBLISHED: :PUBLISHED
+
+        def self?.values: -> ::Array[Courier::Models::NotificationTemplateResponse::state]
+      end
+    end
+  end
+end

data/sig/courier/models.rbs

@@ -255,12 +255,12 @@ module Courier
 
   class NotificationTemplateCreateRequest = Courier::Models::NotificationTemplateCreateRequest
 
-  class NotificationTemplateGetResponse = Courier::Models::NotificationTemplateGetResponse
-
   class NotificationTemplatePayload = Courier::Models::NotificationTemplatePayload
 
   class NotificationTemplatePublishRequest = Courier::Models::NotificationTemplatePublishRequest
 
+  class NotificationTemplateResponse = Courier::Models::NotificationTemplateResponse
+
   module NotificationTemplateState = Courier::Models::NotificationTemplateState
 
   class NotificationTemplateSummary = Courier::Models::NotificationTemplateSummary

data/sig/courier/resources/notifications.rbs

@@ -7,13 +7,13 @@ module Courier
         notification: Courier::NotificationTemplatePayload,
         ?state: Courier::Models::NotificationTemplateCreateRequest::state,
         ?request_options: Courier::request_opts
-      ) -> Courier::NotificationTemplateGetResponse
+      ) -> Courier::NotificationTemplateResponse
 
       def retrieve: (
         String id,
         ?version: String,
         ?request_options: Courier::request_opts
-      ) -> Courier::NotificationTemplateGetResponse
+      ) -> Courier::NotificationTemplateResponse
 
       def list: (
         ?cursor: String?,
@@ -70,7 +70,7 @@ module Courier
         notification: Courier::NotificationTemplatePayload,
         ?state: Courier::Models::NotificationTemplateUpdateRequest::state,
         ?request_options: Courier::request_opts
-      ) -> Courier::NotificationTemplateGetResponse
+      ) -> Courier::NotificationTemplateResponse
 
       def retrieve_content: (
         String id,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: trycourier
 version: !ruby/object:Gem::Version
-  version: 4.10.1
+  version: 4.10.2
 platform: ruby
 authors:
 - Courier
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-13 00:00:00.000000000 Z
+date: 2026-04-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -219,9 +219,9 @@ files:
 - lib/courier/models/notification_retrieve_content_response.rb
 - lib/courier/models/notification_retrieve_params.rb
 - lib/courier/models/notification_template_create_request.rb
-- lib/courier/models/notification_template_get_response.rb
 - lib/courier/models/notification_template_payload.rb
 - lib/courier/models/notification_template_publish_request.rb
+- lib/courier/models/notification_template_response.rb
 - lib/courier/models/notification_template_state.rb
 - lib/courier/models/notification_template_summary.rb
 - lib/courier/models/notification_template_update_request.rb
@@ -558,9 +558,9 @@ files:
 - rbi/courier/models/notification_retrieve_content_response.rbi
 - rbi/courier/models/notification_retrieve_params.rbi
 - rbi/courier/models/notification_template_create_request.rbi
-- rbi/courier/models/notification_template_get_response.rbi
 - rbi/courier/models/notification_template_payload.rbi
 - rbi/courier/models/notification_template_publish_request.rbi
+- rbi/courier/models/notification_template_response.rbi
 - rbi/courier/models/notification_template_state.rbi
 - rbi/courier/models/notification_template_summary.rbi
 - rbi/courier/models/notification_template_update_request.rbi
@@ -896,9 +896,9 @@ files:
 - sig/courier/models/notification_retrieve_content_response.rbs
 - sig/courier/models/notification_retrieve_params.rbs
 - sig/courier/models/notification_template_create_request.rbs
-- sig/courier/models/notification_template_get_response.rbs
 - sig/courier/models/notification_template_payload.rbs
 - sig/courier/models/notification_template_publish_request.rbs
+- sig/courier/models/notification_template_response.rbs
 - sig/courier/models/notification_template_state.rbs
 - sig/courier/models/notification_template_summary.rbs
 - sig/courier/models/notification_template_update_request.rbs

data/lib/courier/models/notification_template_get_response.rb

@@ -1,92 +0,0 @@
-# frozen_string_literal: true
-
-module Courier
-  module Models
-    # @see Courier::Resources::Notifications#create
-    class NotificationTemplateGetResponse < Courier::Internal::Type::BaseModel
-      # @!attribute created
-      #   Epoch milliseconds when the template was created.
-      #
-      #   @return [Integer]
-      required :created, Integer
-
-      # @!attribute creator
-      #   User ID of the creator.
-      #
-      #   @return [String]
-      required :creator, String
-
-      # @!attribute notification
-      #   Full document shape used in POST and PUT request bodies, and returned inside the
-      #   GET response envelope.
-      #
-      #   @return [Courier::Models::NotificationTemplateGetResponse::Notification]
-      required :notification, -> { Courier::NotificationTemplateGetResponse::Notification }
-
-      # @!attribute state
-      #   The template state. Always uppercase.
-      #
-      #   @return [Symbol, Courier::Models::NotificationTemplateGetResponse::State]
-      required :state, enum: -> { Courier::NotificationTemplateGetResponse::State }
-
-      # @!attribute updated
-      #   Epoch milliseconds of last update.
-      #
-      #   @return [Integer, nil]
-      optional :updated, Integer
-
-      # @!attribute updater
-      #   User ID of the last updater.
-      #
-      #   @return [String, nil]
-      optional :updater, String
-
-      # @!method initialize(created:, creator:, notification:, state:, updated: nil, updater: nil)
-      #   Some parameter documentations has been truncated, see
-      #   {Courier::Models::NotificationTemplateGetResponse} for more details.
-      #
-      #   Envelope response for GET /notifications/{id}. The notification object mirrors
-      #   the POST/PUT input shape. Nullable fields return null when unset.
-      #
-      #   @param created [Integer] Epoch milliseconds when the template was created.
-      #
-      #   @param creator [String] User ID of the creator.
-      #
-      #   @param notification [Courier::Models::NotificationTemplateGetResponse::Notification] Full document shape used in POST and PUT request bodies, and returned inside the
-      #
-      #   @param state [Symbol, Courier::Models::NotificationTemplateGetResponse::State] The template state. Always uppercase.
-      #
-      #   @param updated [Integer] Epoch milliseconds of last update.
-      #
-      #   @param updater [String] User ID of the last updater.
-
-      # @see Courier::Models::NotificationTemplateGetResponse#notification
-      class Notification < Courier::Models::NotificationTemplatePayload
-        # @!attribute id
-        #   The template ID.
-        #
-        #   @return [String]
-        required :id, String
-
-        # @!method initialize(id:)
-        #   Full document shape used in POST and PUT request bodies, and returned inside the
-        #   GET response envelope.
-        #
-        #   @param id [String] The template ID.
-      end
-
-      # The template state. Always uppercase.
-      #
-      # @see Courier::Models::NotificationTemplateGetResponse#state
-      module State
-        extend Courier::Internal::Type::Enum
-
-        DRAFT = :DRAFT
-        PUBLISHED = :PUBLISHED
-
-        # @!method self.values
-        #   @return [Array<Symbol>]
-      end
-    end
-  end
-end

data/rbi/courier/models/notification_template_get_response.rbi

@@ -1,162 +0,0 @@
-# typed: strong
-
-module Courier
-  module Models
-    class NotificationTemplateGetResponse < Courier::Internal::Type::BaseModel
-      OrHash =
-        T.type_alias do
-          T.any(
-            Courier::NotificationTemplateGetResponse,
-            Courier::Internal::AnyHash
-          )
-        end
-
-      # Epoch milliseconds when the template was created.
-      sig { returns(Integer) }
-      attr_accessor :created
-
-      # User ID of the creator.
-      sig { returns(String) }
-      attr_accessor :creator
-
-      # Full document shape used in POST and PUT request bodies, and returned inside the
-      # GET response envelope.
-      sig { returns(Courier::NotificationTemplateGetResponse::Notification) }
-      attr_reader :notification
-
-      sig do
-        params(
-          notification:
-            Courier::NotificationTemplateGetResponse::Notification::OrHash
-        ).void
-      end
-      attr_writer :notification
-
-      # The template state. Always uppercase.
-      sig do
-        returns(Courier::NotificationTemplateGetResponse::State::TaggedSymbol)
-      end
-      attr_accessor :state
-
-      # Epoch milliseconds of last update.
-      sig { returns(T.nilable(Integer)) }
-      attr_reader :updated
-
-      sig { params(updated: Integer).void }
-      attr_writer :updated
-
-      # User ID of the last updater.
-      sig { returns(T.nilable(String)) }
-      attr_reader :updater
-
-      sig { params(updater: String).void }
-      attr_writer :updater
-
-      # Envelope response for GET /notifications/{id}. The notification object mirrors
-      # the POST/PUT input shape. Nullable fields return null when unset.
-      sig do
-        params(
-          created: Integer,
-          creator: String,
-          notification:
-            Courier::NotificationTemplateGetResponse::Notification::OrHash,
-          state: Courier::NotificationTemplateGetResponse::State::OrSymbol,
-          updated: Integer,
-          updater: String
-        ).returns(T.attached_class)
-      end
-      def self.new(
-        # Epoch milliseconds when the template was created.
-        created:,
-        # User ID of the creator.
-        creator:,
-        # Full document shape used in POST and PUT request bodies, and returned inside the
-        # GET response envelope.
-        notification:,
-        # The template state. Always uppercase.
-        state:,
-        # Epoch milliseconds of last update.
-        updated: nil,
-        # User ID of the last updater.
-        updater: nil
-      )
-      end
-
-      sig do
-        override.returns(
-          {
-            created: Integer,
-            creator: String,
-            notification:
-              Courier::NotificationTemplateGetResponse::Notification,
-            state:
-              Courier::NotificationTemplateGetResponse::State::TaggedSymbol,
-            updated: Integer,
-            updater: String
-          }
-        )
-      end
-      def to_hash
-      end
-
-      class Notification < Courier::Models::NotificationTemplatePayload
-        OrHash =
-          T.type_alias do
-            T.any(
-              Courier::NotificationTemplateGetResponse::Notification,
-              Courier::Internal::AnyHash
-            )
-          end
-
-        # The template ID.
-        sig { returns(String) }
-        attr_accessor :id
-
-        # Full document shape used in POST and PUT request bodies, and returned inside the
-        # GET response envelope.
-        sig { params(id: String).returns(T.attached_class) }
-        def self.new(
-          # The template ID.
-          id:
-        )
-        end
-
-        sig { override.returns({ id: String }) }
-        def to_hash
-        end
-      end
-
-      # The template state. Always uppercase.
-      module State
-        extend Courier::Internal::Type::Enum
-
-        TaggedSymbol =
-          T.type_alias do
-            T.all(Symbol, Courier::NotificationTemplateGetResponse::State)
-          end
-        OrSymbol = T.type_alias { T.any(Symbol, String) }
-
-        DRAFT =
-          T.let(
-            :DRAFT,
-            Courier::NotificationTemplateGetResponse::State::TaggedSymbol
-          )
-        PUBLISHED =
-          T.let(
-            :PUBLISHED,
-            Courier::NotificationTemplateGetResponse::State::TaggedSymbol
-          )
-
-        sig do
-          override.returns(
-            T::Array[
-              Courier::NotificationTemplateGetResponse::State::TaggedSymbol
-            ]
-          )
-        end
-        def self.values
-        end
-      end
-    end
-  end
-end

data/sig/courier/models/notification_template_get_response.rbs

@@ -1,72 +0,0 @@
-module Courier
-  module Models
-    type notification_template_get_response =
-      {
-        created: Integer,
-        creator: String,
-        notification: Courier::NotificationTemplateGetResponse::Notification,
-        state: Courier::Models::NotificationTemplateGetResponse::state,
-        updated: Integer,
-        updater: String
-      }
-
-    class NotificationTemplateGetResponse < Courier::Internal::Type::BaseModel
-      attr_accessor created: Integer
-
-      attr_accessor creator: String
-
-      attr_accessor notification: Courier::NotificationTemplateGetResponse::Notification
-
-      attr_accessor state: Courier::Models::NotificationTemplateGetResponse::state
-
-      attr_reader updated: Integer?
-
-      def updated=: (Integer) -> Integer
-
-      attr_reader updater: String?
-
-      def updater=: (String) -> String
-
-      def initialize: (
-        created: Integer,
-        creator: String,
-        notification: Courier::NotificationTemplateGetResponse::Notification,
-        state: Courier::Models::NotificationTemplateGetResponse::state,
-        ?updated: Integer,
-        ?updater: String
-      ) -> void
-
-      def to_hash: -> {
-        created: Integer,
-        creator: String,
-        notification: Courier::NotificationTemplateGetResponse::Notification,
-        state: Courier::Models::NotificationTemplateGetResponse::state,
-        updated: Integer,
-        updater: String
-      }
-
-      type notification = { id: String }
-
-      class Notification < Courier::Models::NotificationTemplatePayload
-        def id: -> String
-
-        def id=: (String _) -> String
-
-        def initialize: (id: String) -> void
-
-        def to_hash: -> { id: String }
-      end
-
-      type state = :DRAFT | :PUBLISHED
-
-      module State
-        extend Courier::Internal::Type::Enum
-
-        DRAFT: :DRAFT
-        PUBLISHED: :PUBLISHED
-
-        def self?.values: -> ::Array[Courier::Models::NotificationTemplateGetResponse::state]
-      end
-    end
-  end
-end