trycourier 4.24.0 → 4.26.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 92699878aa77a9b29adce8e814e87b0c2369708e4eaff80d4cb39281d2a2fac3
-  data.tar.gz: 47907b5604d18e1f827398c5a24c21b80ed4b1fb4660d7c45c0cf3b15d5f3099
+  metadata.gz: c82d3665f14afda7c4e656a802da5d7e949a73570d969e0ba4963ebca052cafb
+  data.tar.gz: 4e20b157ddb87e3f8bb4699f4010dac082c231550fcd546ecea09c514aae6baf
 SHA512:
-  metadata.gz: 42442c5a895cc9f1403944cef33abf7cb6673ba331d177291b3355239489c5f0fd991bd1201d3867a48e5b28fac32a43dc4de819157ad59639bc69c9a6ddc355
-  data.tar.gz: 3d90bfd02cfa4270aff7e8af390d966137481c6849be7c3062b171675311aa462f3a56272e879b79be6755e1989171ab3bd8e277650b028e5d5cc5a3036216e9
+  metadata.gz: 41b277139739fa601401ff3b160af7f1d501782edc24c1efb0029d8042ec3fdab8580237b1ebae867322fd78f61977787248aab8c112c14341055f1576d6ed94
+  data.tar.gz: 32c6c9dcabd41b05a7773e30c869a16013a695503a76ba75b921447c2ba166c560f806c20842de315b6c188febf6b9a716ffc7a8dd60e857b9a65b471877976c

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 4.26.0 (2026-08-10)
+
+Full Changelog: [v4.25.0...v4.26.0](https://github.com/trycourier/courier-ruby/compare/v4.25.0...v4.26.0)
+
+### Features
+
+* Merge pull request [#185](https://github.com/trycourier/courier-ruby/issues/185) from trycourier/geraldosilva/c-19821-notifications-alias-v2 ([c9a2bd8](https://github.com/trycourier/courier-ruby/commit/c9a2bd82de3f3cca82a5de6430e09e93490b709e))
+
+## 4.25.0 (2026-08-04)
+
+Full Changelog: [v4.24.0...v4.25.0](https://github.com/trycourier/courier-ruby/compare/v4.24.0...v4.25.0)
+
+### Features
+
+* Merge pull request [#178](https://github.com/trycourier/courier-ruby/issues/178) from trycourier/geraldosilva/c-19484-elemental-formatting-controls ([00857bd](https://github.com/trycourier/courier-ruby/commit/00857bd332c959f343c6344b58e4cc19ff916700))
+
 ## 4.24.0 (2026-08-03)
 
 Full Changelog: [v4.23.0...v4.24.0](https://github.com/trycourier/courier-ruby/compare/v4.23.0...v4.24.0)

data/lib/courier/models/elemental_channel_node.rb

@@ -10,6 +10,28 @@ module Courier
       #   @return [String, nil]
       optional :channel, String
 
+      # @!attribute font_size
+      #   Email only. Document-level base font size (CSS px, e.g. `16px`) for body content
+      #   — text, quote, list and action button labels. Heading styles (`h1`/`h2`/`h3`)
+      #   and `subtext` keep their preset sizes.
+      #
+      #   @return [String, nil]
+      optional :font_size, String, nil?: true
+
+      # @!attribute line_height
+      #   Email only. Document-level line height (CSS px or unitless multiplier, e.g.
+      #   `24px` or `1.5`) applied to all body content unless overridden per block.
+      #
+      #   @return [String, nil]
+      optional :line_height, String, nil?: true
+
+      # @!attribute padding
+      #   Email only. Document-level body padding applied once around the email body, as a
+      #   CSS px shorthand (1–4 values), e.g. `48px 64px`.
+      #
+      #   @return [String, nil]
+      optional :padding, String, nil?: true
+
       # @!attribute raw
       #   Raw data to apply to the channel. If `elements` has not been specified, `raw` is
       #   required.
@@ -17,7 +39,7 @@ module Courier
       #   @return [Hash{Symbol=>Object}, nil]
       optional :raw, Courier::Internal::Type::HashOf[Courier::Internal::Type::Unknown], nil?: true
 
-      # @!method initialize(channel: nil, raw: nil)
+      # @!method initialize(channel: nil, font_size: nil, line_height: nil, padding: nil, raw: nil)
       #   Some parameter documentations has been truncated, see
       #   {Courier::Models::ElementalChannelNode} for more details.
       #
@@ -34,6 +56,12 @@ module Courier
       #
       #   @param channel [String] The channel the contents of this element should be applied to. Can be `email`,
       #
+      #   @param font_size [String, nil] Email only. Document-level base font size (CSS px, e.g. `16px`) for body content
+      #
+      #   @param line_height [String, nil] Email only. Document-level line height (CSS px or unitless multiplier, e.g. `24p
+      #
+      #   @param padding [String, nil] Email only. Document-level body padding applied once around the email body, as a
+      #
       #   @param raw [Hash{Symbol=>Object}, nil] Raw data to apply to the channel. If `elements` has not been specified, `raw` is
     end
   end

data/lib/courier/models/notification_template_alias.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # A template's send-time alias as returned by a read, omitted entirely when it has
+    # none. Usually a single string; an array for a template that resolves from
+    # several aliases, which writes through this API can no longer produce — only
+    # templates predating that restriction, or aliases attached outside this API, hold
+    # more than one.
+    module NotificationTemplateAlias
+      extend Courier::Internal::Type::Union
+
+      variant String
+
+      variant -> { Courier::Models::NotificationTemplateAlias::StringArray }
+
+      # @!method self.variants
+      #   @return [Array(String, Array<String>)]
+
+      # @type [Courier::Internal::Type::Converter]
+      StringArray = Courier::Internal::Type::ArrayOf[String]
+    end
+  end
+end

data/lib/courier/models/notification_template_create_request.rb

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

data/lib/courier/models/notification_template_response.rb

@@ -28,6 +28,16 @@ module Courier
       #   @return [Symbol, Courier::Models::NotificationTemplateResponse::State]
       required :state, enum: -> { Courier::NotificationTemplateResponse::State }
 
+      # @!attribute alias_
+      #   A template's send-time alias as returned by a read, omitted entirely when it has
+      #   none. Usually a single string; an array for a template that resolves from
+      #   several aliases, which writes through this API can no longer produce — only
+      #   templates predating that restriction, or aliases attached outside this API, hold
+      #   more than one.
+      #
+      #   @return [String, Array<String>, nil]
+      optional :alias_, union: -> { Courier::NotificationTemplateAlias }, api_name: :alias
+
       # @!attribute updated
       #   Epoch milliseconds of last update.
       #
@@ -40,7 +50,10 @@ module Courier
       #   @return [String, nil]
       optional :updater, String
 
-      # @!method initialize(id:, created:, creator:, state:, updated: nil, updater: nil)
+      # @!method initialize(id:, created:, creator:, state:, alias_: nil, updated: nil, updater: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Courier::Models::NotificationTemplateResponse} for more details.
+      #
       #   Response for GET /notifications/{id}, POST /notifications, and PUT
       #   /notifications/{id}. Returns all template fields at the top level.
       #
@@ -52,6 +65,8 @@ module Courier
       #
       #   @param state [Symbol, Courier::Models::NotificationTemplateResponse::State] The template state. Always uppercase.
       #
+      #   @param alias_ [String, Array<String>] A template's send-time alias as returned by a read, omitted entirely when it has
+      #
       #   @param updated [Integer] Epoch milliseconds of last update.
       #
       #   @param updater [String] User ID of the last updater.

data/lib/courier/models/notification_template_update_request.rb

@@ -4,11 +4,11 @@ module Courier
   module Models
     class NotificationTemplateUpdateRequest < Courier::Internal::Type::BaseModel
       # @!attribute notification
-      #   Core template fields used in POST and PUT request bodies (nested under a
-      #   `notification` key) and returned at the top level in responses.
+      #   Template fields accepted in POST and PUT request bodies, nested under a
+      #   `notification` key.
       #
-      #   @return [Courier::Models::NotificationTemplatePayload]
-      required :notification, -> { Courier::NotificationTemplatePayload }
+      #   @return [Courier::Models::NotificationTemplateWritePayload]
+      required :notification, -> { Courier::NotificationTemplateWritePayload }
 
       # @!attribute state
       #   Template state after update. Case-insensitive input, normalized to uppercase in
@@ -22,9 +22,10 @@ module Courier
       #   {Courier::Models::NotificationTemplateUpdateRequest} for more details.
       #
       #   Request body for replacing a notification template. Same shape as create. All
-      #   fields required (PUT = full replacement).
+      #   fields required (PUT = full replacement), except `alias`, whose omission means
+      #   "leave the existing aliases alone".
       #
-      #   @param notification [Courier::Models::NotificationTemplatePayload] Core template fields used in POST and PUT request bodies (nested under a `notifi
+      #   @param notification [Courier::Models::NotificationTemplateWritePayload] Template fields accepted in POST and PUT request bodies, nested under a `notific
       #
       #   @param state [Symbol, Courier::Models::NotificationTemplateUpdateRequest::State] Template state after update. Case-insensitive input, normalized to uppercase in
 

data/lib/courier/models/notification_template_write_payload.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    class NotificationTemplateWritePayload < Courier::Models::NotificationTemplatePayload
+      # @!attribute alias_
+      #   Send-time alias for this template — the value you pass as `event` to POST /send.
+      #   Writes accept a single alias only. Optional, with three distinct meanings. Omit
+      #   it to leave any existing aliases untouched. Send a string to make this the
+      #   template's only alias — a template that already resolved from several aliases
+      #   keeps just this one and the rest are detached. Send null to remove every alias
+      #   from the template. An alias may not be claimed by another template — doing so
+      #   returns 409 — and may not begin with "tenant/".
+      #
+      #   @return [String, nil]
+      optional :alias_, String, api_name: :alias, nil?: true
+
+      # @!method initialize(alias_: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Courier::Models::NotificationTemplateWritePayload} for more details.
+      #
+      #   Template fields accepted in POST and PUT request bodies, nested under a
+      #   `notification` key.
+      #
+      #   @param alias_ [String, nil] Send-time alias for this template — the value you pass as `event` to POST /send.
+    end
+  end
+end

data/lib/courier/models.rb

@@ -406,6 +406,8 @@ module Courier
 
   Notifications = Courier::Models::Notifications
 
+  NotificationTemplateAlias = Courier::Models::NotificationTemplateAlias
+
   NotificationTemplateCreateRequest = Courier::Models::NotificationTemplateCreateRequest
 
   NotificationTemplatePayload = Courier::Models::NotificationTemplatePayload
@@ -422,6 +424,8 @@ module Courier
 
   NotificationTemplateVersionListResponse = Courier::Models::NotificationTemplateVersionListResponse
 
+  NotificationTemplateWritePayload = Courier::Models::NotificationTemplateWritePayload
+
   Pagerduty = Courier::Models::Pagerduty
 
   PagerdutyRecipient = Courier::Models::PagerdutyRecipient

data/lib/courier/resources/notifications.rb

@@ -18,7 +18,7 @@ module Courier
       #
       # @overload create(notification:, state: nil, idempotency_key: nil, x_idempotency_expiration: nil, request_options: {})
       #
-      # @param notification [Courier::Models::NotificationTemplatePayload] Body param: Core template fields used in POST and PUT request bodies (nested und
+      # @param notification [Courier::Models::NotificationTemplateWritePayload] Body param: Template fields accepted in POST and PUT request bodies, nested unde
       #
       # @param state [Symbol, Courier::Models::NotificationTemplateCreateRequest::State] Body param: Template state after creation. Case-insensitive input, normalized to
       #
@@ -321,7 +321,7 @@ module Courier
       #
       # @param id [String] Template ID (nt\_ prefix).
       #
-      # @param notification [Courier::Models::NotificationTemplatePayload] Core template fields used in POST and PUT request bodies (nested under a `notifi
+      # @param notification [Courier::Models::NotificationTemplateWritePayload] Template fields accepted in POST and PUT request bodies, nested under a `notific
       #
       # @param state [Symbol, Courier::Models::NotificationTemplateUpdateRequest::State] Template state after update. Case-insensitive input, normalized to uppercase in
       #

data/lib/courier/version.rb

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

data/lib/courier.rb

@@ -287,10 +287,12 @@ 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_alias"
 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"
+require_relative "courier/models/notification_template_write_payload"
 require_relative "courier/models/pagerduty"
 require_relative "courier/models/pagerduty_recipient"
 require_relative "courier/models/paging"

data/rbi/courier/models/elemental_channel_node.rbi

@@ -16,6 +16,22 @@ module Courier
       sig { params(channel: String).void }
       attr_writer :channel
 
+      # Email only. Document-level base font size (CSS px, e.g. `16px`) for body content
+      # — text, quote, list and action button labels. Heading styles (`h1`/`h2`/`h3`)
+      # and `subtext` keep their preset sizes.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :font_size
+
+      # Email only. Document-level line height (CSS px or unitless multiplier, e.g.
+      # `24px` or `1.5`) applied to all body content unless overridden per block.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :line_height
+
+      # Email only. Document-level body padding applied once around the email body, as a
+      # CSS px shorthand (1–4 values), e.g. `48px 64px`.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :padding
+
       # Raw data to apply to the channel. If `elements` has not been specified, `raw` is
       # required.
       sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
@@ -34,6 +50,9 @@ module Courier
       sig do
         params(
           channel: String,
+          font_size: T.nilable(String),
+          line_height: T.nilable(String),
+          padding: T.nilable(String),
           raw: T.nilable(T::Hash[Symbol, T.anything])
         ).returns(T.attached_class)
       end
@@ -41,6 +60,16 @@ module Courier
         # The channel the contents of this element should be applied to. Can be `email`,
         # `push`, `direct_message`, `sms` or a provider such as slack
         channel: nil,
+        # Email only. Document-level base font size (CSS px, e.g. `16px`) for body content
+        # — text, quote, list and action button labels. Heading styles (`h1`/`h2`/`h3`)
+        # and `subtext` keep their preset sizes.
+        font_size: nil,
+        # Email only. Document-level line height (CSS px or unitless multiplier, e.g.
+        # `24px` or `1.5`) applied to all body content unless overridden per block.
+        line_height: nil,
+        # Email only. Document-level body padding applied once around the email body, as a
+        # CSS px shorthand (1–4 values), e.g. `48px 64px`.
+        padding: nil,
         # Raw data to apply to the channel. If `elements` has not been specified, `raw` is
         # required.
         raw: nil
@@ -49,7 +78,13 @@ module Courier
 
       sig do
         override.returns(
-          { channel: String, raw: T.nilable(T::Hash[Symbol, T.anything]) }
+          {
+            channel: String,
+            font_size: T.nilable(String),
+            line_height: T.nilable(String),
+            padding: T.nilable(String),
+            raw: T.nilable(T::Hash[Symbol, T.anything])
+          }
         )
       end
       def to_hash

data/rbi/courier/models/notification_template_alias.rbi

@@ -0,0 +1,28 @@
+# typed: strong
+
+module Courier
+  module Models
+    # A template's send-time alias as returned by a read, omitted entirely when it has
+    # none. Usually a single string; an array for a template that resolves from
+    # several aliases, which writes through this API can no longer produce — only
+    # templates predating that restriction, or aliases attached outside this API, hold
+    # more than one.
+    module NotificationTemplateAlias
+      extend Courier::Internal::Type::Union
+
+      Variants = T.type_alias { T.any(String, T::Array[String]) }
+
+      sig do
+        override.returns(T::Array[Courier::NotificationTemplateAlias::Variants])
+      end
+      def self.variants
+      end
+
+      StringArray =
+        T.let(
+          Courier::Internal::Type::ArrayOf[String],
+          Courier::Internal::Type::Converter
+        )
+    end
+  end
+end

data/rbi/courier/models/notification_template_create_request.rbi

@@ -11,13 +11,15 @@ module Courier
           )
         end
 
-      # 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) }
+      # Template fields accepted in POST and PUT request bodies, nested under a
+      # `notification` key.
+      sig { returns(Courier::NotificationTemplateWritePayload) }
       attr_reader :notification
 
       sig do
-        params(notification: Courier::NotificationTemplatePayload::OrHash).void
+        params(
+          notification: Courier::NotificationTemplateWritePayload::OrHash
+        ).void
       end
       attr_writer :notification
 
@@ -40,13 +42,13 @@ module Courier
       # Request body for creating a notification template.
       sig do
         params(
-          notification: Courier::NotificationTemplatePayload::OrHash,
+          notification: Courier::NotificationTemplateWritePayload::OrHash,
           state: Courier::NotificationTemplateCreateRequest::State::OrSymbol
         ).returns(T.attached_class)
       end
       def self.new(
-        # Core template fields used in POST and PUT request bodies (nested under a
-        # `notification` key) and returned at the top level in responses.
+        # Template fields accepted in POST and PUT request bodies, nested under a
+        # `notification` key.
         notification:,
         # Template state after creation. Case-insensitive input, normalized to uppercase
         # in the response. Defaults to "DRAFT".
@@ -57,7 +59,7 @@ module Courier
       sig do
         override.returns(
           {
-            notification: Courier::NotificationTemplatePayload,
+            notification: Courier::NotificationTemplateWritePayload,
             state: Courier::NotificationTemplateCreateRequest::State::OrSymbol
           }
         )

data/rbi/courier/models/notification_template_response.rbi

@@ -29,6 +29,17 @@ module Courier
       end
       attr_accessor :state
 
+      # A template's send-time alias as returned by a read, omitted entirely when it has
+      # none. Usually a single string; an array for a template that resolves from
+      # several aliases, which writes through this API can no longer produce — only
+      # templates predating that restriction, or aliases attached outside this API, hold
+      # more than one.
+      sig { returns(T.nilable(Courier::NotificationTemplateAlias::Variants)) }
+      attr_reader :alias_
+
+      sig { params(alias_: Courier::NotificationTemplateAlias::Variants).void }
+      attr_writer :alias_
+
       # Epoch milliseconds of last update.
       sig { returns(T.nilable(Integer)) }
       attr_reader :updated
@@ -51,6 +62,7 @@ module Courier
           created: Integer,
           creator: String,
           state: Courier::NotificationTemplateResponse::State::OrSymbol,
+          alias_: Courier::NotificationTemplateAlias::Variants,
           updated: Integer,
           updater: String
         ).returns(T.attached_class)
@@ -64,6 +76,12 @@ module Courier
         creator:,
         # The template state. Always uppercase.
         state:,
+        # A template's send-time alias as returned by a read, omitted entirely when it has
+        # none. Usually a single string; an array for a template that resolves from
+        # several aliases, which writes through this API can no longer produce — only
+        # templates predating that restriction, or aliases attached outside this API, hold
+        # more than one.
+        alias_: nil,
         # Epoch milliseconds of last update.
         updated: nil,
         # User ID of the last updater.
@@ -78,6 +96,7 @@ module Courier
             created: Integer,
             creator: String,
             state: Courier::NotificationTemplateResponse::State::TaggedSymbol,
+            alias_: Courier::NotificationTemplateAlias::Variants,
             updated: Integer,
             updater: String
           }

data/rbi/courier/models/notification_template_update_request.rbi

@@ -11,13 +11,15 @@ module Courier
           )
         end
 
-      # 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) }
+      # Template fields accepted in POST and PUT request bodies, nested under a
+      # `notification` key.
+      sig { returns(Courier::NotificationTemplateWritePayload) }
       attr_reader :notification
 
       sig do
-        params(notification: Courier::NotificationTemplatePayload::OrHash).void
+        params(
+          notification: Courier::NotificationTemplateWritePayload::OrHash
+        ).void
       end
       attr_writer :notification
 
@@ -38,16 +40,17 @@ module Courier
       attr_writer :state
 
       # Request body for replacing a notification template. Same shape as create. All
-      # fields required (PUT = full replacement).
+      # fields required (PUT = full replacement), except `alias`, whose omission means
+      # "leave the existing aliases alone".
       sig do
         params(
-          notification: Courier::NotificationTemplatePayload::OrHash,
+          notification: Courier::NotificationTemplateWritePayload::OrHash,
           state: Courier::NotificationTemplateUpdateRequest::State::OrSymbol
         ).returns(T.attached_class)
       end
       def self.new(
-        # Core template fields used in POST and PUT request bodies (nested under a
-        # `notification` key) and returned at the top level in responses.
+        # Template fields accepted in POST and PUT request bodies, nested under a
+        # `notification` key.
         notification:,
         # Template state after update. Case-insensitive input, normalized to uppercase in
         # the response. Defaults to "DRAFT".
@@ -58,7 +61,7 @@ module Courier
       sig do
         override.returns(
           {
-            notification: Courier::NotificationTemplatePayload,
+            notification: Courier::NotificationTemplateWritePayload,
             state: Courier::NotificationTemplateUpdateRequest::State::OrSymbol
           }
         )

data/rbi/courier/models/notification_template_write_payload.rbi

@@ -0,0 +1,44 @@
+# typed: strong
+
+module Courier
+  module Models
+    class NotificationTemplateWritePayload < Courier::Models::NotificationTemplatePayload
+      OrHash =
+        T.type_alias do
+          T.any(
+            Courier::NotificationTemplateWritePayload,
+            Courier::Internal::AnyHash
+          )
+        end
+
+      # Send-time alias for this template — the value you pass as `event` to POST /send.
+      # Writes accept a single alias only. Optional, with three distinct meanings. Omit
+      # it to leave any existing aliases untouched. Send a string to make this the
+      # template's only alias — a template that already resolved from several aliases
+      # keeps just this one and the rest are detached. Send null to remove every alias
+      # from the template. An alias may not be claimed by another template — doing so
+      # returns 409 — and may not begin with "tenant/".
+      sig { returns(T.nilable(String)) }
+      attr_accessor :alias_
+
+      # Template fields accepted in POST and PUT request bodies, nested under a
+      # `notification` key.
+      sig { params(alias_: T.nilable(String)).returns(T.attached_class) }
+      def self.new(
+        # Send-time alias for this template — the value you pass as `event` to POST /send.
+        # Writes accept a single alias only. Optional, with three distinct meanings. Omit
+        # it to leave any existing aliases untouched. Send a string to make this the
+        # template's only alias — a template that already resolved from several aliases
+        # keeps just this one and the rest are detached. Send null to remove every alias
+        # from the template. An alias may not be claimed by another template — doing so
+        # returns 409 — and may not begin with "tenant/".
+        alias_: nil
+      )
+      end
+
+      sig { override.returns({ alias_: T.nilable(String) }) }
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/courier/models.rbi

@@ -378,6 +378,8 @@ module Courier
 
   Notifications = Courier::Models::Notifications
 
+  NotificationTemplateAlias = Courier::Models::NotificationTemplateAlias
+
   NotificationTemplateCreateRequest =
     Courier::Models::NotificationTemplateCreateRequest
 
@@ -398,6 +400,9 @@ module Courier
   NotificationTemplateVersionListResponse =
     Courier::Models::NotificationTemplateVersionListResponse
 
+  NotificationTemplateWritePayload =
+    Courier::Models::NotificationTemplateWritePayload
+
   Pagerduty = Courier::Models::Pagerduty
 
   PagerdutyRecipient = Courier::Models::PagerdutyRecipient

data/rbi/courier/resources/notifications.rbi

@@ -14,7 +14,7 @@ module Courier
       # Templates are created in draft state by default.
       sig do
         params(
-          notification: Courier::NotificationTemplatePayload::OrHash,
+          notification: Courier::NotificationTemplateWritePayload::OrHash,
           state: Courier::NotificationTemplateCreateRequest::State::OrSymbol,
           idempotency_key: String,
           x_idempotency_expiration: String,
@@ -22,8 +22,8 @@ module Courier
         ).returns(Courier::NotificationTemplateResponse)
       end
       def create(
-        # Body param: Core template fields used in POST and PUT request bodies (nested
-        # under a `notification` key) and returned at the top level in responses.
+        # Body param: Template fields accepted in POST and PUT request bodies, nested
+        # under a `notification` key.
         notification:,
         # Body param: Template state after creation. Case-insensitive input, normalized to
         # uppercase in the response. Defaults to "DRAFT".
@@ -259,7 +259,7 @@ module Courier
       sig do
         params(
           id: String,
-          notification: Courier::NotificationTemplatePayload::OrHash,
+          notification: Courier::NotificationTemplateWritePayload::OrHash,
           state: Courier::NotificationTemplateUpdateRequest::State::OrSymbol,
           request_options: Courier::RequestOptions::OrHash
         ).returns(Courier::NotificationTemplateResponse)
@@ -267,8 +267,8 @@ module Courier
       def replace(
         # Template ID (nt\_ prefix).
         id,
-        # Core template fields used in POST and PUT request bodies (nested under a
-        # `notification` key) and returned at the top level in responses.
+        # Template fields accepted in POST and PUT request bodies, nested under a
+        # `notification` key.
         notification:,
         # Template state after update. Case-insensitive input, normalized to uppercase in
         # the response. Defaults to "DRAFT".

data/sig/courier/models/elemental_channel_node.rbs

@@ -1,19 +1,50 @@
 module Courier
   module Models
-    type elemental_channel_node = { channel: String, raw: ::Hash[Symbol, top]? }
+    type elemental_channel_node =
+      {
+        channel: String,
+        font_size: String?,
+        line_height: String?,
+        padding: String?,
+        raw: ::Hash[Symbol, top]?
+      }
 
     class ElementalChannelNode < Courier::Models::ElementalBaseNode
       def channel: -> String?
 
       def channel=: (String _) -> String
 
+      def font_size: -> String?
+
+      def font_size=: (String? _) -> String?
+
+      def line_height: -> String?
+
+      def line_height=: (String? _) -> String?
+
+      def padding: -> String?
+
+      def padding=: (String? _) -> String?
+
       def raw: -> ::Hash[Symbol, top]?
 
       def raw=: (::Hash[Symbol, top]? _) -> ::Hash[Symbol, top]?
 
-      def initialize: (?channel: String, ?raw: ::Hash[Symbol, top]?) -> void
+      def initialize: (
+        ?channel: String,
+        ?font_size: String?,
+        ?line_height: String?,
+        ?padding: String?,
+        ?raw: ::Hash[Symbol, top]?
+      ) -> void
 
-      def to_hash: -> { channel: String, raw: ::Hash[Symbol, top]? }
+      def to_hash: -> {
+        channel: String,
+        font_size: String?,
+        line_height: String?,
+        padding: String?,
+        raw: ::Hash[Symbol, top]?
+      }
     end
   end
 end

data/sig/courier/models/notification_template_alias.rbs

@@ -0,0 +1,13 @@
+module Courier
+  module Models
+    type notification_template_alias = String | ::Array[String]
+
+    module NotificationTemplateAlias
+      extend Courier::Internal::Type::Union
+
+      def self?.variants: -> ::Array[Courier::Models::notification_template_alias]
+
+      StringArray: Courier::Internal::Type::Converter
+    end
+  end
+end

data/sig/courier/models/notification_template_create_request.rbs

@@ -2,12 +2,12 @@ module Courier
   module Models
     type notification_template_create_request =
       {
-        notification: Courier::NotificationTemplatePayload,
+        notification: Courier::NotificationTemplateWritePayload,
         state: Courier::Models::NotificationTemplateCreateRequest::state
       }
 
     class NotificationTemplateCreateRequest < Courier::Internal::Type::BaseModel
-      attr_accessor notification: Courier::NotificationTemplatePayload
+      attr_accessor notification: Courier::NotificationTemplateWritePayload
 
       attr_reader state: Courier::Models::NotificationTemplateCreateRequest::state?
 
@@ -16,12 +16,12 @@ module Courier
       ) -> Courier::Models::NotificationTemplateCreateRequest::state
 
       def initialize: (
-        notification: Courier::NotificationTemplatePayload,
+        notification: Courier::NotificationTemplateWritePayload,
         ?state: Courier::Models::NotificationTemplateCreateRequest::state
       ) -> void
 
       def to_hash: -> {
-        notification: Courier::NotificationTemplatePayload,
+        notification: Courier::NotificationTemplateWritePayload,
         state: Courier::Models::NotificationTemplateCreateRequest::state
       }
 

data/sig/courier/models/notification_template_response.rbs

@@ -6,6 +6,7 @@ module Courier
         created: Integer,
         creator: String,
         state: Courier::Models::NotificationTemplateResponse::state,
+        alias_: Courier::Models::notification_template_alias,
         updated: Integer,
         updater: String
       }
@@ -29,6 +30,12 @@ module Courier
         Courier::Models::NotificationTemplateResponse::state _
       ) -> Courier::Models::NotificationTemplateResponse::state
 
+      def alias_: -> Courier::Models::notification_template_alias?
+
+      def alias_=: (
+        Courier::Models::notification_template_alias _
+      ) -> Courier::Models::notification_template_alias
+
       def updated: -> Integer?
 
       def updated=: (Integer _) -> Integer
@@ -42,6 +49,7 @@ module Courier
         created: Integer,
         creator: String,
         state: Courier::Models::NotificationTemplateResponse::state,
+        ?alias_: Courier::Models::notification_template_alias,
         ?updated: Integer,
         ?updater: String
       ) -> void
@@ -51,6 +59,7 @@ module Courier
         created: Integer,
         creator: String,
         state: Courier::Models::NotificationTemplateResponse::state,
+        alias_: Courier::Models::notification_template_alias,
         updated: Integer,
         updater: String
       }

