trycourier 6.4.3 → 6.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c8b8d37f136533933d8866b7f9c65690f4a7f97c858fcfe8a59b22f9207258e3
-  data.tar.gz: 5109857a74cebd79366d2cfe314cacebef0c42e6501cfc225e294a7c03e3b9bf
+  metadata.gz: aec72cc2e6e742c57ffd2f2c5f8fde487e6597a34d0351cf4613abc3f369ab07
+  data.tar.gz: 037cfdab670141377df8fa5a5443c24b8d66e98b6ccc56b68c5db6176139bbb9
 SHA512:
-  metadata.gz: 999317f439a918452c23d3e626c1412afc02f921e26d5323d8c56d46d17bff8705edf5ef69c98c47eeb0247dad214e6d74e8c62241c63295da98517e58b5b1fc
-  data.tar.gz: 28ed1d47648060561af1be5579193eb16d52c40a8d460919f046d9617e5d45ae2b34dadc16418822e8f327e442c456e1ea5cd81b3deba123ce95dcdc12346187
+  metadata.gz: f9355b12ee2ed402c0f2e13d1f20b23cf5e3ee63e23e627894f66f517cf0522f866626b28485d3a5c98cfd021869f3fea6aeb3112a3e2208d65abc2733b0b10a
+  data.tar.gz: 45f4b13f45dbb29cdc1ed14845e7ff243fa90f215f45a6c4fcc324a3c725ed750d907da8571e4eb2ccf7b894aa7b9884bba71892454bc0f36f9d0f8036668695

