trycourier 4.8.0 → 4.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 453a5c5183a4ecfeebab4f86e963ac204c115741c2fedb0f32156b1a6aff23f0
-  data.tar.gz: 4db69717cb3bdcd63d2eae022325c4ae14fe8a1203cec1a7212628c3804242ce
+  metadata.gz: 3402c91918996a99ee5f6847167c87f49ca1d0a711da6de88c1ab620ea1ca58c
+  data.tar.gz: cc72a6efa7d4c23d88069a482f153da899680bcebc0a418e85361e759441fe52
 SHA512:
-  metadata.gz: 7931be3dcf151f5e26313fcfd94b25995f416bd17147e40d99dec981991ebaa2b9a2d0ac3534f2d3888c60d969ec32cea8b8e07a2e6656fbf2e33526a3a041e4
-  data.tar.gz: 4d57d68375783ca713d41844d364c04e5f234834509fbd465822ca89aa9f0044e558055d730cbacaf50ed5d96d4839aa7087a4436c497c401d985658e08a3bd1
+  metadata.gz: bea7a9fa2457eca3c876aa38a6bbb492fec8f965b06e4b2e1a8ae3df10454cfe08aa04536546e392a36c03341a54bf7103a8444c6de9dd97c1cdc35abba942f6
+  data.tar.gz: 10913c571258c67c3ce10362794e30d2a742b117cde9f4ddbe02a8eabf7c568be4bb64871169ece92b2fe443a3480471adab6c506ac41b7a172579740827b3a0

data/CHANGELOG.md

@@ -1,5 +1,37 @@
 # Changelog
 
