trycourier 4.25.0 → 4.26.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6479592040b865063a1f1d9bec5fbea1650cdd5025a335068c39feefb4ae6fd9
-  data.tar.gz: da1ecb2bc7246befec1f12882a02c59d95e6e28b51f3348fbd75286c416cc1c1
+  metadata.gz: dae9e29710e0f5f51b49e7f54a4dea8ca81242d1e60b5c22c1e6fbebb40f7764
+  data.tar.gz: 6495ca2eb5e082913bb43f3f6d1e1b933f5b4be59de9b3d33f9c3b276027948a
 SHA512:
-  metadata.gz: a2550c508b661f15771d19f7c3d090641f439bd10031a5cbfa9a4323e09c42ce866d58575b53333255adeeb41fe462a7108c5505dc7123b434596c62bd331412
-  data.tar.gz: 4e3d97189c87af8c1165756d3a7a9fe69d583b0d4c3a9e223bdcefadd782e7f371aeff7c5e9548908547e85e107e34aaf11e21bd3a0c29cd5e79ab99cbddcc1b
+  metadata.gz: 6f700ac897dd06c5fea58697d83f3380a2b9da7228e5da085433df3eaa3e26434c6f634e2392d67e8582aa74854a6f9c1b3a6800095f3656e259bf8738bef21c
+  data.tar.gz: 8a2cac3bce7dc295374474a83aaf488496e8f347b4d4f0c72a9f524e4746dfa84c6c2ab6f053fbf4efac5733625d789eebe6493e7517d5ae7121d5ebe4dda8ab

