trycourier 6.11.3 → 6.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bc663969984ae8b94e9f2f522dc24ea9e1cbf1eed91ba357b565038bedb939ab
-  data.tar.gz: 5cfd3e3767063edef226cf90ec1e6833e6122660be98b0d499b3e8007cea090f
+  metadata.gz: 26943393679593de932be9962339164bdfdd09c63642b7d27a6f38ee061c8bfd
+  data.tar.gz: b8ddcc3c806c9ffa4246f53f8dd533a284214be239995b02acd7b1be6c2cbb36
 SHA512:
-  metadata.gz: 3482fdf2ca8fa7c825ff9259dabd2daa76c085cd65c79ee6f5bba64c19308aabfa933f9601f871b9167fa41017c76a2687c34710589544d34f1403d5469e2a74
-  data.tar.gz: e9a750836a3948eb31382b228503d9ad8360cf6309f8943efd550baab5c6607bb9ebce02a0dcb60b9a3d61e1481d024050e5158ac1c799ea555513b96c3815e0
+  metadata.gz: b80eb41483e2b7f9d19780b0468709eed4c1ed590264cec819ef26ad25cdae82a82674551d83b404de8876b30e73671bcc649ac03729a867b1231b7dc8c30d10
+  data.tar.gz: f3659cecd8aca744f5d4e4b5831bbc64fd44b65f86f379a5e261d12245f4ba51e624b600ced5f69433890c89a30bdb9a1b9b1645ac217f43cb3e73d559c5f844

