trycourier 4.8.0 → 4.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 453a5c5183a4ecfeebab4f86e963ac204c115741c2fedb0f32156b1a6aff23f0
-  data.tar.gz: 4db69717cb3bdcd63d2eae022325c4ae14fe8a1203cec1a7212628c3804242ce
+  metadata.gz: d71ef55224ae3a498561c16171a3a2f4d7043cdd17d9c505ef34e70179a6c35b
+  data.tar.gz: da26b63925075f65d3d953a4a810ea535431e65274528b902000121d928c7fcb
 SHA512:
-  metadata.gz: 7931be3dcf151f5e26313fcfd94b25995f416bd17147e40d99dec981991ebaa2b9a2d0ac3534f2d3888c60d969ec32cea8b8e07a2e6656fbf2e33526a3a041e4
-  data.tar.gz: 4d57d68375783ca713d41844d364c04e5f234834509fbd465822ca89aa9f0044e558055d730cbacaf50ed5d96d4839aa7087a4436c497c401d985658e08a3bd1
+  metadata.gz: 237604be72c50aa572c525addf58d4e3f723142ffbd5863c9dfb301882bf9efa4c77e4eae7a143cafc3ed1981fb0602be0bb7a1046d4be8e5587c2c15988fd52
+  data.tar.gz: cfdb4b9bcf90da1d34e9aabbe994404f49e6df75d4d56368509034b60ceb55eb0461d492cbaf2d2cb7a4b92e17f54a6050f7b605a0f2c00a8b9788c6142255d1

data/CHANGELOG.md

@@ -1,5 +1,46 @@
 # Changelog
 