data/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [6.5.0](https://github.com/trycourier/courier-ruby/compare/v6.4.4...v6.5.0) (2026-09-04)
+
+
+### Features
+
+* **api:** document the expiry_date contract and allow boolean patch values ([#148](https://github.com/trycourier/courier-ruby/issues/148)) ([191cec0](https://github.com/trycourier/courier-ruby/commit/191cec0ef235a855add991f9b935c1d90e0239f8))
+
+## [6.4.4](https://github.com/trycourier/courier-ruby/compare/v6.4.3...v6.4.4) (2026-09-03)
+
+
+### Documentation
+
+* **api:** document the channel-block requirement on template creation ([#146](https://github.com/trycourier/courier-ruby/issues/146)) ([95749c6](https://github.com/trycourier/courier-ruby/commit/95749c6db1bd5e1b07d28d1f59970652b5cb2c49))
+
 ## [6.4.3](https://github.com/trycourier/courier-ruby/compare/v6.4.2...v6.4.3) (2026-08-29)
 
 

data/README.md

@@ -9,7 +9,7 @@ Add the gem to your `Gemfile`:
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "trycourier", "~> 6.4.3"
+gem "trycourier", "~> 6.5.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/courier/models/elemental_channel_node.rb

@@ -10,6 +10,16 @@ module Courier
       #   @return [String, nil]
       optional :channel, String
 
+      # @!attribute elements
+      #   An array of elements to apply to the channel. If `raw` has not been specified,
+      #   `elements` is `required`. Channel elements cannot nest, so these are any node
+      #   except another channel block.
+      #
+      #   @return [Array<Courier::Models::ElementalNodeNonChannel::UnionMember0, Courier::Models::ElementalNodeNonChannel::UnionMember1, Courier::Models::ElementalNodeNonChannel::UnionMember2, Courier::Models::ElementalNodeNonChannel::UnionMember3, Courier::Models::ElementalNodeNonChannel::UnionMember4, Courier::Models::ElementalNodeNonChannel::UnionMember5, Courier::Models::ElementalNodeNonChannel::UnionMember6>, nil]
+      optional :elements,
+               -> { Courier::Internal::Type::ArrayOf[union: Courier::ElementalNodeNonChannel] },
+               nil?: true
+
       # @!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`)
@@ -39,7 +49,7 @@ module Courier
       #   @return [Hash{Symbol=>Object}, nil]
       optional :raw, Courier::Internal::Type::HashOf[Courier::Internal::Type::Unknown], nil?: true
 
-      # @!method initialize(channel: nil, font_size: nil, line_height: nil, padding: nil, raw: nil)
+      # @!method initialize(channel: nil, elements: nil, font_size: nil, line_height: nil, padding: nil, raw: nil)
       #   Some parameter documentations has been truncated, see
       #   {Courier::Models::ElementalChannelNode} for more details.
       #
@@ -56,6 +66,8 @@ module Courier
       #
       #   @param channel [String] The channel the contents of this element should be applied to. Can be `email`, `
       #
+      #   @param elements [Array<Courier::Models::ElementalNodeNonChannel::UnionMember0, Courier::Models::ElementalNodeNonChannel::UnionMember1, Courier::Models::ElementalNodeNonChannel::UnionMember2, Courier::Models::ElementalNodeNonChannel::UnionMember3, Courier::Models::ElementalNodeNonChannel::UnionMember4, Courier::Models::ElementalNodeNonChannel::UnionMember5, Courier::Models::ElementalNodeNonChannel::UnionMember6>, nil] An array of elements to apply to the channel. If `raw` has not been
+      #
       #   @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

data/lib/courier/models/elemental_node_non_channel.rb

@@ -0,0 +1,188 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # Any Elemental node except a channel block. Channel elements are only valid as
+    # top-level elements, so the `elements` nested inside one can never be another
+    # channel. Keeping this union channel-free also keeps the schema acyclic; a
+    # recursive `$ref` here breaks the generated Python models.
+    module ElementalNodeNonChannel
+      extend Courier::Internal::Type::Union
+
+      # Represents a body of text to be rendered inside of the notification.
+      variant -> { Courier::ElementalNodeNonChannel::UnionMember0 }
+
+      # The meta element contains information describing the notification that may  be used by a particular channel or provider. One important field is the title  field which will be used as the title for channels that support it.
+      variant -> { Courier::ElementalNodeNonChannel::UnionMember1 }
+
+      # Used to embed an image into the notification.
+      variant -> { Courier::ElementalNodeNonChannel::UnionMember2 }
+
+      # Allows the user to execute an action. Can be a button or a link.
+      variant -> { Courier::ElementalNodeNonChannel::UnionMember3 }
+
+      # Renders a dividing line between elements.
+      variant -> { Courier::ElementalNodeNonChannel::UnionMember4 }
+
+      # Renders a quote block.
+      variant -> { Courier::ElementalNodeNonChannel::UnionMember5 }
+
+      # Raw HTML string inside an Elemental document. When rendering a message, this node is turned into output only for the email channel; for other channels it produces no blocks.
+      variant -> { Courier::ElementalNodeNonChannel::UnionMember6 }
+
+      class UnionMember0 < Courier::Models::ElementalTextNode
+        # @!attribute type
+        #
+        #   @return [Symbol, Courier::Models::ElementalNodeNonChannel::UnionMember0::Type, nil]
+        optional :type, enum: -> { Courier::ElementalNodeNonChannel::UnionMember0::Type }
+
+        # @!method initialize(type: nil)
+        #   Represents a body of text to be rendered inside of the notification.
+        #
+        #   @param type [Symbol, Courier::Models::ElementalNodeNonChannel::UnionMember0::Type]
+
+        module Type
+          extend Courier::Internal::Type::Enum
+
+          TEXT = :text
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+
+      class UnionMember1 < Courier::Models::ElementalMetaNode
+        # @!attribute type
+        #
+        #   @return [Symbol, Courier::Models::ElementalNodeNonChannel::UnionMember1::Type, nil]
+        optional :type, enum: -> { Courier::ElementalNodeNonChannel::UnionMember1::Type }
+
+        # @!method initialize(type: nil)
+        #   The meta element contains information describing the notification that may be
+        #   used by a particular channel or provider. One important field is the title field
+        #   which will be used as the title for channels that support it.
+        #
+        #   @param type [Symbol, Courier::Models::ElementalNodeNonChannel::UnionMember1::Type]
+
+        module Type
+          extend Courier::Internal::Type::Enum
+
+          META = :meta
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+
+      class UnionMember2 < Courier::Models::ElementalImageNode
+        # @!attribute type
+        #
+        #   @return [Symbol, Courier::Models::ElementalNodeNonChannel::UnionMember2::Type, nil]
+        optional :type, enum: -> { Courier::ElementalNodeNonChannel::UnionMember2::Type }
+
+        # @!method initialize(type: nil)
+        #   Used to embed an image into the notification.
+        #
+        #   @param type [Symbol, Courier::Models::ElementalNodeNonChannel::UnionMember2::Type]
+
+        module Type
+          extend Courier::Internal::Type::Enum
+
+          IMAGE = :image
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+
+      class UnionMember3 < Courier::Models::ElementalActionNode
+        # @!attribute type
+        #
+        #   @return [Symbol, Courier::Models::ElementalNodeNonChannel::UnionMember3::Type, nil]
+        optional :type, enum: -> { Courier::ElementalNodeNonChannel::UnionMember3::Type }
+
+        # @!method initialize(type: nil)
+        #   Allows the user to execute an action. Can be a button or a link.
+        #
+        #   @param type [Symbol, Courier::Models::ElementalNodeNonChannel::UnionMember3::Type]
+
+        module Type
+          extend Courier::Internal::Type::Enum
+
+          ACTION = :action
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+
+      class UnionMember4 < Courier::Models::ElementalDividerNode
+        # @!attribute type
+        #
+        #   @return [Symbol, Courier::Models::ElementalNodeNonChannel::UnionMember4::Type, nil]
+        optional :type, enum: -> { Courier::ElementalNodeNonChannel::UnionMember4::Type }
+
+        # @!method initialize(type: nil)
+        #   Renders a dividing line between elements.
+        #
+        #   @param type [Symbol, Courier::Models::ElementalNodeNonChannel::UnionMember4::Type]
+
+        module Type
+          extend Courier::Internal::Type::Enum
+
+          DIVIDER = :divider
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+
+      class UnionMember5 < Courier::Models::ElementalQuoteNode
+        # @!attribute type
+        #
+        #   @return [Symbol, Courier::Models::ElementalNodeNonChannel::UnionMember5::Type, nil]
+        optional :type, enum: -> { Courier::ElementalNodeNonChannel::UnionMember5::Type }
+
+        # @!method initialize(type: nil)
+        #   Renders a quote block.
+        #
+        #   @param type [Symbol, Courier::Models::ElementalNodeNonChannel::UnionMember5::Type]
+
+        module Type
+          extend Courier::Internal::Type::Enum
+
+          QUOTE = :quote
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+
+      class UnionMember6 < Courier::Models::ElementalHTMLNode
+        # @!attribute type
+        #
+        #   @return [Symbol, Courier::Models::ElementalNodeNonChannel::UnionMember6::Type, nil]
+        optional :type, enum: -> { Courier::ElementalNodeNonChannel::UnionMember6::Type }
+
+        # @!method initialize(type: nil)
+        #   Raw HTML string inside an Elemental document. When rendering a message, this
+        #   node is turned into output only for the email channel; for other channels it
+        #   produces no blocks.
+        #
+        #   @param type [Symbol, Courier::Models::ElementalNodeNonChannel::UnionMember6::Type]
+
+        module Type
+          extend Courier::Internal::Type::Enum
+
+          HTML = :html
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+
+      # @!method self.variants
+      #   @return [Array(Courier::Models::ElementalNodeNonChannel::UnionMember0, Courier::Models::ElementalNodeNonChannel::UnionMember1, Courier::Models::ElementalNodeNonChannel::UnionMember2, Courier::Models::ElementalNodeNonChannel::UnionMember3, Courier::Models::ElementalNodeNonChannel::UnionMember4, Courier::Models::ElementalNodeNonChannel::UnionMember5, Courier::Models::ElementalNodeNonChannel::UnionMember6)]
+    end
+  end
+end

data/lib/courier/models/email_footer.rb

@@ -3,19 +3,126 @@
 module Courier
   module Models
     class EmailFooter < Courier::Internal::Type::BaseModel
-      # @!attribute content
-      #
-      #   @return [String, nil]
-      optional :content, String, nil?: true
-
       # @!attribute inherit_default
       #
       #   @return [Boolean, nil]
       optional :inherit_default, Courier::Internal::Type::Boolean, api_name: :inheritDefault, nil?: true
 
-      # @!method initialize(content: nil, inherit_default: nil)
-      #   @param content [String, nil]
+      # @!attribute markdown
+      #   The footer body, as markdown. This is the field the API returns and accepts; it
+      #   is omitted entirely when no footer body is set. Sending null is accepted and
+      #   treated as no footer body.
+      #
+      #   @return [String, nil]
+      optional :markdown, String, nil?: true
+
+      # @!attribute social
+      #   Social links rendered in the email footer.
+      #
+      #   @return [Courier::Models::EmailFooter::Social, nil]
+      optional :social, -> { Courier::EmailFooter::Social }, nil?: true
+
+      # @!method initialize(inherit_default: nil, markdown: nil, social: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Courier::Models::EmailFooter} for more details.
+      #
       #   @param inherit_default [Boolean, nil]
+      #
+      #   @param markdown [String, nil] The footer body, as markdown. This is the field the API returns and accepts; it
+      #
+      #   @param social [Courier::Models::EmailFooter::Social, nil] Social links rendered in the email footer.
+
+      # @see Courier::Models::EmailFooter#social
+      class Social < Courier::Internal::Type::BaseModel
+        # @!attribute facebook
+        #
+        #   @return [Courier::Models::EmailFooter::Social::Facebook, nil]
+        optional :facebook, -> { Courier::EmailFooter::Social::Facebook }, nil?: true
+
+        # @!attribute instagram
+        #
+        #   @return [Courier::Models::EmailFooter::Social::Instagram, nil]
+        optional :instagram, -> { Courier::EmailFooter::Social::Instagram }, nil?: true
+
+        # @!attribute linkedin
+        #
+        #   @return [Courier::Models::EmailFooter::Social::Linkedin, nil]
+        optional :linkedin, -> { Courier::EmailFooter::Social::Linkedin }, nil?: true
+
+        # @!attribute medium
+        #
+        #   @return [Courier::Models::EmailFooter::Social::Medium, nil]
+        optional :medium, -> { Courier::EmailFooter::Social::Medium }, nil?: true
+
+        # @!attribute twitter
+        #
+        #   @return [Courier::Models::EmailFooter::Social::Twitter, nil]
+        optional :twitter, -> { Courier::EmailFooter::Social::Twitter }, nil?: true
+
+        # @!method initialize(facebook: nil, instagram: nil, linkedin: nil, medium: nil, twitter: nil)
+        #   Social links rendered in the email footer.
+        #
+        #   @param facebook [Courier::Models::EmailFooter::Social::Facebook, nil]
+        #   @param instagram [Courier::Models::EmailFooter::Social::Instagram, nil]
+        #   @param linkedin [Courier::Models::EmailFooter::Social::Linkedin, nil]
+        #   @param medium [Courier::Models::EmailFooter::Social::Medium, nil]
+        #   @param twitter [Courier::Models::EmailFooter::Social::Twitter, nil]
+
+        # @see Courier::Models::EmailFooter::Social#facebook
+        class Facebook < Courier::Internal::Type::BaseModel
+          # @!attribute url
+          #
+          #   @return [String, nil]
+          optional :url, String, nil?: true
+
+          # @!method initialize(url: nil)
+          #   @param url [String, nil]
+        end
+
+        # @see Courier::Models::EmailFooter::Social#instagram
+        class Instagram < Courier::Internal::Type::BaseModel
+          # @!attribute url
+          #
+          #   @return [String, nil]
+          optional :url, String, nil?: true
+
+          # @!method initialize(url: nil)
+          #   @param url [String, nil]
+        end
+
+        # @see Courier::Models::EmailFooter::Social#linkedin
+        class Linkedin < Courier::Internal::Type::BaseModel
+          # @!attribute url
+          #
+          #   @return [String, nil]
+          optional :url, String, nil?: true
+
+          # @!method initialize(url: nil)
+          #   @param url [String, nil]
+        end
+
+        # @see Courier::Models::EmailFooter::Social#medium
+        class Medium < Courier::Internal::Type::BaseModel
+          # @!attribute url
+          #
+          #   @return [String, nil]
+          optional :url, String, nil?: true
+
+          # @!method initialize(url: nil)
+          #   @param url [String, nil]
+        end
+
+        # @see Courier::Models::EmailFooter::Social#twitter
+        class Twitter < Courier::Internal::Type::BaseModel
+          # @!attribute url
+          #
+          #   @return [String, nil]
+          optional :url, String, nil?: true
+
+          # @!method initialize(url: nil)
+          #   @param url [String, nil]
+        end
+      end
     end
   end
 end

data/lib/courier/models/notification_template_update_request.rb

@@ -21,9 +21,12 @@ module Courier
       #   Some parameter documentations has been truncated, see
       #   {Courier::Models::NotificationTemplateUpdateRequest} for more details.
       #
-      #   Request body for replacing a notification template. Same shape as create. All
-      #   fields required (PUT = full replacement), except `alias`, whose omission means
-      #   "leave the existing aliases alone".
+      #   Request body for replacing a notification template. All fields are required,
+      #   since `PUT` is a full replacement, except `alias`, whose omission leaves the
+      #   existing aliases in place. Unlike `NotificationTemplateCreateRequest`,
+      #   `notification.content` is not required to place its elements inside a channel
+      #   block: the requirement applies to creation only, so templates already stored
+      #   without one stay editable.
       #
       #   @param notification [Courier::Models::NotificationTemplateWritePayload] Template fields accepted in POST and PUT request bodies, nested under a `notific
       #

data/lib/courier/models/users/token_add_single_params.rb

@@ -30,8 +30,12 @@ module Courier
         optional :device, -> { Courier::Users::TokenAddSingleParams::Device }, nil?: true
 
         # @!attribute expiry_date
-        #   ISO 8601 formatted date the token expires. Defaults to 2 months. Set to false to
-        #   disable expiration.
+        #   When the token expires. Accepts a date, or the boolean `false` to disable
+        #   expiration entirely. ISO 8601 is recommended (for example
+        #   `2026-10-25T00:00:00.000Z`). A value that cannot be parsed as a date is
+        #   rejected; it is not treated as "no expiration" and does not fall back to the
+        #   default. `true` is not a supported value. Omit the field to use the default,
+        #   which expires a token that has not been re-registered for 60 days.
         #
         #   @return [String, Boolean, nil]
         optional :expiry_date, union: -> { Courier::Users::TokenAddSingleParams::ExpiryDate }, nil?: true
@@ -60,7 +64,7 @@ module Courier
         #
         #   @param device [Courier::Models::Users::TokenAddSingleParams::Device, nil] Information about the device the token came from.
         #
-        #   @param expiry_date [String, Boolean, nil] ISO 8601 formatted date the token expires. Defaults to 2 months. Set to false to
+        #   @param expiry_date [String, Boolean, nil] When the token expires. Accepts a date, or the boolean `false` to disable expira
         #
         #   @param properties [Object] Properties about the token.
         #
@@ -133,8 +137,12 @@ module Courier
           #   @param platform [String, nil] The device platform i.e. android, ios, web
         end
 
-        # ISO 8601 formatted date the token expires. Defaults to 2 months. Set to false to
-        # disable expiration.
+        # When the token expires. Accepts a date, or the boolean `false` to disable
+        # expiration entirely. ISO 8601 is recommended (for example
+        # `2026-10-25T00:00:00.000Z`). A value that cannot be parsed as a date is
+        # rejected; it is not treated as "no expiration" and does not fall back to the
+        # default. `true` is not a supported value. Omit the field to use the default,
+        # which expires a token that has not been re-registered for 60 days.
         module ExpiryDate
           extend Courier::Internal::Type::Union
 

data/lib/courier/models/users/token_update_params.rb

@@ -43,17 +43,43 @@ module Courier
           required :path, String
 
           # @!attribute value
-          #   The value for the operation.
+          #   The value for the operation. A string for most fields; boolean `false` when
+          #   disabling token expiration via `expiry_date`, which cannot be expressed as a
+          #   string.
           #
-          #   @return [String, nil]
-          optional :value, String, nil?: true
+          #   @return [String, Boolean, Hash{Symbol=>Object}, nil]
+          optional :value, union: -> { Courier::Users::TokenUpdateParams::Patch::Value }, nil?: true
 
           # @!method initialize(op:, path:, value: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Courier::Models::Users::TokenUpdateParams::Patch} for more details.
+          #
           #   @param op [String] The operation to perform.
           #
           #   @param path [String] The JSON path specifying the part of the profile to operate on.
           #
-          #   @param value [String, nil] The value for the operation.
+          #   @param value [String, Boolean, Hash{Symbol=>Object}, nil] The value for the operation. A string for most fields; boolean `false` when disa
+
+          # The value for the operation. A string for most fields; boolean `false` when
+          # disabling token expiration via `expiry_date`, which cannot be expressed as a
+          # string.
+          #
+          # @see Courier::Models::Users::TokenUpdateParams::Patch#value
+          module Value
+            extend Courier::Internal::Type::Union
+
+            variant String
+
+            variant Courier::Internal::Type::Boolean
+
+            variant -> { Courier::Models::Users::TokenUpdateParams::Patch::Value::UnionMember2Map }
+
+            # @!method self.variants
+            #   @return [Array(String, Boolean, Hash{Symbol=>Object})]
+
+            # @type [Courier::Internal::Type::Converter]
+            UnionMember2Map = Courier::Internal::Type::HashOf[Courier::Internal::Type::Unknown]
+          end
         end
       end
     end

data/lib/courier/models/users/user_token.rb

@@ -22,8 +22,12 @@ module Courier
         optional :device, -> { Courier::Users::UserToken::Device }, nil?: true
 
         # @!attribute expiry_date
-        #   ISO 8601 formatted date the token expires. Defaults to 2 months. Set to false to
-        #   disable expiration.
+        #   When the token expires. Accepts a date, or the boolean `false` to disable
+        #   expiration entirely. ISO 8601 is recommended (for example
+        #   `2026-10-25T00:00:00.000Z`). A value that cannot be parsed as a date is
+        #   rejected; it is not treated as "no expiration" and does not fall back to the
+        #   default. `true` is not a supported value. Omit the field to use the default,
+        #   which expires a token that has not been re-registered for 60 days.
         #
         #   @return [String, Boolean, nil]
         optional :expiry_date, union: -> { Courier::Users::UserToken::ExpiryDate }, nil?: true
@@ -50,7 +54,7 @@ module Courier
         #
         #   @param device [Courier::Models::Users::UserToken::Device, nil] Information about the device the token came from.
         #
-        #   @param expiry_date [String, Boolean, nil] ISO 8601 formatted date the token expires. Defaults to 2 months. Set to false to
+        #   @param expiry_date [String, Boolean, nil] When the token expires. Accepts a date, or the boolean `false` to disable expira
         #
         #   @param properties [Object] Properties about the token.
         #
@@ -123,8 +127,12 @@ module Courier
           #   @param platform [String, nil] The device platform i.e. android, ios, web
         end
 
-        # ISO 8601 formatted date the token expires. Defaults to 2 months. Set to false to
-        # disable expiration.
+        # When the token expires. Accepts a date, or the boolean `false` to disable
+        # expiration entirely. ISO 8601 is recommended (for example
+        # `2026-10-25T00:00:00.000Z`). A value that cannot be parsed as a date is
+        # rejected; it is not treated as "no expiration" and does not fall back to the
+        # default. `true` is not a supported value. Omit the field to use the default,
+        # which expires a token that has not been re-registered for 60 days.
         #
         # @see Courier::Models::Users::UserToken#expiry_date
         module ExpiryDate

data/lib/courier/models.rb

@@ -227,6 +227,8 @@ module Courier
 
   ElementalNode = Courier::Models::ElementalNode
 
+  ElementalNodeNonChannel = Courier::Models::ElementalNodeNonChannel
+
   ElementalQuoteNode = Courier::Models::ElementalQuoteNode
 
   ElementalQuoteNodeWithType = Courier::Models::ElementalQuoteNodeWithType

data/lib/courier/resources/journeys/templates.rb

@@ -12,6 +12,13 @@ module Courier
         # Create a notification template scoped to this journey. Defaults to `DRAFT`
         # state; pass `state: "PUBLISHED"` to publish on create.
         #
+        # The content tree must contain exactly one channel block whose `channel` matches
+        # the `channel` on the request — a journey-scoped template carries a single
+        # channel. Top-level elements, or a block for a different channel, return `400`.
+        # The template designer renders only the channel block matching the tab it draws,
+        # so content stored without one cannot be opened. An empty `elements` array is
+        # accepted.
+        #
         # @overload create(template_id, channel:, notification:, provider_key: nil, state: nil, idempotency_key: nil, x_idempotency_expiration: nil, request_options: {})
         #
         # @param template_id [String] Path param: Journey id

data/lib/courier/resources/notifications.rb

@@ -16,6 +16,16 @@ module Courier
       # Create a notification template. Requires all fields in the notification object.
       # Templates are created in draft state by default.
       #
+      # Content must place its elements inside a channel block —
+      # `{ "type": "channel", "channel": "email", "elements": [...] }` — or the request
+      # returns `400`. The template designer renders only the channel block matching the
+      # tab it draws, so content stored without one cannot be opened. An empty
+      # `elements` array is accepted, and the requirement applies to creation only:
+      # `PUT /notifications/{id}` still accepts unwrapped content. Note this endpoint
+      # takes versioned content only — the `{ title, body }` shorthand accepted by
+      # `/send` is rejected here with an `invalid_request_error` on
+      # `notification.content.version`.
+      #
       # @overload create(notification:, state: nil, idempotency_key: nil, x_idempotency_expiration: nil, request_options: {})
       #
       # @param notification [Courier::Models::NotificationTemplateWritePayload] Body param: Template fields accepted in POST and PUT request bodies, nested unde

data/lib/courier/resources/tenants/templates.rb

@@ -135,6 +135,16 @@ module Courier
         # Creates or updates a notification template scoped to one tenant, letting a
         # tenant override the content the workspace template would send.
         #
+        # This is an upsert: it creates when the tenant has no template under
+        # `template_id`, and updates when it does. On the create half, content must place
+        # its elements inside a channel block —
+        # `{ "type": "channel", "channel": "email", "elements": [...] }` — or the request
+        # returns `400`. The template designer renders only the channel block matching the
+        # tab it draws, so content stored without one cannot be opened. An empty
+        # `elements` array is accepted, as is the `{ title, body }` shorthand, which has
+        # no elements to wrap. Updates are not checked, so tenant templates already stored
+        # without a wrapper stay editable.
+        #
         # @overload replace(template_id, tenant_id:, template:, published: nil, request_options: {})
         #
         # @param template_id [String] Path param: Id of the template to be created or updated.

data/lib/courier/resources/users/tokens.rb

@@ -151,7 +151,7 @@ module Courier
         #
         # @param device [Courier::Models::Users::TokenAddSingleParams::Device, nil] Body param: Information about the device the token came from.
         #
-        # @param expiry_date [String, Boolean, nil] Body param: ISO 8601 formatted date the token expires. Defaults to 2 months. Set
+        # @param expiry_date [String, Boolean, nil] Body param: When the token expires. Accepts a date, or the boolean `false` to di
         #
         # @param properties [Object] Body param: Properties about the token.
         #

data/lib/courier/version.rb

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

data/lib/courier.rb

@@ -189,6 +189,7 @@ require_relative "courier/models/elemental_html_node_with_type"
 require_relative "courier/models/elemental_image_node_with_type"
 require_relative "courier/models/elemental_meta_node_with_type"
 require_relative "courier/models/elemental_node"
+require_relative "courier/models/elemental_node_non_channel"
 require_relative "courier/models/elemental_quote_node_with_type"
 require_relative "courier/models/elemental_text_node_with_type"
 require_relative "courier/models/element_with_checksums"