data/sig/courier/models/notification_template_update_request.rbs

@@ -2,12 +2,12 @@ module Courier
   module Models
     type notification_template_update_request =
       {
-        notification: Courier::NotificationTemplatePayload,
+        notification: Courier::NotificationTemplateWritePayload,
         state: Courier::Models::NotificationTemplateUpdateRequest::state
       }
 
     class NotificationTemplateUpdateRequest < Courier::Internal::Type::BaseModel
-      attr_accessor notification: Courier::NotificationTemplatePayload
+      attr_accessor notification: Courier::NotificationTemplateWritePayload
 
       attr_reader state: Courier::Models::NotificationTemplateUpdateRequest::state?
 
@@ -16,12 +16,12 @@ module Courier
       ) -> Courier::Models::NotificationTemplateUpdateRequest::state
 
       def initialize: (
-        notification: Courier::NotificationTemplatePayload,
+        notification: Courier::NotificationTemplateWritePayload,
         ?state: Courier::Models::NotificationTemplateUpdateRequest::state
       ) -> void
 
       def to_hash: -> {
-        notification: Courier::NotificationTemplatePayload,
+        notification: Courier::NotificationTemplateWritePayload,
         state: Courier::Models::NotificationTemplateUpdateRequest::state
       }
 

data/sig/courier/models/notification_template_write_payload.rbs