+## 4.10.0 (2026-04-08)
+
+Full Changelog: [v4.9.0...v4.10.0](https://github.com/trycourier/courier-ruby/compare/v4.9.0...v4.10.0)
+
+### Features
+
+* **api:** add list_notifications method to routing_strategies ([ce8f121](https://github.com/trycourier/courier-ruby/commit/ce8f1217d52377144e053e51497310e71fef1dea))
+* **api:** add put_content/put_element/put_locale, remove draft resource, update retrieve_content ([ecb21e4](https://github.com/trycourier/courier-ruby/commit/ecb21e4913ec80513471153abab2e75d80afffb5))
+
+## 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/associated_notification_list_response.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # @see Courier::Resources::RoutingStrategies#list_notifications
+    class AssociatedNotificationListResponse < Courier::Internal::Type::BaseModel
+      # @!attribute paging
+      #
+      #   @return [Courier::Models::Paging]
+      required :paging, -> { Courier::Paging }
+
+      # @!attribute results
+      #
+      #   @return [Array<Courier::Models::NotificationTemplateSummary>]
+      required :results, -> { Courier::Internal::Type::ArrayOf[Courier::NotificationTemplateSummary] }
+
+      # @!method initialize(paging:, results:)
+      #   Paginated list of notification templates associated with a routing strategy.
+      #
+      #   @param paging [Courier::Models::Paging]
+      #   @param results [Array<Courier::Models::NotificationTemplateSummary>]
+    end
+  end
+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/element_with_checksums.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    class ElementWithChecksums < Courier::Internal::Type::BaseModel
+      # @!attribute checksum
+      #   MD5 hash of translatable content.
+      #
+      #   @return [String]
+      required :checksum, String
+
+      # @!attribute type
+      #   Element type (text, meta, action, etc.).
+      #
+      #   @return [String]
+      required :type, String
+
+      # @!attribute id
+      #
+      #   @return [String, nil]
+      optional :id, String
+
+      # @!attribute elements
+      #   Nested child elements (for group-type elements).
+      #
+      #   @return [Array<Courier::Models::ElementWithChecksums>, nil]
+      optional :elements, -> { Courier::Internal::Type::ArrayOf[Courier::ElementWithChecksums] }
+
+      # @!attribute locales
+      #   Locale-specific content with checksums.
+      #
+      #   @return [Hash{Symbol=>Courier::Models::ElementWithChecksums::Locale}, nil]
+      optional :locales, -> { Courier::Internal::Type::HashOf[Courier::ElementWithChecksums::Locale] }
+
+      # @!method initialize(checksum:, type:, id: nil, elements: nil, locales: nil)
+      #   An element with its content checksum and optional nested elements and locale
+      #   checksums.
+      #
+      #   @param checksum [String] MD5 hash of translatable content.
+      #
+      #   @param type [String] Element type (text, meta, action, etc.).
+      #
+      #   @param id [String]
+      #
+      #   @param elements [Array<Courier::Models::ElementWithChecksums>] Nested child elements (for group-type elements).
+      #
+      #   @param locales [Hash{Symbol=>Courier::Models::ElementWithChecksums::Locale}] Locale-specific content with checksums.
+
+      class Locale < Courier::Internal::Type::BaseModel
+        # @!attribute checksum
+        #
+        #   @return [String]
+        required :checksum, String
+
+        # @!method initialize(checksum:)
+        #   @param checksum [String]
+      end
+    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_content_get_response.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    class NotificationContentGetResponse < Courier::Internal::Type::BaseModel
+      # @!attribute elements
+      #
+      #   @return [Array<Courier::Models::ElementWithChecksums>]
+      required :elements, -> { Courier::Internal::Type::ArrayOf[Courier::ElementWithChecksums] }
+
+      # @!attribute version
+      #   Content version identifier.
+      #
+      #   @return [String]
+      required :version, String
+
+      # @!method initialize(elements:, version:)
+      #   Elemental content response for V2 templates. Contains versioned elements with
+      #   content checksums.
+      #
+      #   @param elements [Array<Courier::Models::ElementWithChecksums>]
+      #
+      #   @param version [String] Content version identifier.
+    end
+  end
+end

data/lib/courier/models/notification_content_mutation_response.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # @see Courier::Resources::Notifications#put_content
+    class NotificationContentMutationResponse < Courier::Internal::Type::BaseModel
+      # @!attribute id
+      #   Template ID.
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute elements
+      #
+      #   @return [Array<Courier::Models::NotificationContentMutationResponse::Element>]
+      required :elements,
+               -> { Courier::Internal::Type::ArrayOf[Courier::NotificationContentMutationResponse::Element] }
+
+      # @!attribute state
+      #   Template state. Defaults to `DRAFT`.
+      #
+      #   @return [Symbol, Courier::Models::NotificationTemplateState]
+      required :state, enum: -> { Courier::NotificationTemplateState }
+
+      # @!attribute version
+      #   Content version identifier.
+      #
+      #   @return [String]
+      required :version, String
+
+      # @!method initialize(id:, elements:, state:, version:)
+      #   Shared mutation response for `PUT` content, `PUT` element, and `PUT` locale
+      #   operations. Contains the template ID, content version, per-element checksums,
+      #   and resulting state.
+      #
+      #   @param id [String] Template ID.
+      #
+      #   @param elements [Array<Courier::Models::NotificationContentMutationResponse::Element>]
+      #
+      #   @param state [Symbol, Courier::Models::NotificationTemplateState] Template state. Defaults to `DRAFT`.
+      #
+      #   @param version [String] Content version identifier.
+
+      class Element < Courier::Internal::Type::BaseModel
+        # @!attribute id
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute checksum
+        #
+        #   @return [String]
+        required :checksum, String
+
+        # @!method initialize(id:, checksum:)
+        #   @param id [String]
+        #   @param checksum [String]
+      end
+    end
+  end
+end

data/lib/courier/models/notification_content_put_request.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    class NotificationContentPutRequest < Courier::Internal::Type::BaseModel
+      # @!attribute content
+      #   Elemental content payload. The server defaults `version` when omitted.
+      #
+      #   @return [Courier::Models::NotificationContentPutRequest::Content]
+      required :content, -> { Courier::NotificationContentPutRequest::Content }
+
+      # @!attribute state
+      #   Template state. Defaults to `DRAFT`.
+      #
+      #   @return [Symbol, Courier::Models::NotificationTemplateState, nil]
+      optional :state, enum: -> { Courier::NotificationTemplateState }
+
+      # @!method initialize(content:, state: nil)
+      #   Request body for replacing the elemental content of a notification template.
+      #
+      #   @param content [Courier::Models::NotificationContentPutRequest::Content] Elemental content payload. The server defaults `version` when omitted.
+      #
+      #   @param state [Symbol, Courier::Models::NotificationTemplateState] Template state. Defaults to `DRAFT`.
+
+      # @see Courier::Models::NotificationContentPutRequest#content
+      class Content < 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, Courier::Models::ElementalHTMLNodeWithType>]
+        required :elements, -> { Courier::Internal::Type::ArrayOf[union: Courier::ElementalNode] }
+
+        # @!attribute version
+        #   Content version identifier (e.g., `2022-01-01`). Optional; server defaults when
+        #   omitted.
+        #
+        #   @return [String, nil]
+        optional :version, String
+
+        # @!method initialize(elements:, version: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Courier::Models::NotificationContentPutRequest::Content} for more details.
+        #
+        #   Elemental content payload. The server defaults `version` when omitted.
+        #
+        #   @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] Content version identifier (e.g., `2022-01-01`). Optional; server defaults when
+      end
+    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