data/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## [4.26.1](https://github.com/trycourier/courier-ruby/compare/v4.26.0...v4.26.1) (2026-08-13)
+
+
+### Chores
+
+* **api:** regenerate SDK ([#115](https://github.com/trycourier/courier-ruby/issues/115)) ([27dadbf](https://github.com/trycourier/courier-ruby/commit/27dadbfd9a49b7f2fe7970d8a63f956f76d484e6))
+
+
+### Documentation
+
+* **api:** give every request body an example, and correct the archive status code ([#119](https://github.com/trycourier/courier-ruby/issues/119)) ([b4ad8e9](https://github.com/trycourier/courier-ruby/commit/b4ad8e90341bc2a7a0a34c04aeddcb60a91124e7))
+* sync README from api-spec ([#113](https://github.com/trycourier/courier-ruby/issues/113)) ([8d479fe](https://github.com/trycourier/courier-ruby/commit/8d479fe04eea80c8f307e054e78098fe7cde253e))
+
+## 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)

data/README.md

@@ -1,17 +1,20 @@
-<!-- AUTO-GENERATED-OVERVIEW:START — Do not edit this section. It is synced from mintlify-docs. -->
 # Courier Ruby SDK
 
-The Courier Ruby SDK provides typed access to the Courier REST API from any Ruby 3.2+ application. It ships with Yard docstrings, RBS and RBI type definitions for Sorbet, and uses `net/http` with connection pooling.
+The Courier Ruby SDK provides typed access to the Courier REST API from Ruby applications. Use it to send notifications, manage user profiles, check message status, issue JWT tokens for client-side SDKs, and more.
 
 ## Installation
 
-Add to your `Gemfile`:
+Add the gem to your `Gemfile`:
+
+<!-- x-release-please-start-version -->
 
 ```ruby
-gem "trycourier"
+gem "trycourier", "~> 4.26.1"
 ```
 
-Then run `bundle install`.
+<!-- x-release-please-end -->
+
+Then run `bundle install`. Requires Ruby 3.2+.
 
 ## Quick Start
 
@@ -19,24 +22,20 @@ Then run `bundle install`.
 require "bundler/setup"
 require "courier"
 
-client = Courier::Client.new
+courier = Courier::Client.new(
+  api_key: ENV["COURIER_API_KEY"] # the default, can be omitted
+)
 
-response = client.send_.message(
-  message: {
-    to: { email: "you@example.com" },
-    content: {
-      title: "Hello from Courier!",
-      body: "Your first notification, sent with the Ruby SDK."
-    }
-  }
+response = courier.send_.message(
+  message: {to: {user_id: "your_user_id"}, template: "your_template_id", data: {foo: "bar"}}
 )
 
-puts response.request_id
+puts(response.requestId)
 ```
 
-The client reads `COURIER_API_KEY` from your environment automatically. You can also pass it explicitly: `Courier::Client.new(api_key: "your-key")`.
+The client reads `COURIER_API_KEY` from your environment automatically.
 
-> **Note**: The method is `send_` (with trailing underscore) because `send` is a reserved method in Ruby.
+Note the trailing underscore on `send_` — `send` is reserved in Ruby.
 
 ## Documentation
 
@@ -45,5 +44,3 @@ Full documentation: **[courier.com/docs/sdk-libraries/ruby](https://www.courier.
 - [Quickstart](https://www.courier.com/docs/getting-started/quickstart/)
 - [Send API](https://www.courier.com/docs/platform/sending/send-message/)
 - [API Reference](https://www.courier.com/docs/reference/get-started/)
-- [RubyDoc](https://gemdocs.org/gems/trycourier)
-<!-- AUTO-GENERATED-OVERVIEW:END -->

data/lib/courier/client.rb

@@ -58,6 +58,9 @@ module Courier
     # @return [Courier::Resources::Broadcasts]
     attr_reader :broadcasts
 
+    # @return [Courier::Resources::Bulk]
+    attr_reader :bulk
+
     # Manage the logos, colors, and layout that give the templates you send a
     # consistent look.
     # @return [Courier::Resources::Brands]
@@ -187,6 +190,7 @@ module Courier
       @automations = Courier::Resources::Automations.new(client: self)
       @journeys = Courier::Resources::Journeys.new(client: self)
       @broadcasts = Courier::Resources::Broadcasts.new(client: self)
+      @bulk = Courier::Resources::Bulk.new(client: self)
       @brands = Courier::Resources::Brands.new(client: self)
       @digests = Courier::Resources::Digests.new(client: self)
       @inbound = Courier::Resources::Inbound.new(client: self)

data/lib/courier/models/bulk_add_users_params.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # @see Courier::Resources::Bulk#add_users
+    class BulkAddUsersParams < Courier::Internal::Type::BaseModel
+      extend Courier::Internal::Type::RequestParameters::Converter
+      include Courier::Internal::Type::RequestParameters
+
+      # @!attribute job_id
+      #
+      #   @return [String]
+      required :job_id, String
+
+      # @!attribute users
+      #
+      #   @return [Array<Courier::Models::InboundBulkMessageUser>]
+      required :users, -> { Courier::Internal::Type::ArrayOf[Courier::InboundBulkMessageUser] }
+
+      # @!method initialize(job_id:, users:, request_options: {})
+      #   @param job_id [String]
+      #   @param users [Array<Courier::Models::InboundBulkMessageUser>]
+      #   @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/courier/models/bulk_create_job_params.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # @see Courier::Resources::Bulk#create_job
+    class BulkCreateJobParams < Courier::Internal::Type::BaseModel
+      extend Courier::Internal::Type::RequestParameters::Converter
+      include Courier::Internal::Type::RequestParameters
+
+      # @!attribute message
+      #   Bulk message definition. Supports two formats:
+      #
+      #   - V1 format: Requires `event` field (event ID or notification ID)
+      #   - V2 format: Optionally use `template` (notification ID) or `content` (Elemental
+      #     content) in addition to `event`
+      #
+      #   @return [Courier::Models::InboundBulkMessage]
+      required :message, -> { Courier::InboundBulkMessage }
+
+      # @!method initialize(message:, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Courier::Models::BulkCreateJobParams} for more details.
+      #
+      #   @param message [Courier::Models::InboundBulkMessage] Bulk message definition. Supports two formats:
+      #
+      #   @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/courier/models/bulk_create_job_response.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # @see Courier::Resources::Bulk#create_job
+    class BulkCreateJobResponse < Courier::Internal::Type::BaseModel
+      # @!attribute job_id
+      #
+      #   @return [String]
+      required :job_id, String, api_name: :jobId
+
+      # @!method initialize(job_id:)
+      #   @param job_id [String]
+    end
+  end
+end

data/lib/courier/models/bulk_list_users_params.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # @see Courier::Resources::Bulk#list_users
+    class BulkListUsersParams < Courier::Internal::Type::BaseModel
+      extend Courier::Internal::Type::RequestParameters::Converter
+      include Courier::Internal::Type::RequestParameters
+
+      # @!attribute job_id
+      #
+      #   @return [String]
+      required :job_id, String
+
+      # @!attribute cursor
+      #   A unique identifier that allows for fetching the next set of users added to the
+      #   bulk job
+      #
+      #   @return [String, nil]
+      optional :cursor, String, nil?: true
+
+      # @!method initialize(job_id:, cursor: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Courier::Models::BulkListUsersParams} for more details.
+      #
+      #   @param job_id [String]
+      #
+      #   @param cursor [String, nil] A unique identifier that allows for fetching the next set of users added to the
+      #
+      #   @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/courier/models/bulk_list_users_response.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # @see Courier::Resources::Bulk#list_users
+    class BulkListUsersResponse < Courier::Internal::Type::BaseModel
+      # @!attribute items
+      #
+      #   @return [Array<Courier::Models::BulkListUsersResponse::Item>]
+      required :items, -> { Courier::Internal::Type::ArrayOf[Courier::Models::BulkListUsersResponse::Item] }
+
+      # @!attribute paging
+      #
+      #   @return [Courier::Models::Paging]
+      required :paging, -> { Courier::Paging }
+
+      # @!method initialize(items:, paging:)
+      #   @param items [Array<Courier::Models::BulkListUsersResponse::Item>]
+      #   @param paging [Courier::Models::Paging]
+
+      class Item < Courier::Models::InboundBulkMessageUser
+        # @!attribute status
+        #
+        #   @return [Symbol, Courier::Models::BulkListUsersResponse::Item::Status]
+        required :status, enum: -> { Courier::Models::BulkListUsersResponse::Item::Status }
+
+        # @!attribute message_id
+        #
+        #   @return [String, nil]
+        optional :message_id, String, api_name: :messageId, nil?: true
+
+        # @!method initialize(status:, message_id: nil)
+        #   @param status [Symbol, Courier::Models::BulkListUsersResponse::Item::Status]
+        #   @param message_id [String, nil]
+
+        module Status
+          extend Courier::Internal::Type::Enum
+
+          PENDING = :PENDING
+          ENQUEUED = :ENQUEUED
+          ERROR = :ERROR
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/courier/models/bulk_retrieve_job_params.rb

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

data/lib/courier/models/bulk_retrieve_job_response.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # @see Courier::Resources::Bulk#retrieve_job
+    class BulkRetrieveJobResponse < Courier::Internal::Type::BaseModel
+      # @!attribute job
+      #
+      #   @return [Courier::Models::BulkRetrieveJobResponse::Job]
+      required :job, -> { Courier::Models::BulkRetrieveJobResponse::Job }
+
+      # @!method initialize(job:)
+      #   @param job [Courier::Models::BulkRetrieveJobResponse::Job]
+
+      # @see Courier::Models::BulkRetrieveJobResponse#job
+      class Job < Courier::Internal::Type::BaseModel
+        # @!attribute definition
+        #   Bulk message definition. Supports two formats:
+        #
+        #   - V1 format: Requires `event` field (event ID or notification ID)
+        #   - V2 format: Optionally use `template` (notification ID) or `content` (Elemental
+        #     content) in addition to `event`
+        #
+        #   @return [Courier::Models::InboundBulkMessage]
+        required :definition, -> { Courier::InboundBulkMessage }
+
+        # @!attribute enqueued
+        #
+        #   @return [Integer]
+        required :enqueued, Integer
+
+        # @!attribute failures
+        #
+        #   @return [Integer]
+        required :failures, Integer
+
+        # @!attribute received
+        #
+        #   @return [Integer]
+        required :received, Integer
+
+        # @!attribute status
+        #
+        #   @return [Symbol, Courier::Models::BulkRetrieveJobResponse::Job::Status]
+        required :status, enum: -> { Courier::Models::BulkRetrieveJobResponse::Job::Status }
+
+        # @!method initialize(definition:, enqueued:, failures:, received:, status:)
+        #   Some parameter documentations has been truncated, see
+        #   {Courier::Models::BulkRetrieveJobResponse::Job} for more details.
+        #
+        #   @param definition [Courier::Models::InboundBulkMessage] Bulk message definition. Supports two formats:
+        #
+        #   @param enqueued [Integer]
+        #
+        #   @param failures [Integer]
+        #
+        #   @param received [Integer]
+        #
+        #   @param status [Symbol, Courier::Models::BulkRetrieveJobResponse::Job::Status]
+
+        # @see Courier::Models::BulkRetrieveJobResponse::Job#status
+        module Status
+          extend Courier::Internal::Type::Enum
+
+          CREATED = :CREATED
+          PROCESSING = :PROCESSING
+          COMPLETED = :COMPLETED
+          ERROR = :ERROR
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/courier/models/bulk_run_job_params.rb

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

data/lib/courier/models/inbound_bulk_message.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    class InboundBulkMessage < Courier::Internal::Type::BaseModel
+      # @!attribute event
+      #   Event ID or Notification ID (required). Can be either a Notification ID (e.g.,
+      #   "FRH3QXM9E34W4RKP7MRC8NZ1T8V8") or a custom Event ID (e.g., "welcome-email")
+      #   mapped to a notification.
+      #
+      #   @return [String]
+      required :event, String
+
+      # @!attribute brand
+      #
+      #   @return [String, nil]
+      optional :brand, String, nil?: true
+
+      # @!attribute content
+      #   Elemental content (optional, for V2 format). When provided, this will be used
+      #   instead of the notification associated with the `event` field.
+      #
+      #   @return [Courier::Models::ElementalContentSugar, Courier::Models::ElementalContent, nil]
+      optional :content, union: -> { Courier::InboundBulkMessage::Content }, nil?: true
+
+      # @!attribute data
+      #
+      #   @return [Hash{Symbol=>Object}, nil]
+      optional :data, Courier::Internal::Type::HashOf[Courier::Internal::Type::Unknown], nil?: true
+
+      # @!attribute locale
+      #
+      #   @return [Hash{Symbol=>Hash{Symbol=>Object}}, nil]
+      optional :locale,
+               Courier::Internal::Type::HashOf[Courier::Internal::Type::HashOf[Courier::Internal::Type::Unknown]],
+               nil?: true
+
+      # @!attribute override
+      #
+      #   @return [Hash{Symbol=>Object}, nil]
+      optional :override, Courier::Internal::Type::HashOf[Courier::Internal::Type::Unknown], nil?: true
+
+      # @!attribute template
+      #   Notification ID or template ID (optional, for V2 format). When provided, this
+      #   will be used instead of the notification associated with the `event` field.
+      #
+      #   @return [String, nil]
+      optional :template, String, nil?: true
+
+      # @!method initialize(event:, brand: nil, content: nil, data: nil, locale: nil, override: nil, template: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Courier::Models::InboundBulkMessage} for more details.
+      #
+      #   Bulk message definition. Supports two formats:
+      #
+      #   - V1 format: Requires `event` field (event ID or notification ID)
+      #   - V2 format: Optionally use `template` (notification ID) or `content` (Elemental
+      #     content) in addition to `event`
+      #
+      #   @param event [String] Event ID or Notification ID (required). Can be either a
+      #
+      #   @param brand [String, nil]
+      #
+      #   @param content [Courier::Models::ElementalContentSugar, Courier::Models::ElementalContent, nil] Elemental content (optional, for V2 format). When provided, this will be used
+      #
+      #   @param data [Hash{Symbol=>Object}, nil]
+      #
+      #   @param locale [Hash{Symbol=>Hash{Symbol=>Object}}, nil]
+      #
+      #   @param override [Hash{Symbol=>Object}, nil]
+      #
+      #   @param template [String, nil] Notification ID or template ID (optional, for V2 format). When provided,
+
+      # Elemental content (optional, for V2 format). When provided, this will be used
+      # instead of the notification associated with the `event` field.
+      #
+      # @see Courier::Models::InboundBulkMessage#content
+      module Content
+        extend Courier::Internal::Type::Union
+
+        # Syntactic sugar to provide a fast shorthand for Courier Elemental Blocks.
+        variant -> { Courier::ElementalContentSugar }
+
+        variant -> { Courier::ElementalContent }
+
+        # @!method self.variants
+        #   @return [Array(Courier::Models::ElementalContentSugar, Courier::Models::ElementalContent)]
+      end
+    end
+  end
+end

data/lib/courier/models/inbound_bulk_message_user.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    class InboundBulkMessageUser < Courier::Internal::Type::BaseModel
+      # @!attribute data
+      #   User-specific data that will be merged with message.data
+      #
+      #   @return [Object, nil]
+      optional :data, Courier::Internal::Type::Unknown
+
+      # @!attribute preferences
+      #
+      #   @return [Courier::Models::RecipientPreferences, nil]
+      optional :preferences, -> { Courier::RecipientPreferences }, nil?: true
+
+      # @!attribute profile
+      #   User profile information. For email-based bulk jobs, `profile.email` is required
+      #   for provider routing to determine if the message can be delivered. The email
+      #   address should be provided here rather than in `to.email`.
+      #
+      #   @return [Hash{Symbol=>Object}, nil]
+      optional :profile, Courier::Internal::Type::HashOf[Courier::Internal::Type::Unknown], nil?: true
+
+      # @!attribute recipient
+      #   User ID (legacy field, use profile or to.user_id instead)
+      #
+      #   @return [String, nil]
+      optional :recipient, String, nil?: true
+
+      # @!attribute to
+      #   Optional recipient information. Note: For email provider routing, use
+      #   `profile.email` instead of `to.email`. The `to` field is primarily used for
+      #   recipient identification and data merging.
+      #
+      #   @return [Courier::Models::UserRecipient, nil]
+      optional :to, -> { Courier::UserRecipient }, nil?: true
+
+      # @!method initialize(data: nil, preferences: nil, profile: nil, recipient: nil, to: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Courier::Models::InboundBulkMessageUser} for more details.
+      #
+      #   @param data [Object] User-specific data that will be merged with message.data
+      #
+      #   @param preferences [Courier::Models::RecipientPreferences, nil]
+      #
+      #   @param profile [Hash{Symbol=>Object}, nil] User profile information. For email-based bulk jobs, `profile.email` is required
+      #
+      #   @param recipient [String, nil] User ID (legacy field, use profile or to.user_id instead)
+      #
+      #   @param to [Courier::Models::UserRecipient, nil] Optional recipient information. Note: For email provider routing, use
+    end
+  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