@@ -0,0 +1,15 @@
+module Courier
+  module Models
+    type notification_template_write_payload = { alias_: String? }
+
+    class NotificationTemplateWritePayload < Courier::Models::NotificationTemplatePayload
+      def alias_: -> String?
+
+      def alias_=: (String? _) -> String?
+
+      def initialize: (?alias_: String?) -> void
+
+      def to_hash: -> { alias_: String? }
+    end
+  end
+end

data/sig/courier/models.rbs

@@ -363,6 +363,8 @@ module Courier
 
   module Notifications = Courier::Models::Notifications
 
+  module NotificationTemplateAlias = Courier::Models::NotificationTemplateAlias
+
   class NotificationTemplateCreateRequest = Courier::Models::NotificationTemplateCreateRequest
 
   class NotificationTemplatePayload = Courier::Models::NotificationTemplatePayload
@@ -379,6 +381,8 @@ module Courier
 
   class NotificationTemplateVersionListResponse = Courier::Models::NotificationTemplateVersionListResponse
 
+  class NotificationTemplateWritePayload = Courier::Models::NotificationTemplateWritePayload
+
   class Pagerduty = Courier::Models::Pagerduty
 
   class PagerdutyRecipient = Courier::Models::PagerdutyRecipient

data/sig/courier/resources/notifications.rbs