+## 4.9.0 (2026-04-01)
+
+Full Changelog: [v4.8.0...v4.9.0](https://github.com/trycourier/courier-ruby/compare/v4.8.0...v4.9.0)
+
+### Features
+
+* **api:** add html variant to elemental_node union ([a5a5a5d](https://github.com/trycourier/courier-ruby/commit/a5a5a5d025d5ddb27a79872b15efaaa08785b032))
+* **api:** add notification template CRUD methods, update list params/types ([4861f87](https://github.com/trycourier/courier-ruby/commit/4861f87ead15aba7b148dc8d2790fe2d018157c9))
+* **api:** add providers resource with create/retrieve/update/list/delete and catalog ([5191261](https://github.com/trycourier/courier-ruby/commit/519126120e84dea8276094325e49d350eff3f7bc))
+* **api:** add routing_strategies resource with create/retrieve/list/replace/archive ([6c64599](https://github.com/trycourier/courier-ruby/commit/6c645999dd54ac75bdb777745363d662f7d9da64))
+
+
+### Bug Fixes
+
+* align path encoding with RFC 3986 section 3.3 ([916afaa](https://github.com/trycourier/courier-ruby/commit/916afaafd525d4d77a42a0739e892c4d4cf5d933))
+* **internal:** correct multipart form field name encoding ([7925b72](https://github.com/trycourier/courier-ruby/commit/7925b72544622783dd17527da1729f6f48ddb744))
+* variable name typo ([1f59fd2](https://github.com/trycourier/courier-ruby/commit/1f59fd2c73459908b337b98135efbd79bf0bfb9a))
+
+
+### Chores
+
+* **ci:** skip lint on metadata-only changes ([22a3e8d](https://github.com/trycourier/courier-ruby/commit/22a3e8d5bbfe6953bca20ba54b7bb2007f4f37c0))
+* **ci:** support opting out of skipping builds on metadata-only commits ([a6c047e](https://github.com/trycourier/courier-ruby/commit/a6c047eaa9730f8c398082cd422bf0bc1087e882))
+* **internal:** tweak CI branches ([08eccfe](https://github.com/trycourier/courier-ruby/commit/08eccfe4c37358304a97686df7248dc02f6ea0f4))
+* **internal:** update gitignore ([95860ac](https://github.com/trycourier/courier-ruby/commit/95860acf54c665132e957913d0fc6187cadaf64c))
+
+
+### Documentation
+
+* add AGENTS.md for AI coding assistants ([#81](https://github.com/trycourier/courier-ruby/issues/81)) ([ff1b8c2](https://github.com/trycourier/courier-ruby/commit/ff1b8c2e58007e1ccd5e631e07f28daf2027cef2))
+* sync README from mintlify-docs (2026-03-23 19:54 UTC) ([#79](https://github.com/trycourier/courier-ruby/issues/79)) ([4b83d99](https://github.com/trycourier/courier-ruby/commit/4b83d99126c8ddedf8e137cfc683bc6be998cc35))
+
 ## 4.8.0 (2026-03-12)
 
 Full Changelog: [v4.7.1...v4.8.0](https://github.com/trycourier/courier-ruby/compare/v4.7.1...v4.8.0)

data/README.md

@@ -8,7 +8,7 @@ The Courier Ruby SDK provides typed access to the Courier REST API from any Ruby
 Add to your `Gemfile`:
 
 ```ruby
-gem "trycourier", "~> 4.7"
+gem "trycourier"
 ```
 
 Then run `bundle install`.

data/lib/courier/client.rb

@@ -24,6 +24,9 @@ module Courier
     # @return [Courier::Resources::Audiences]
     attr_reader :audiences
 
+    # @return [Courier::Resources::Providers]
+    attr_reader :providers
+
     # @return [Courier::Resources::AuditEvents]
     attr_reader :audit_events
 
@@ -57,6 +60,9 @@ module Courier
     # @return [Courier::Resources::Notifications]
     attr_reader :notifications
 
+    # @return [Courier::Resources::RoutingStrategies]
+    attr_reader :routing_strategies
+
     # @return [Courier::Resources::Profiles]
     attr_reader :profiles
 
@@ -118,6 +124,7 @@ module Courier
 
       @send_ = Courier::Resources::Send.new(client: self)
       @audiences = Courier::Resources::Audiences.new(client: self)
+      @providers = Courier::Resources::Providers.new(client: self)
       @audit_events = Courier::Resources::AuditEvents.new(client: self)
       @auth = Courier::Resources::Auth.new(client: self)
       @automations = Courier::Resources::Automations.new(client: self)
@@ -129,6 +136,7 @@ module Courier
       @messages = Courier::Resources::Messages.new(client: self)
       @requests = Courier::Resources::Requests.new(client: self)
       @notifications = Courier::Resources::Notifications.new(client: self)
+      @routing_strategies = Courier::Resources::RoutingStrategies.new(client: self)
       @profiles = Courier::Resources::Profiles.new(client: self)
       @tenants = Courier::Resources::Tenants.new(client: self)
       @translations = Courier::Resources::Translations.new(client: self)

data/lib/courier/internal/util.rb

@@ -157,7 +157,7 @@ module Courier
           in Hash | nil => coerced
             coerced
           else
-            message = "Expected a #{Hash} or #{Courier::Internal::Type::BaseModel}, got #{data.inspect}"
+            message = "Expected a #{Hash} or #{Courier::Internal::Type::BaseModel}, got #{input.inspect}"
             raise ArgumentError.new(message)
           end
         end
@@ -237,6 +237,11 @@ module Courier
         end
       end
 
+      # @type [Regexp]
+      #
+      # https://www.rfc-editor.org/rfc/rfc3986.html#section-3.3
+      RFC_3986_NOT_PCHARS = /[^A-Za-z0-9\-._~!$&'()*+,;=:@]+/
+
       class << self
         # @api private
         #
@@ -247,6 +252,15 @@ module Courier
           "#{uri.scheme}://#{uri.host}#{":#{uri.port}" unless uri.port == uri.default_port}"
         end
 
+        # @api private
+        #
+        # @param path [String, Integer]
+        #
+        # @return [String]
+        def encode_path(path)
+          path.to_s.gsub(Courier::Internal::Util::RFC_3986_NOT_PCHARS) { ERB::Util.url_encode(_1) }
+        end
+
         # @api private
         #
         # @param path [String, Array<String>]
@@ -259,7 +273,7 @@ module Courier
           in []
             ""
           in [String => p, *interpolations]
-            encoded = interpolations.map { ERB::Util.url_encode(_1) }
+            encoded = interpolations.map { encode_path(_1) }
             format(p, *encoded)
           end
         end
@@ -571,16 +585,15 @@ module Courier
           y << "Content-Disposition: form-data"
 
           unless key.nil?
-            name = ERB::Util.url_encode(key.to_s)
-            y << "; name=\"#{name}\""
+            y << "; name=\"#{key}\""
           end
 
           case val
           in Courier::FilePart unless val.filename.nil?
-            filename = ERB::Util.url_encode(val.filename)
+            filename = encode_path(val.filename)
             y << "; filename=\"#{filename}\""
           in Pathname | IO
-            filename = ERB::Util.url_encode(::File.basename(val.to_path))
+            filename = encode_path(::File.basename(val.to_path))
             y << "; filename=\"#{filename}\""
           else
           end

data/lib/courier/models/channel.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    class Channel < Courier::Internal::Type::BaseModel
+      # @!attribute brand_id
+      #   Brand id used for rendering.
+      #
+      #   @return [String, nil]
+      optional :brand_id, String, nil?: true
+
+      # @!attribute if_
+      #   JS conditional with access to data/profile.
+      #
+      #   @return [String, nil]
+      optional :if_, String, api_name: :if, nil?: true
+
+      # @!attribute metadata
+      #
+      #   @return [Courier::Models::ChannelMetadata, nil]
+      optional :metadata, -> { Courier::ChannelMetadata }, nil?: true
+
+      # @!attribute override
+      #   Channel specific overrides.
+      #
+      #   @return [Hash{Symbol=>Object}, nil]
+      optional :override, Courier::Internal::Type::HashOf[Courier::Internal::Type::Unknown], nil?: true
+
+      # @!attribute providers
+      #   Providers enabled for this channel.
+      #
+      #   @return [Array<String>, nil]
+      optional :providers, Courier::Internal::Type::ArrayOf[String], nil?: true
+
+      # @!attribute routing_method
+      #   Defaults to `single`.
+      #
+      #   @return [Symbol, Courier::Models::Channel::RoutingMethod, nil]
+      optional :routing_method, enum: -> { Courier::Channel::RoutingMethod }, nil?: true
+
+      # @!attribute timeouts
+      #
+      #   @return [Courier::Models::Timeouts, nil]
+      optional :timeouts, -> { Courier::Timeouts }, nil?: true
+
+      # @!method initialize(brand_id: nil, if_: nil, metadata: nil, override: nil, providers: nil, routing_method: nil, timeouts: nil)
+      #   @param brand_id [String, nil] Brand id used for rendering.
+      #
+      #   @param if_ [String, nil] JS conditional with access to data/profile.
+      #
+      #   @param metadata [Courier::Models::ChannelMetadata, nil]
+      #
+      #   @param override [Hash{Symbol=>Object}, nil] Channel specific overrides.
+      #
+      #   @param providers [Array<String>, nil] Providers enabled for this channel.
+      #
+      #   @param routing_method [Symbol, Courier::Models::Channel::RoutingMethod, nil] Defaults to `single`.
+      #
+      #   @param timeouts [Courier::Models::Timeouts, nil]
+
+      # Defaults to `single`.
+      #
+      # @see Courier::Models::Channel#routing_method
+      module RoutingMethod
+        extend Courier::Internal::Type::Enum
+
+        ALL = :all
+        SINGLE = :single
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/courier/models/channel_metadata.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    class ChannelMetadata < Courier::Internal::Type::BaseModel
+      # @!attribute utm
+      #
+      #   @return [Courier::Models::Utm, nil]
+      optional :utm, -> { Courier::Utm }, nil?: true
+
+      # @!method initialize(utm: nil)
+      #   @param utm [Courier::Models::Utm, nil]
+    end
+  end
+end

data/lib/courier/models/elemental_content.rb

@@ -5,7 +5,7 @@ module Courier
     class ElementalContent < Courier::Internal::Type::BaseModel
       # @!attribute elements
       #
-      #   @return [Array<Courier::Models::ElementalTextNodeWithType, Courier::Models::ElementalMetaNodeWithType, Courier::Models::ElementalChannelNodeWithType, Courier::Models::ElementalImageNodeWithType, Courier::Models::ElementalActionNodeWithType, Courier::Models::ElementalDividerNodeWithType, Courier::Models::ElementalQuoteNodeWithType>]
+      #   @return [Array<Courier::Models::ElementalTextNodeWithType, Courier::Models::ElementalMetaNodeWithType, Courier::Models::ElementalChannelNodeWithType, Courier::Models::ElementalImageNodeWithType, Courier::Models::ElementalActionNodeWithType, Courier::Models::ElementalDividerNodeWithType, Courier::Models::ElementalQuoteNodeWithType, Courier::Models::ElementalHTMLNodeWithType>]
       required :elements, -> { Courier::Internal::Type::ArrayOf[union: Courier::ElementalNode] }
 
       # @!attribute version
@@ -15,7 +15,7 @@ module Courier
       required :version, String
 
       # @!method initialize(elements:, version:)
-      #   @param elements [Array<Courier::Models::ElementalTextNodeWithType, Courier::Models::ElementalMetaNodeWithType, Courier::Models::ElementalChannelNodeWithType, Courier::Models::ElementalImageNodeWithType, Courier::Models::ElementalActionNodeWithType, Courier::Models::ElementalDividerNodeWithType, Courier::Models::ElementalQuoteNodeWithType>]
+      #   @param elements [Array<Courier::Models::ElementalTextNodeWithType, Courier::Models::ElementalMetaNodeWithType, Courier::Models::ElementalChannelNodeWithType, Courier::Models::ElementalImageNodeWithType, Courier::Models::ElementalActionNodeWithType, Courier::Models::ElementalDividerNodeWithType, Courier::Models::ElementalQuoteNodeWithType, Courier::Models::ElementalHTMLNodeWithType>]
       #
       #   @param version [String] For example, "2022-01-01"
     end

data/lib/courier/models/elemental_html_node_with_type.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    class ElementalHTMLNodeWithType < Courier::Models::ElementalBaseNode
+      # @!attribute type
+      #
+      #   @return [Symbol, Courier::Models::ElementalHTMLNodeWithType::Type, nil]
+      optional :type, enum: -> { Courier::ElementalHTMLNodeWithType::Type }
+
+      # @!method initialize(type: nil)
+      #   @param type [Symbol, Courier::Models::ElementalHTMLNodeWithType::Type]
+
+      module Type
+        extend Courier::Internal::Type::Enum
+
+        HTML = :html
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/courier/models/elemental_node.rb

@@ -37,8 +37,10 @@ module Courier
 
       variant -> { Courier::ElementalQuoteNodeWithType }
 
+      variant -> { Courier::ElementalHTMLNodeWithType }
+
       # @!method self.variants
-      #   @return [Array(Courier::Models::ElementalTextNodeWithType, Courier::Models::ElementalMetaNodeWithType, Courier::Models::ElementalChannelNodeWithType, Courier::Models::ElementalImageNodeWithType, Courier::Models::ElementalActionNodeWithType, Courier::Models::ElementalDividerNodeWithType, Courier::Models::ElementalQuoteNodeWithType)]
+      #   @return [Array(Courier::Models::ElementalTextNodeWithType, Courier::Models::ElementalMetaNodeWithType, Courier::Models::ElementalChannelNodeWithType, Courier::Models::ElementalImageNodeWithType, Courier::Models::ElementalActionNodeWithType, Courier::Models::ElementalDividerNodeWithType, Courier::Models::ElementalQuoteNodeWithType, Courier::Models::ElementalHTMLNodeWithType)]
     end
   end
 end

data/lib/courier/models/message_channels.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # @type [Courier::Internal::Type::Converter]
+    MessageChannels = Courier::Internal::Type::HashOf[-> { Courier::Channel }]
+  end
+end

data/lib/courier/models/message_providers.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # @type [Courier::Internal::Type::Converter]
+    MessageProviders = Courier::Internal::Type::HashOf[-> { Courier::MessageProvidersType }]
+  end
+end

data/lib/courier/models/message_providers_type.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    class MessageProvidersType < Courier::Internal::Type::BaseModel
+      # @!attribute if_
+      #   JS conditional with access to data/profile.
+      #
+      #   @return [String, nil]
+      optional :if_, String, api_name: :if, nil?: true
+
+      # @!attribute metadata
+      #
+      #   @return [Courier::Models::Metadata, nil]
+      optional :metadata, -> { Courier::Metadata }, nil?: true
+
+      # @!attribute override
+      #   Provider-specific overrides.
+      #
+      #   @return [Hash{Symbol=>Object}, nil]
+      optional :override, Courier::Internal::Type::HashOf[Courier::Internal::Type::Unknown], nil?: true
+
+      # @!attribute timeouts
+      #
+      #   @return [Integer, nil]
+      optional :timeouts, Integer, nil?: true
+
+      # @!method initialize(if_: nil, metadata: nil, override: nil, timeouts: nil)
+      #   @param if_ [String, nil] JS conditional with access to data/profile.
+      #
+      #   @param metadata [Courier::Models::Metadata, nil]
+      #
+      #   @param override [Hash{Symbol=>Object}, nil] Provider-specific overrides.
+      #
+      #   @param timeouts [Integer, nil]
+    end
+  end
+end

data/lib/courier/models/metadata.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    class Metadata < Courier::Internal::Type::BaseModel
+      # @!attribute utm
+      #
+      #   @return [Courier::Models::Utm, nil]
+      optional :utm, -> { Courier::Utm }, nil?: true
+
+      # @!method initialize(utm: nil)
+      #   @param utm [Courier::Models::Utm, nil]
+    end
+  end
+end

data/lib/courier/models/notification_archive_params.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # @see Courier::Resources::Notifications#archive
+    class NotificationArchiveParams < Courier::Internal::Type::BaseModel
+      extend Courier::Internal::Type::RequestParameters::Converter
+      include Courier::Internal::Type::RequestParameters
+
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!method initialize(id:, request_options: {})
+      #   @param id [String]
+      #   @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/courier/models/notification_create_params.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # @see Courier::Resources::Notifications#create
+    class NotificationCreateParams < Courier::Models::NotificationTemplateCreateRequest
+      extend Courier::Internal::Type::RequestParameters::Converter
+      include Courier::Internal::Type::RequestParameters
+
+      # @!method initialize(request_options: {})
+      #   @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/courier/models/notification_list_params.rb

@@ -8,20 +8,29 @@ module Courier
       include Courier::Internal::Type::RequestParameters
 
       # @!attribute cursor
+      #   Opaque pagination cursor from a previous response. Omit for the first page.
       #
       #   @return [String, nil]
       optional :cursor, String, nil?: true
 
+      # @!attribute event_id
+      #   Filter to templates linked to this event map ID.
+      #
+      #   @return [String, nil]
+      optional :event_id, String
+
       # @!attribute notes
-      #   Retrieve the notes from the Notification template settings.
+      #   Include template notes in the response. Only applies to legacy templates.
       #
       #   @return [Boolean, nil]
       optional :notes, Courier::Internal::Type::Boolean, nil?: true
 
-      # @!method initialize(cursor: nil, notes: nil, request_options: {})
-      #   @param cursor [String, nil]
+      # @!method initialize(cursor: nil, event_id: nil, notes: nil, request_options: {})
+      #   @param cursor [String, nil] Opaque pagination cursor from a previous response. Omit for the first page.
+      #
+      #   @param event_id [String] Filter to templates linked to this event map ID.
       #
-      #   @param notes [Boolean, nil] Retrieve the notes from the Notification template settings.
+      #   @param notes [Boolean, nil] Include template notes in the response. Only applies to legacy templates.
       #
       #   @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
     end

data/lib/courier/models/notification_list_response.rb

@@ -10,108 +10,123 @@ module Courier
       required :paging, -> { Courier::Paging }
 
       # @!attribute results
+      #   Notification templates in this workspace.
       #
-      #   @return [Array<Courier::Models::NotificationListResponse::Result>]
+      #   @return [Array<Courier::Models::NotificationListResponse::Result::Notification, Courier::Models::NotificationTemplateSummary>]
       required :results,
-               -> { Courier::Internal::Type::ArrayOf[Courier::Models::NotificationListResponse::Result] }
+               -> { Courier::Internal::Type::ArrayOf[union: Courier::Models::NotificationListResponse::Result] }
 
       # @!method initialize(paging:, results:)
       #   @param paging [Courier::Models::Paging]
-      #   @param results [Array<Courier::Models::NotificationListResponse::Result>]
-
-      class Result < Courier::Internal::Type::BaseModel
-        # @!attribute id
-        #
-        #   @return [String]
-        required :id, String
-
-        # @!attribute created_at
-        #
-        #   @return [Integer]
-        required :created_at, Integer
-
-        # @!attribute event_ids
-        #   Array of event IDs associated with this notification
-        #
-        #   @return [Array<String>]
-        required :event_ids, Courier::Internal::Type::ArrayOf[String]
-
-        # @!attribute note
-        #
-        #   @return [String]
-        required :note, String
-
-        # @!attribute routing
-        #
-        #   @return [Courier::Models::MessageRouting]
-        required :routing, -> { Courier::MessageRouting }
-
-        # @!attribute topic_id
-        #
-        #   @return [String]
-        required :topic_id, String
-
-        # @!attribute updated_at
-        #
-        #   @return [Integer]
-        required :updated_at, Integer
-
-        # @!attribute tags
-        #
-        #   @return [Courier::Models::NotificationListResponse::Result::Tags, nil]
-        optional :tags, -> { Courier::Models::NotificationListResponse::Result::Tags }, nil?: true
-
-        # @!attribute title
-        #
-        #   @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)
-        #   @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 tags [Courier::Models::NotificationListResponse::Result::Tags, nil]
-        #
-        #   @param title [String, nil]
-
-        # @see Courier::Models::NotificationListResponse::Result#tags
-        class Tags < Courier::Internal::Type::BaseModel
-          # @!attribute data
-          #
-          #   @return [Array<Courier::Models::NotificationListResponse::Result::Tags::Data>]
-          required :data,
-                   -> { Courier::Internal::Type::ArrayOf[Courier::Models::NotificationListResponse::Result::Tags::Data] }
-
-          # @!method initialize(data:)
-          #   @param data [Array<Courier::Models::NotificationListResponse::Result::Tags::Data>]
-
-          class Data < Courier::Internal::Type::BaseModel
-            # @!attribute id
-            #
-            #   @return [String]
-            required :id, String
+      #
+      #   @param results [Array<Courier::Models::NotificationListResponse::Result::Notification, Courier::Models::NotificationTemplateSummary>] Notification templates in this workspace.
 
-            # @!attribute name
-            #
-            #   @return [String]
-            required :name, String
+      # V2 (CDS) template summary returned in list responses.
+      module Result
+        extend Courier::Internal::Type::Union
+
+        variant -> { Courier::Models::NotificationListResponse::Result::Notification }
+
+        # V2 (CDS) template summary returned in list responses.
+        variant -> { Courier::NotificationTemplateSummary }
+
+        class Notification < Courier::Internal::Type::BaseModel
+          # @!attribute id
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute created_at
+          #
+          #   @return [Integer]
+          required :created_at, Integer
+
+          # @!attribute event_ids
+          #   Array of event IDs associated with this notification
+          #
+          #   @return [Array<String>]
+          required :event_ids, Courier::Internal::Type::ArrayOf[String]
+
+          # @!attribute note
+          #
+          #   @return [String]
+          required :note, String
+
+          # @!attribute routing
+          #
+          #   @return [Courier::Models::MessageRouting]
+          required :routing, -> { Courier::MessageRouting }
+
+          # @!attribute topic_id
+          #
+          #   @return [String]
+          required :topic_id, String
 
-            # @!method initialize(id:, name:)
-            #   @param id [String]
-            #   @param name [String]
+          # @!attribute updated_at
+          #
+          #   @return [Integer]
+          required :updated_at, Integer
+
+          # @!attribute tags
+          #
+          #   @return [Courier::Models::NotificationListResponse::Result::Notification::Tags, nil]
+          optional :tags, -> { Courier::Models::NotificationListResponse::Result::Notification::Tags }, nil?: true
+
+          # @!attribute title
+          #
+          #   @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)
+          #   @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 tags [Courier::Models::NotificationListResponse::Result::Notification::Tags, nil]
+          #
+          #   @param title [String, nil]
+
+          # @see Courier::Models::NotificationListResponse::Result::Notification#tags
+          class Tags < Courier::Internal::Type::BaseModel
+            # @!attribute data
+            #
+            #   @return [Array<Courier::Models::NotificationListResponse::Result::Notification::Tags::Data>]
+            required :data,
+                     -> { Courier::Internal::Type::ArrayOf[Courier::Models::NotificationListResponse::Result::Notification::Tags::Data] }
+
+            # @!method initialize(data:)
+            #   @param data [Array<Courier::Models::NotificationListResponse::Result::Notification::Tags::Data>]
+
+            class Data < Courier::Internal::Type::BaseModel
+              # @!attribute id
+              #
+              #   @return [String]
+              required :id, String
+
+              # @!attribute name
+              #
+              #   @return [String]
+              required :name, String
+
+              # @!method initialize(id:, name:)
+              #   @param id [String]
+              #   @param name [String]
+            end
           end
         end
+
+        # @!method self.variants
+        #   @return [Array(Courier::Models::NotificationListResponse::Result::Notification, Courier::Models::NotificationTemplateSummary)]
       end
     end
   end