data/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [6.12.0](https://github.com/trycourier/courier-ruby/compare/v6.11.3...v6.12.0) (2026-10-21)
+
+
+### Features
+
+* **api:** add PATCH /providers/{id} for partial provider updates [C-21790] ([#177](https://github.com/trycourier/courier-ruby/issues/177)) ([caf13e0](https://github.com/trycourier/courier-ruby/commit/caf13e064a109dc25acafab3b780f4410e141292))
+* **api:** expose email From, Reply-to, CC and BCC on notification templates [C-21709] ([#176](https://github.com/trycourier/courier-ruby/issues/176)) ([47e58ba](https://github.com/trycourier/courier-ruby/commit/47e58baa17aa96893a9f78ca59b67954a3644c6b))
+
+
+### Documentation
+
+* **api:** describe the AI node model constraint [C-21614] ([#173](https://github.com/trycourier/courier-ruby/issues/173)) ([bf4895f](https://github.com/trycourier/courier-ruby/commit/bf4895fd98558354eadbd01128e53dc32bc9c2a4))
+* **api:** document provider settings.rate_limit [C-21732] ([#175](https://github.com/trycourier/courier-ruby/issues/175)) ([d7b4ff9](https://github.com/trycourier/courier-ruby/commit/d7b4ff9f3e8d533d3d4e452d8f080cbb5f4b4823))
+
 ## [6.11.3](https://github.com/trycourier/courier-ruby/compare/v6.11.2...v6.11.3) (2026-09-30)
 
 

data/README.md

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

data/lib/courier/models/journey_ai_node.rb

@@ -28,6 +28,11 @@ module Courier
       optional :conditions, union: -> { Courier::JourneyConditionsField }
 
       # @!attribute model
+      #   A supported AI model id. Requests with an unknown id may be rejected with a 400
+      #   that lists the supported ids. Supported ids: `claude-fable-5-1`,
+      #   `claude-opus-5-5`, `claude-sonnet-5-5`, `claude-haiku-5-5`, `gpt-6-astra`,
+      #   `gpt-5.5`, `gpt-5.4`, `gpt-6.1-sol`, `gpt-5.4-mini`, `gpt-5.4-nano`,
+      #   `gpt-6-luna`.
       #
       #   @return [String, nil]
       optional :model, String
@@ -57,7 +62,7 @@ module Courier
       #
       #   @param conditions [Array<String>, Courier::Models::JourneyConditionGroup, Courier::Models::JourneyConditionNestedGroup] Condition spec for a journey node. Accepts a single condition atom, an AND/OR gr
       #
-      #   @param model [String]
+      #   @param model [String] A supported AI model id. Requests with an unknown id may be rejected with a 400
       #
       #   @param user_prompt [String]
       #

data/lib/courier/models/notification_template_email.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    class NotificationTemplateEmail < Courier::Internal::Type::BaseModel
+      # @!attribute bcc
+      #   BCC addresses.
+      #
+      #   @return [Array<String>, nil]
+      optional :bcc, Courier::Internal::Type::ArrayOf[String]
+
+      # @!attribute cc
+      #   CC addresses.
+      #
+      #   @return [Array<String>, nil]
+      optional :cc, Courier::Internal::Type::ArrayOf[String]
+
+      # @!attribute from
+      #   The From address.
+      #
+      #   @return [String, nil]
+      optional :from, String
+
+      # @!attribute reply_to
+      #   The Reply-to address.
+      #
+      #   @return [String, nil]
+      optional :reply_to, String
+
+      # @!method initialize(bcc: nil, cc: nil, from: nil, reply_to: nil)
+      #   Email header fields for the template's email channel: the From, Reply-to, CC and
+      #   BCC values set in the Studio email channel settings. Each value may use template
+      #   variables, such as `{{data.cc}}`, which are resolved at send time. Reads omit
+      #   `email` when no header is set, and omit each unset field. Writes treat it as
+      #   optional, with three meanings. Omit it to keep the stored headers. Send null to
+      #   clear all four. Send an object to replace all four: a field the object leaves
+      #   out is cleared. Other email channel settings, such as the subject, are kept
+      #   either way. Headers only apply while `content` has an email channel; with no
+      #   email channel they are not stored.
+      #
+      #   @param bcc [Array<String>] BCC addresses.
+      #
+      #   @param cc [Array<String>] CC addresses.
+      #
+      #   @param from [String] The From address.
+      #
+      #   @param reply_to [String] The Reply-to address.
+    end
+  end
+end

data/lib/courier/models/notification_template_payload.rb

@@ -39,7 +39,24 @@ module Courier
       #   @return [Array<String>]
       required :tags, Courier::Internal::Type::ArrayOf[String]
 
-      # @!method initialize(brand:, content:, name:, routing:, subscription:, tags:)
+      # @!attribute email
+      #   Email header fields for the template's email channel: the From, Reply-to, CC and
+      #   BCC values set in the Studio email channel settings. Each value may use template
+      #   variables, such as `{{data.cc}}`, which are resolved at send time. Reads omit
+      #   `email` when no header is set, and omit each unset field. Writes treat it as
+      #   optional, with three meanings. Omit it to keep the stored headers. Send null to
+      #   clear all four. Send an object to replace all four: a field the object leaves
+      #   out is cleared. Other email channel settings, such as the subject, are kept
+      #   either way. Headers only apply while `content` has an email channel; with no
+      #   email channel they are not stored.
+      #
+      #   @return [Courier::Models::NotificationTemplateEmail, nil]
+      optional :email, -> { Courier::NotificationTemplateEmail }, nil?: true
+
+      # @!method initialize(brand:, content:, name:, routing:, subscription:, tags:, email: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Courier::Models::NotificationTemplatePayload} for more details.
+      #
       #   Core template fields used in POST and PUT request bodies (nested under a
       #   `notification` key) and returned at the top level in responses.
       #
@@ -54,6 +71,8 @@ module Courier
       #   @param subscription [Courier::Models::NotificationTemplatePayload::Subscription, nil] Subscription topic reference, or null for none.
       #
       #   @param tags [Array<String>] Tags for categorization. Send empty array for none.
+      #
+      #   @param email [Courier::Models::NotificationTemplateEmail, nil] Email header fields for the template's email channel: the From, Reply-to, CC and
 
       # @see Courier::Models::NotificationTemplatePayload#brand
       class Brand < Courier::Internal::Type::BaseModel

data/lib/courier/models/provider.rb

@@ -23,7 +23,10 @@ module Courier
       required :provider, String
 
       # @!attribute settings
-      #   Provider-specific settings (snake_case keys on the wire).
+      #   Provider-specific settings (snake_case keys on the wire). `rate_limit` is this
+      #   configuration's send rate limit,
+      #   `{ "rate": number, "period": "second" | "minute" | "hour" }`, or null for no
+      #   limit.
       #
       #   @return [Hash{Symbol=>Object}]
       required :settings, Courier::Internal::Type::HashOf[Courier::Internal::Type::Unknown]
@@ -47,6 +50,9 @@ module Courier
       optional :updated, Integer, nil?: true
 
       # @!method initialize(id:, created:, provider:, settings:, title:, alias_: nil, updated: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Courier::Models::Provider} for more details.
+      #
       #   A configured provider in the workspace.
       #
       #   @param id [String] A unique identifier for the provider configuration.
@@ -55,7 +61,7 @@ module Courier
       #
       #   @param provider [String] The provider key (e.g. "sendgrid", "twilio", "slack").
       #
-      #   @param settings [Hash{Symbol=>Object}] Provider-specific settings (snake_case keys on the wire).
+      #   @param settings [Hash{Symbol=>Object}] Provider-specific settings (snake_case keys on the wire). `rate_limit` is this c
       #
       #   @param title [String] Display title. Defaults to "Default Configuration" when not explicitly set.
       #

data/lib/courier/models/provider_create_params.rb

@@ -23,7 +23,17 @@ module Courier
       # @!attribute settings
       #   Provider-specific settings (snake_case keys). Defaults to an empty object when
       #   omitted. Use the catalog endpoint to discover required fields for a given
-      #   provider — omitting a required field returns a 400 validation error.
+      #   provider — omitting a required field returns a 400 validation error. Set
+      #   `rate_limit` to cap this configuration's send rate:
+      #   `{ "rate": <number greater than 0>, "period": "second" | "minute" | "hour" }`,
+      #   e.g. `{ "rate": 0.5, "period": "minute" }` for one send every 2 minutes. The
+      #   interval between sends (`period` divided by `rate`) must be from 1 millisecond
+      #   to 12 hours, otherwise the request returns a 400 `InvalidRateLimit` error. The
+      #   limit applies per configuration and per environment (a test-environment
+      #   configuration has its own limit). Sends above the rate are queued, not dropped,
+      #   and changes take up to 60 seconds to apply. It has no effect on observability or
+      #   CDP integrations, which do not send messages. Omit it or set it to null for no
+      #   limit.
       #
       #   @return [Hash{Symbol=>Object}, nil]
       optional :settings, Courier::Internal::Type::HashOf[Courier::Internal::Type::Unknown]

data/lib/courier/models/provider_patch_params.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # @see Courier::Resources::Providers#patch
+    class ProviderPatchParams < Courier::Internal::Type::BaseModel
+      extend Courier::Internal::Type::RequestParameters::Converter
+      include Courier::Internal::Type::RequestParameters
+
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute alias_
+      #   Updated alias. Set to null to clear it.
+      #
+      #   @return [String, nil]
+      optional :alias_, String, api_name: :alias, nil?: true
+
+      # @!attribute provider
+      #   The provider key identifying the type. Optional. When sent, it must match the
+      #   stored provider, otherwise the request returns a 400.
+      #
+      #   @return [String, nil]
+      optional :provider, String
+
+      # @!attribute settings
+      #   Provider-specific settings (snake_case keys) to merge into the stored settings,
+      #   using JSON Merge Patch (RFC 7396). Each key you send replaces the stored value,
+      #   a key set to null is removed, nested objects merge recursively, and arrays
+      #   replace the stored value. Keys you omit keep their stored values. Set
+      #   `rate_limit` to null to remove this configuration's send rate limit.
+      #
+      #   @return [Hash{Symbol=>Object}, nil]
+      optional :settings, Courier::Internal::Type::HashOf[Courier::Internal::Type::Unknown]
+
+      # @!attribute title
+      #   Updated display title.
+      #
+      #   @return [String, nil]
+      optional :title, String
+
+      # @!method initialize(id:, alias_: nil, provider: nil, settings: nil, title: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Courier::Models::ProviderPatchParams} for more details.
+      #
+      #   @param id [String]
+      #
+      #   @param alias_ [String, nil] Updated alias. Set to null to clear it.
+      #
+      #   @param provider [String] The provider key identifying the type. Optional. When sent, it must match the st
+      #
+      #   @param settings [Hash{Symbol=>Object}] Provider-specific settings (snake_case keys) to merge into the stored settings,
+      #
+      #   @param title [String] Updated display title.
+      #
+      #   @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/courier/models/provider_update_params.rb

@@ -28,7 +28,16 @@ module Courier
       # @!attribute settings
       #   Provider-specific settings (snake_case keys). Replaces the full settings object
       #   — omitted settings fields are removed. Use the catalog endpoint to check
-      #   required fields.
+      #   required fields. Set `rate_limit` to cap this configuration's send rate:
+      #   `{ "rate": <number greater than 0>, "period": "second" | "minute" | "hour" }`,
+      #   e.g. `{ "rate": 0.5, "period": "minute" }` for one send every 2 minutes. The
+      #   interval between sends (`period` divided by `rate`) must be from 1 millisecond
+      #   to 12 hours, otherwise the request returns a 400 `InvalidRateLimit` error. The
+      #   limit applies per configuration and per environment (a test-environment
+      #   configuration has its own limit). Sends above the rate are queued, not dropped,
+      #   and changes take up to 60 seconds to apply. It has no effect on observability or
+      #   CDP integrations, which do not send messages. Omitting `rate_limit` or setting
+      #   it to null removes any existing limit, including one set in Studio.
       #
       #   @return [Hash{Symbol=>Object}, nil]
       optional :settings, Courier::Internal::Type::HashOf[Courier::Internal::Type::Unknown]

data/lib/courier/models.rb

@@ -495,6 +495,8 @@ module Courier
 
   NotificationTemplateCreateRequest = Courier::Models::NotificationTemplateCreateRequest
 
+  NotificationTemplateEmail = Courier::Models::NotificationTemplateEmail
+
   NotificationTemplatePayload = Courier::Models::NotificationTemplatePayload
 
   NotificationTemplatePublishRequest = Courier::Models::NotificationTemplatePublishRequest
@@ -567,6 +569,8 @@ module Courier
 
   ProviderListParams = Courier::Models::ProviderListParams
 
+  ProviderPatchParams = Courier::Models::ProviderPatchParams
+
   ProviderRetrieveParams = Courier::Models::ProviderRetrieveParams
 
   Providers = Courier::Models::Providers

data/lib/courier/resources/providers.rb

@@ -149,6 +149,41 @@ module Courier
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Courier::Models::ProviderPatchParams} for more details.
+      #
+      # Updates part of a provider's configuration and keeps every field you omit.
+      # Settings merge into the stored settings key by key, and a setting sent as null
+      # is removed.
+      #
+      # @overload patch(id, alias_: nil, provider: nil, settings: nil, title: nil, request_options: {})
+      #
+      # @param id [String] A unique identifier of the provider configuration to update.
+      #
+      # @param alias_ [String, nil] Updated alias. Set to null to clear it.
+      #
+      # @param provider [String] The provider key identifying the type. Optional. When sent, it must match the st
+      #
+      # @param settings [Hash{Symbol=>Object}] Provider-specific settings (snake_case keys) to merge into the stored settings,
+      #
+      # @param title [String] Updated display title.
+      #
+      # @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Courier::Models::Provider]
+      #
+      # @see Courier::Models::ProviderPatchParams
+      def patch(id, params = {})
+        parsed, options = Courier::ProviderPatchParams.dump_request(params)
+        @client.request(
+          method: :patch,
+          path: ["providers/%1$s", id],
+          body: parsed,
+          model: Courier::Provider,
+          options: options
+        )
+      end
+
       # @api private
       #
       # @param client [Courier::Client]

data/lib/courier/version.rb

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

data/lib/courier.rb

@@ -348,6 +348,7 @@ require_relative "courier/models/notifications/previews/run_create_params"
 require_relative "courier/models/notifications/previews/run_list_params"
 require_relative "courier/models/notifications/previews/run_retrieve_params"
 require_relative "courier/models/notification_template_alias"
+require_relative "courier/models/notification_template_email"
 require_relative "courier/models/notification_template_response"
 require_relative "courier/models/notification_template_state"
 require_relative "courier/models/notification_template_summary"
@@ -389,6 +390,7 @@ require_relative "courier/models/provider_create_params"
 require_relative "courier/models/provider_delete_params"
 require_relative "courier/models/provider_list_params"
 require_relative "courier/models/provider_list_response"
+require_relative "courier/models/provider_patch_params"
 require_relative "courier/models/provider_retrieve_params"
 require_relative "courier/models/providers/catalog_list_params"
 require_relative "courier/models/providers/catalog_list_response"

data/rbi/courier/models/journey_ai_node.rbi

@@ -49,6 +49,11 @@ module Courier
       end
       attr_writer :conditions
 
+      # A supported AI model id. Requests with an unknown id may be rejected with a 400
+      # that lists the supported ids. Supported ids: `claude-fable-5-1`,
+      # `claude-opus-5-5`, `claude-sonnet-5-5`, `claude-haiku-5-5`, `gpt-6-astra`,
+      # `gpt-5.5`, `gpt-5.4`, `gpt-6.1-sol`, `gpt-5.4-mini`, `gpt-5.4-nano`,
+      # `gpt-6-luna`.
       sig { returns(T.nilable(String)) }
       attr_reader :model
 
@@ -94,6 +99,11 @@ module Courier
         # group, or an AND/OR nested group. Omit the `conditions` property entirely to
         # express "no conditions".
         conditions: nil,
+        # A supported AI model id. Requests with an unknown id may be rejected with a 400
+        # that lists the supported ids. Supported ids: `claude-fable-5-1`,
+        # `claude-opus-5-5`, `claude-sonnet-5-5`, `claude-haiku-5-5`, `gpt-6-astra`,
+        # `gpt-5.5`, `gpt-5.4`, `gpt-6.1-sol`, `gpt-5.4-mini`, `gpt-5.4-nano`,
+        # `gpt-6-luna`.
         model: nil,
         user_prompt: nil,
         web_search: nil

data/rbi/courier/models/notification_template_email.rbi

@@ -0,0 +1,82 @@
+# typed: strong
+
+module Courier
+  module Models
+    class NotificationTemplateEmail < Courier::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Courier::NotificationTemplateEmail, Courier::Internal::AnyHash)
+        end
+
+      # BCC addresses.
+      sig { returns(T.nilable(T::Array[String])) }
+      attr_reader :bcc
+
+      sig { params(bcc: T::Array[String]).void }
+      attr_writer :bcc
+
+      # CC addresses.
+      sig { returns(T.nilable(T::Array[String])) }
+      attr_reader :cc
+
+      sig { params(cc: T::Array[String]).void }
+      attr_writer :cc
+
+      # The From address.
+      sig { returns(T.nilable(String)) }
+      attr_reader :from
+
+      sig { params(from: String).void }
+      attr_writer :from
+
+      # The Reply-to address.
+      sig { returns(T.nilable(String)) }
+      attr_reader :reply_to
+
+      sig { params(reply_to: String).void }
+      attr_writer :reply_to
+
+      # Email header fields for the template's email channel: the From, Reply-to, CC and
+      # BCC values set in the Studio email channel settings. Each value may use template
+      # variables, such as `{{data.cc}}`, which are resolved at send time. Reads omit
+      # `email` when no header is set, and omit each unset field. Writes treat it as
+      # optional, with three meanings. Omit it to keep the stored headers. Send null to
+      # clear all four. Send an object to replace all four: a field the object leaves
+      # out is cleared. Other email channel settings, such as the subject, are kept
+      # either way. Headers only apply while `content` has an email channel; with no
+      # email channel they are not stored.
+      sig do
+        params(
+          bcc: T::Array[String],
+          cc: T::Array[String],
+          from: String,
+          reply_to: String
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # BCC addresses.
+        bcc: nil,
+        # CC addresses.
+        cc: nil,
+        # The From address.
+        from: nil,
+        # The Reply-to address.
+        reply_to: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            bcc: T::Array[String],
+            cc: T::Array[String],
+            from: String,
+            reply_to: String
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/courier/models/notification_template_payload.rbi

@@ -65,6 +65,25 @@ module Courier
       sig { returns(T::Array[String]) }
       attr_accessor :tags
 
+      # Email header fields for the template's email channel: the From, Reply-to, CC and
+      # BCC values set in the Studio email channel settings. Each value may use template
+      # variables, such as `{{data.cc}}`, which are resolved at send time. Reads omit
+      # `email` when no header is set, and omit each unset field. Writes treat it as
+      # optional, with three meanings. Omit it to keep the stored headers. Send null to
+      # clear all four. Send an object to replace all four: a field the object leaves
+      # out is cleared. Other email channel settings, such as the subject, are kept
+      # either way. Headers only apply while `content` has an email channel; with no
+      # email channel they are not stored.
+      sig { returns(T.nilable(Courier::NotificationTemplateEmail)) }
+      attr_reader :email
+
+      sig do
+        params(
+          email: T.nilable(Courier::NotificationTemplateEmail::OrHash)
+        ).void
+      end
+      attr_writer :email
+
       # Core template fields used in POST and PUT request bodies (nested under a
       # `notification` key) and returned at the top level in responses.
       sig do
@@ -78,7 +97,8 @@ module Courier
             T.nilable(
               Courier::NotificationTemplatePayload::Subscription::OrHash
             ),
-          tags: T::Array[String]
+          tags: T::Array[String],
+          email: T.nilable(Courier::NotificationTemplateEmail::OrHash)
         ).returns(T.attached_class)
       end
       def self.new(
@@ -93,7 +113,17 @@ module Courier
         # Subscription topic reference, or null for none.
         subscription:,
         # Tags for categorization. Send empty array for none.
-        tags:
+        tags:,
+        # Email header fields for the template's email channel: the From, Reply-to, CC and
+        # BCC values set in the Studio email channel settings. Each value may use template
+        # variables, such as `{{data.cc}}`, which are resolved at send time. Reads omit
+        # `email` when no header is set, and omit each unset field. Writes treat it as
+        # optional, with three meanings. Omit it to keep the stored headers. Send null to
+        # clear all four. Send an object to replace all four: a field the object leaves
+        # out is cleared. Other email channel settings, such as the subject, are kept
+        # either way. Headers only apply while `content` has an email channel; with no
+        # email channel they are not stored.
+        email: nil
       )
       end
 
@@ -106,7 +136,8 @@ module Courier
             routing: T.nilable(Courier::NotificationTemplatePayload::Routing),
             subscription:
               T.nilable(Courier::NotificationTemplatePayload::Subscription),
-            tags: T::Array[String]
+            tags: T::Array[String],
+            email: T.nilable(Courier::NotificationTemplateEmail)
           }
         )
       end

data/rbi/courier/models/provider.rbi

@@ -18,7 +18,10 @@ module Courier
       sig { returns(String) }
       attr_accessor :provider
 
-      # Provider-specific settings (snake_case keys on the wire).
+      # Provider-specific settings (snake_case keys on the wire). `rate_limit` is this
+      # configuration's send rate limit,
+      # `{ "rate": number, "period": "second" | "minute" | "hour" }`, or null for no
+      # limit.
       sig { returns(T::Hash[Symbol, T.anything]) }
       attr_accessor :settings
 
@@ -56,7 +59,10 @@ module Courier
         created:,
         # The provider key (e.g. "sendgrid", "twilio", "slack").
         provider:,
-        # Provider-specific settings (snake_case keys on the wire).
+        # Provider-specific settings (snake_case keys on the wire). `rate_limit` is this
+        # configuration's send rate limit,
+        # `{ "rate": number, "period": "second" | "minute" | "hour" }`, or null for no
+        # limit.
         settings:,
         # Display title. Defaults to "Default Configuration" when not explicitly set.
         title:,

data/rbi/courier/models/provider_create_params.rbi

@@ -25,7 +25,17 @@ module Courier
 
       # Provider-specific settings (snake_case keys). Defaults to an empty object when
       # omitted. Use the catalog endpoint to discover required fields for a given
-      # provider — omitting a required field returns a 400 validation error.
+      # provider — omitting a required field returns a 400 validation error. Set
+      # `rate_limit` to cap this configuration's send rate:
+      # `{ "rate": <number greater than 0>, "period": "second" | "minute" | "hour" }`,
+      # e.g. `{ "rate": 0.5, "period": "minute" }` for one send every 2 minutes. The
+      # interval between sends (`period` divided by `rate`) must be from 1 millisecond
+      # to 12 hours, otherwise the request returns a 400 `InvalidRateLimit` error. The
+      # limit applies per configuration and per environment (a test-environment
+      # configuration has its own limit). Sends above the rate are queued, not dropped,
+      # and changes take up to 60 seconds to apply. It has no effect on observability or
+      # CDP integrations, which do not send messages. Omit it or set it to null for no
+      # limit.
       sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
       attr_reader :settings
 
@@ -70,7 +80,17 @@ module Courier
         alias_: nil,
         # Provider-specific settings (snake_case keys). Defaults to an empty object when
         # omitted. Use the catalog endpoint to discover required fields for a given
-        # provider — omitting a required field returns a 400 validation error.
+        # provider — omitting a required field returns a 400 validation error. Set
+        # `rate_limit` to cap this configuration's send rate:
+        # `{ "rate": <number greater than 0>, "period": "second" | "minute" | "hour" }`,
+        # e.g. `{ "rate": 0.5, "period": "minute" }` for one send every 2 minutes. The
+        # interval between sends (`period` divided by `rate`) must be from 1 millisecond
+        # to 12 hours, otherwise the request returns a 400 `InvalidRateLimit` error. The
+        # limit applies per configuration and per environment (a test-environment
+        # configuration has its own limit). Sends above the rate are queued, not dropped,
+        # and changes take up to 60 seconds to apply. It has no effect on observability or
+        # CDP integrations, which do not send messages. Omit it or set it to null for no
+        # limit.
         settings: nil,
         # Optional display title. Omit to use "Default Configuration".
         title: nil,

data/rbi/courier/models/provider_patch_params.rbi

@@ -0,0 +1,92 @@
+# typed: strong
+
+module Courier
+  module Models
+    class ProviderPatchParams < Courier::Internal::Type::BaseModel
+      extend Courier::Internal::Type::RequestParameters::Converter
+      include Courier::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Courier::ProviderPatchParams, Courier::Internal::AnyHash)
+        end
+
+      sig { returns(String) }
+      attr_accessor :id
+
+      # Updated alias. Set to null to clear it.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :alias_
+
+      # The provider key identifying the type. Optional. When sent, it must match the
+      # stored provider, otherwise the request returns a 400.
+      sig { returns(T.nilable(String)) }
+      attr_reader :provider
+
+      sig { params(provider: String).void }
+      attr_writer :provider
+
+      # Provider-specific settings (snake_case keys) to merge into the stored settings,
+      # using JSON Merge Patch (RFC 7396). Each key you send replaces the stored value,
+      # a key set to null is removed, nested objects merge recursively, and arrays
+      # replace the stored value. Keys you omit keep their stored values. Set
+      # `rate_limit` to null to remove this configuration's send rate limit.
+      sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
+      attr_reader :settings
+
+      sig { params(settings: T::Hash[Symbol, T.anything]).void }
+      attr_writer :settings
+
+      # Updated display title.
+      sig { returns(T.nilable(String)) }
+      attr_reader :title
+
+      sig { params(title: String).void }
+      attr_writer :title
+
+      sig do
+        params(
+          id: String,
+          alias_: T.nilable(String),
+          provider: String,
+          settings: T::Hash[Symbol, T.anything],
+          title: String,
+          request_options: Courier::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        id:,
+        # Updated alias. Set to null to clear it.
+        alias_: nil,
+        # The provider key identifying the type. Optional. When sent, it must match the
+        # stored provider, otherwise the request returns a 400.
+        provider: nil,
+        # Provider-specific settings (snake_case keys) to merge into the stored settings,
+        # using JSON Merge Patch (RFC 7396). Each key you send replaces the stored value,
+        # a key set to null is removed, nested objects merge recursively, and arrays
+        # replace the stored value. Keys you omit keep their stored values. Set
+        # `rate_limit` to null to remove this configuration's send rate limit.
+        settings: nil,
+        # Updated display title.
+        title: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            id: String,
+            alias_: T.nilable(String),
+            provider: String,
+            settings: T::Hash[Symbol, T.anything],
+            title: String,
+            request_options: Courier::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/courier/models/provider_update_params.rbi

@@ -28,7 +28,16 @@ module Courier
 
       # Provider-specific settings (snake_case keys). Replaces the full settings object
       # — omitted settings fields are removed. Use the catalog endpoint to check
-      # required fields.
+      # required fields. Set `rate_limit` to cap this configuration's send rate:
+      # `{ "rate": <number greater than 0>, "period": "second" | "minute" | "hour" }`,
+      # e.g. `{ "rate": 0.5, "period": "minute" }` for one send every 2 minutes. The
+      # interval between sends (`period` divided by `rate`) must be from 1 millisecond
+      # to 12 hours, otherwise the request returns a 400 `InvalidRateLimit` error. The
+      # limit applies per configuration and per environment (a test-environment
+      # configuration has its own limit). Sends above the rate are queued, not dropped,
+      # and changes take up to 60 seconds to apply. It has no effect on observability or
+      # CDP integrations, which do not send messages. Omitting `rate_limit` or setting
+      # it to null removes any existing limit, including one set in Studio.
       sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
       attr_reader :settings
 
@@ -61,7 +70,16 @@ module Courier
         alias_: nil,
         # Provider-specific settings (snake_case keys). Replaces the full settings object
         # — omitted settings fields are removed. Use the catalog endpoint to check
-        # required fields.
+        # required fields. Set `rate_limit` to cap this configuration's send rate:
+        # `{ "rate": <number greater than 0>, "period": "second" | "minute" | "hour" }`,
+        # e.g. `{ "rate": 0.5, "period": "minute" }` for one send every 2 minutes. The
+        # interval between sends (`period` divided by `rate`) must be from 1 millisecond
+        # to 12 hours, otherwise the request returns a 400 `InvalidRateLimit` error. The
+        # limit applies per configuration and per environment (a test-environment
+        # configuration has its own limit). Sends above the rate are queued, not dropped,
+        # and changes take up to 60 seconds to apply. It has no effect on observability or
+        # CDP integrations, which do not send messages. Omitting `rate_limit` or setting
+        # it to null removes any existing limit, including one set in Studio.
         settings: nil,
         # Updated display title.
         title: nil,

data/rbi/courier/models.rbi

@@ -467,6 +467,8 @@ module Courier
   NotificationTemplateCreateRequest =
     Courier::Models::NotificationTemplateCreateRequest
 
+  NotificationTemplateEmail = Courier::Models::NotificationTemplateEmail
+
   NotificationTemplatePayload = Courier::Models::NotificationTemplatePayload
 
   NotificationTemplatePublishRequest =
@@ -546,6 +548,8 @@ module Courier
 
   ProviderListParams = Courier::Models::ProviderListParams
 
+  ProviderPatchParams = Courier::Models::ProviderPatchParams
+
   ProviderRetrieveParams = Courier::Models::ProviderRetrieveParams
 
   Providers = Courier::Models::Providers

data/rbi/courier/resources/providers.rbi

@@ -31,7 +31,17 @@ module Courier
         alias_: nil,
         # Body param: Provider-specific settings (snake_case keys). Defaults to an empty
         # object when omitted. Use the catalog endpoint to discover required fields for a
-        # given provider — omitting a required field returns a 400 validation error.
+        # given provider — omitting a required field returns a 400 validation error. Set
+        # `rate_limit` to cap this configuration's send rate:
+        # `{ "rate": <number greater than 0>, "period": "second" | "minute" | "hour" }`,
+        # e.g. `{ "rate": 0.5, "period": "minute" }` for one send every 2 minutes. The
+        # interval between sends (`period` divided by `rate`) must be from 1 millisecond
+        # to 12 hours, otherwise the request returns a 400 `InvalidRateLimit` error. The
+        # limit applies per configuration and per environment (a test-environment
+        # configuration has its own limit). Sends above the rate are queued, not dropped,
+        # and changes take up to 60 seconds to apply. It has no effect on observability or
+        # CDP integrations, which do not send messages. Omit it or set it to null for no
+        # limit.
         settings: nil,
         # Body param: Optional display title. Omit to use "Default Configuration".
         title: nil,
@@ -88,7 +98,16 @@ module Courier
         alias_: nil,
         # Provider-specific settings (snake_case keys). Replaces the full settings object
         # — omitted settings fields are removed. Use the catalog endpoint to check
-        # required fields.
+        # required fields. Set `rate_limit` to cap this configuration's send rate:
+        # `{ "rate": <number greater than 0>, "period": "second" | "minute" | "hour" }`,
+        # e.g. `{ "rate": 0.5, "period": "minute" }` for one send every 2 minutes. The
+        # interval between sends (`period` divided by `rate`) must be from 1 millisecond
+        # to 12 hours, otherwise the request returns a 400 `InvalidRateLimit` error. The
+        # limit applies per configuration and per environment (a test-environment
+        # configuration has its own limit). Sends above the rate are queued, not dropped,
+        # and changes take up to 60 seconds to apply. It has no effect on observability or
+        # CDP integrations, which do not send messages. Omitting `rate_limit` or setting
+        # it to null removes any existing limit, including one set in Studio.
         settings: nil,
         # Updated display title.
         title: nil,
@@ -126,6 +145,39 @@ module Courier
       )
       end
 
+      # Updates part of a provider's configuration and keeps every field you omit.
+      # Settings merge into the stored settings key by key, and a setting sent as null
+      # is removed.
+      sig do
+        params(
+          id: String,
+          alias_: T.nilable(String),
+          provider: String,
+          settings: T::Hash[Symbol, T.anything],
+          title: String,
+          request_options: Courier::RequestOptions::OrHash
+        ).returns(Courier::Provider)
+      end
+      def patch(
+        # A unique identifier of the provider configuration to update.
+        id,
+        # Updated alias. Set to null to clear it.
+        alias_: nil,
+        # The provider key identifying the type. Optional. When sent, it must match the
+        # stored provider, otherwise the request returns a 400.
+        provider: nil,
+        # Provider-specific settings (snake_case keys) to merge into the stored settings,
+        # using JSON Merge Patch (RFC 7396). Each key you send replaces the stored value,
+        # a key set to null is removed, nested objects merge recursively, and arrays
+        # replace the stored value. Keys you omit keep their stored values. Set
+        # `rate_limit` to null to remove this configuration's send rate limit.
+        settings: nil,
+        # Updated display title.
+        title: nil,
+        request_options: {}
+      )
+      end
+
       # @api private
       sig { params(client: Courier::Client).returns(T.attached_class) }
       def self.new(client:)

data/sig/courier/models/notification_template_email.rbs

@@ -0,0 +1,43 @@
+module Courier
+  module Models
+    type notification_template_email =
+      {
+        bcc: ::Array[String],
+        cc: ::Array[String],
+        from: String,
+        reply_to: String
+      }
+
+    class NotificationTemplateEmail < Courier::Internal::Type::BaseModel
+      attr_reader bcc: ::Array[String]?
+
+      def bcc=: (::Array[String]) -> ::Array[String]
+
+      attr_reader cc: ::Array[String]?
+
+      def cc=: (::Array[String]) -> ::Array[String]
+
+      attr_reader from: String?
+
+      def from=: (String) -> String
+
+      attr_reader reply_to: String?
+
+      def reply_to=: (String) -> String
+
+      def initialize: (
+        ?bcc: ::Array[String],
+        ?cc: ::Array[String],
+        ?from: String,
+        ?reply_to: String
+      ) -> void
+
+      def to_hash: -> {
+        bcc: ::Array[String],
+        cc: ::Array[String],
+        from: String,
+        reply_to: String
+      }
+    end
+  end
+end

data/sig/courier/models/notification_template_payload.rbs

@@ -7,7 +7,8 @@ module Courier
         name: String,
         routing: Courier::NotificationTemplatePayload::Routing?,
         subscription: Courier::NotificationTemplatePayload::Subscription?,
-        tags: ::Array[String]
+        tags: ::Array[String],
+        email: Courier::NotificationTemplateEmail?
       }
 
     class NotificationTemplatePayload < Courier::Internal::Type::BaseModel
@@ -23,13 +24,16 @@ module Courier
 
       attr_accessor tags: ::Array[String]
 
+      attr_accessor email: Courier::NotificationTemplateEmail?
+
       def initialize: (
         brand: Courier::NotificationTemplatePayload::Brand?,
         content: Courier::ElementalContent,
         name: String,
         routing: Courier::NotificationTemplatePayload::Routing?,
         subscription: Courier::NotificationTemplatePayload::Subscription?,
-        tags: ::Array[String]
+        tags: ::Array[String],
+        ?email: Courier::NotificationTemplateEmail?
       ) -> void
 
       def to_hash: -> {
@@ -38,7 +42,8 @@ module Courier
         name: String,
         routing: Courier::NotificationTemplatePayload::Routing?,
         subscription: Courier::NotificationTemplatePayload::Subscription?,
-        tags: ::Array[String]
+        tags: ::Array[String],
+        email: Courier::NotificationTemplateEmail?
       }
 
       type brand = { id: String }

data/sig/courier/models/provider_patch_params.rbs

@@ -0,0 +1,52 @@
+module Courier
+  module Models
+    type provider_patch_params =
+      {
+        id: String,
+        alias_: String?,
+        provider: String,
+        settings: ::Hash[Symbol, top],
+        title: String
+      }
+      & Courier::Internal::Type::request_parameters
+
+    class ProviderPatchParams < Courier::Internal::Type::BaseModel
+      extend Courier::Internal::Type::RequestParameters::Converter
+      include Courier::Internal::Type::RequestParameters
+
+      attr_accessor id: String
+
+      attr_accessor alias_: String?
+
+      attr_reader provider: String?
+
+      def provider=: (String) -> String
+
+      attr_reader settings: ::Hash[Symbol, top]?
+
+      def settings=: (::Hash[Symbol, top]) -> ::Hash[Symbol, top]
+
+      attr_reader title: String?
+
+      def title=: (String) -> String
+
+      def initialize: (
+        id: String,
+        ?alias_: String?,
+        ?provider: String,
+        ?settings: ::Hash[Symbol, top],
+        ?title: String,
+        ?request_options: Courier::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        id: String,
+        alias_: String?,
+        provider: String,
+        settings: ::Hash[Symbol, top],
+        title: String,
+        request_options: Courier::RequestOptions
+      }
+    end
+  end
+end

data/sig/courier/models.rbs

@@ -451,6 +451,8 @@ module Courier
 
   class NotificationTemplateCreateRequest = Courier::Models::NotificationTemplateCreateRequest
 
+  class NotificationTemplateEmail = Courier::Models::NotificationTemplateEmail
+
   class NotificationTemplatePayload = Courier::Models::NotificationTemplatePayload
 
   class NotificationTemplatePublishRequest = Courier::Models::NotificationTemplatePublishRequest
@@ -523,6 +525,8 @@ module Courier
 
   class ProviderListParams = Courier::Models::ProviderListParams
 
+  class ProviderPatchParams = Courier::Models::ProviderPatchParams
+
   class ProviderRetrieveParams = Courier::Models::ProviderRetrieveParams
 
   module Providers = Courier::Models::Providers

data/sig/courier/resources/providers.rbs

@@ -34,6 +34,15 @@ module Courier
 
       def delete: (String id, ?request_options: Courier::request_opts) -> nil
 
+      def patch: (
+        String id,
+        ?alias_: String?,
+        ?provider: String,
+        ?settings: ::Hash[Symbol, top],
+        ?title: String,
+        ?request_options: Courier::request_opts
+      ) -> Courier::Provider
+
       def initialize: (client: Courier::Client) -> void
     end
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: trycourier
 version: !ruby/object:Gem::Version
-  version: 6.11.3
+  version: 6.12.0
 platform: ruby
 authors:
 - Courier
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-30 00:00:00.000000000 Z
+date: 2026-10-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: connection_pool
@@ -318,6 +318,7 @@ files:
 - lib/courier/models/notification_retrieve_params.rb
 - lib/courier/models/notification_template_alias.rb
 - lib/courier/models/notification_template_create_request.rb
+- lib/courier/models/notification_template_email.rb
 - lib/courier/models/notification_template_payload.rb
 - lib/courier/models/notification_template_publish_request.rb
 - lib/courier/models/notification_template_response.rb
@@ -380,6 +381,7 @@ files:
 - lib/courier/models/provider_delete_params.rb
 - lib/courier/models/provider_list_params.rb
 - lib/courier/models/provider_list_response.rb
+- lib/courier/models/provider_patch_params.rb
 - lib/courier/models/provider_retrieve_params.rb
 - lib/courier/models/provider_update_params.rb
 - lib/courier/models/providers/catalog_list_params.rb
@@ -845,6 +847,7 @@ files:
 - rbi/courier/models/notification_retrieve_params.rbi
 - rbi/courier/models/notification_template_alias.rbi
 - rbi/courier/models/notification_template_create_request.rbi
+- rbi/courier/models/notification_template_email.rbi
 - rbi/courier/models/notification_template_payload.rbi
 - rbi/courier/models/notification_template_publish_request.rbi
 - rbi/courier/models/notification_template_response.rbi
@@ -907,6 +910,7 @@ files:
 - rbi/courier/models/provider_delete_params.rbi
 - rbi/courier/models/provider_list_params.rbi
 - rbi/courier/models/provider_list_response.rbi
+- rbi/courier/models/provider_patch_params.rbi
 - rbi/courier/models/provider_retrieve_params.rbi
 - rbi/courier/models/provider_update_params.rbi
 - rbi/courier/models/providers/catalog_list_params.rbi
@@ -1371,6 +1375,7 @@ files:
 - sig/courier/models/notification_retrieve_params.rbs
 - sig/courier/models/notification_template_alias.rbs
 - sig/courier/models/notification_template_create_request.rbs
+- sig/courier/models/notification_template_email.rbs
 - sig/courier/models/notification_template_payload.rbs
 - sig/courier/models/notification_template_publish_request.rbs
 - sig/courier/models/notification_template_response.rbs
@@ -1433,6 +1438,7 @@ files:
 - sig/courier/models/provider_delete_params.rbs
 - sig/courier/models/provider_list_params.rbs
 - sig/courier/models/provider_list_response.rbs
+- sig/courier/models/provider_patch_params.rbs
 - sig/courier/models/provider_retrieve_params.rbs
 - sig/courier/models/provider_update_params.rbs
 - sig/courier/models/providers/catalog_list_params.rbs