@@ -4,7 +4,7 @@ module Courier
       attr_reader checks: Courier::Resources::Notifications::Checks
 
       def create: (
-        notification: Courier::NotificationTemplatePayload,
+        notification: Courier::NotificationTemplateWritePayload,
         ?state: Courier::Models::NotificationTemplateCreateRequest::state,
         ?idempotency_key: String,
         ?x_idempotency_expiration: String,
@@ -76,7 +76,7 @@ module Courier
 
       def replace: (
         String id,
-        notification: Courier::NotificationTemplatePayload,
+        notification: Courier::NotificationTemplateWritePayload,
         ?state: Courier::Models::NotificationTemplateUpdateRequest::state,
         ?request_options: Courier::request_opts
       ) -> Courier::NotificationTemplateResponse

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: trycourier
 version: !ruby/object:Gem::Version
-  version: 4.24.0
+  version: 4.26.0
 platform: ruby
 authors:
 - Courier
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-03 00:00:00.000000000 Z
+date: 2026-08-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -281,6 +281,7 @@ files:
 - lib/courier/models/notification_retrieve_content_params.rb
 - lib/courier/models/notification_retrieve_content_response.rb
 - lib/courier/models/notification_retrieve_params.rb
+- lib/courier/models/notification_template_alias.rb
 - lib/courier/models/notification_template_create_request.rb
 - lib/courier/models/notification_template_payload.rb
 - lib/courier/models/notification_template_publish_request.rb
@@ -289,6 +290,7 @@ files:
 - lib/courier/models/notification_template_summary.rb
 - lib/courier/models/notification_template_update_request.rb
 - lib/courier/models/notification_template_version_list_response.rb
+- lib/courier/models/notification_template_write_payload.rb
 - lib/courier/models/notifications/check_delete_params.rb
 - lib/courier/models/notifications/check_list_params.rb
 - lib/courier/models/notifications/check_list_response.rb
@@ -719,6 +721,7 @@ files:
 - rbi/courier/models/notification_retrieve_content_params.rbi
 - rbi/courier/models/notification_retrieve_content_response.rbi
 - rbi/courier/models/notification_retrieve_params.rbi
+- rbi/courier/models/notification_template_alias.rbi
 - rbi/courier/models/notification_template_create_request.rbi
 - rbi/courier/models/notification_template_payload.rbi
 - rbi/courier/models/notification_template_publish_request.rbi
@@ -727,6 +730,7 @@ files:
 - rbi/courier/models/notification_template_summary.rbi
 - rbi/courier/models/notification_template_update_request.rbi
 - rbi/courier/models/notification_template_version_list_response.rbi
+- rbi/courier/models/notification_template_write_payload.rbi
 - rbi/courier/models/notifications/check_delete_params.rbi
 - rbi/courier/models/notifications/check_list_params.rbi
 - rbi/courier/models/notifications/check_list_response.rbi
@@ -1156,6 +1160,7 @@ files:
 - sig/courier/models/notification_retrieve_content_params.rbs
 - sig/courier/models/notification_retrieve_content_response.rbs
 - sig/courier/models/notification_retrieve_params.rbs
+- sig/courier/models/notification_template_alias.rbs
 - sig/courier/models/notification_template_create_request.rbs
 - sig/courier/models/notification_template_payload.rbs
 - sig/courier/models/notification_template_publish_request.rbs
@@ -1164,6 +1169,7 @@ files:
 - sig/courier/models/notification_template_summary.rbs
 - sig/courier/models/notification_template_update_request.rbs
 - sig/courier/models/notification_template_version_list_response.rbs
+- sig/courier/models/notification_template_write_payload.rbs
 - sig/courier/models/notifications/check_delete_params.rbs
 - sig/courier/models/notifications/check_list_params.rbs
 - sig/courier/models/notifications/check_list_response.rbs