trycourier 6.11.3 → 6.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bc663969984ae8b94e9f2f522dc24ea9e1cbf1eed91ba357b565038bedb939ab
-  data.tar.gz: 5cfd3e3767063edef226cf90ec1e6833e6122660be98b0d499b3e8007cea090f
+  metadata.gz: adeed3b02658fe1c360d234bbd24ce3c2c3dcd34637b766514178b3ea473cbb5
+  data.tar.gz: dfc4345ec2d9db5bbd66bca95fae14eb11fb5a8a19d8afa7b7493a0325786583
 SHA512:
-  metadata.gz: 3482fdf2ca8fa7c825ff9259dabd2daa76c085cd65c79ee6f5bba64c19308aabfa933f9601f871b9167fa41017c76a2687c34710589544d34f1403d5469e2a74
-  data.tar.gz: e9a750836a3948eb31382b228503d9ad8360cf6309f8943efd550baab5c6607bb9ebce02a0dcb60b9a3d61e1481d024050e5158ac1c799ea555513b96c3815e0
+  metadata.gz: 0e7711edd3bc7c6b0602ed7e8545cadadf2c10727de043474aec07e7ad121b1bfe324ac8d8c11efa77a15082a600c3ac26725146198359876a16b49178979b5d
+  data.tar.gz: 9cf63697464b8a65544002c1c50552c6a8c835012fad7cecd94373f5fbba7233361fde3bf16f41c4919409f6f5892092d12ea45f5d369bae960d0afc5ce017a1

data/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## [6.13.0](https://github.com/trycourier/courier-ruby/compare/v6.12.0...v6.13.0) (2026-10-23)
+
+
+### Features
+
+* **api:** journey run steps return error and skip_reason ([#179](https://github.com/trycourier/courier-ruby/issues/179)) ([d5a8120](https://github.com/trycourier/courier-ruby/commit/d5a8120a93e5524ea27c5c075819a9f6d2a8b9f4))
+
+
+### Chores
+
+* **api:** regenerate SDK ([#181](https://github.com/trycourier/courier-ruby/issues/181)) ([eadaf17](https://github.com/trycourier/courier-ruby/commit/eadaf17a4f75bd8d8825522d213eecb513b3c872))
+
+## [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.13.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/journey_conditions_field.rb

@@ -14,7 +14,7 @@ module Courier
       #   `starts with`, `ends with`, `greater than`, `greater than or equal`,
       #   `less than`, `less than or equal`, `was`, `was not`.
       #
-      #   Example: `["user.tier", "is equal", "gold"]`.
+      #   Example: `["profile.tier", "is equal", "gold"]`.
       #
       #   `was` / `was not` compare a `send_status.<nodeId>` path (referencing
       #   an earlier send node's node id) against one of `SENT`, `DELIVERED`,
@@ -29,9 +29,9 @@ module Courier
       # - Unary form (2 elements): `[path, operator]` where `operator` is
       #   one of `exists`, `does not exist`.
       #
-      #   Example: `["user.email", "exists"]`.
+      #   Example: `["profile.email", "exists"]`.
       #
-      # The first element is a non-empty dot-path. The second element is the operator (must come from one of the two operator sets above). For the binary form, the third element is the comparison value (string). Runtime validation of the operator value and arity is performed by the backend; SDKs surface this as a string list.
+      # The first element is a non-empty dot-path that starts with `data.`, `profile.`, `tenant.` (only when the trigger sets a tenant), or `send_status.<nodeId>`. The second element is the operator (must come from one of the two operator sets above). For the binary form, the third element is the comparison value (string). Runtime validation of the operator value and arity is performed by the backend; SDKs surface this as a string list.
       variant -> { Courier::JourneyConditionAtom }
 
       # A leaf condition group. Exactly one of `AND` or `OR` must be present at runtime; each is a list of `JourneyConditionAtom` tuples.

data/lib/courier/models/journey_run_step.rb

@@ -9,6 +9,19 @@ module Courier
       #   @return [String]
       required :action, String
 
+      # @!attribute error
+      #   Why the step failed. Set when `status` is `ERROR`, `null` otherwise.
+      #
+      #   @return [Courier::Models::JourneyRunStep::Error, nil]
+      required :error, -> { Courier::JourneyRunStep::Error }, nil?: true
+
+      # @!attribute skip_reason
+      #   Why the step was skipped, e.g. `Node conditions not met`. Set when `status` is
+      #   `SKIPPED`, `null` otherwise.
+      #
+      #   @return [String, nil]
+      required :skip_reason, String, nil?: true
+
       # @!attribute status
       #   The state of the step: the seven run statuses, plus `SKIPPED` and `COMPUTING`.
       #   Not an enum — new values have been added before.
@@ -42,7 +55,7 @@ module Courier
       #   @return [String, nil]
       optional :updated_at, String
 
-      # @!method initialize(action:, status:, created_at: nil, message_id: nil, node_id: nil, updated_at: nil)
+      # @!method initialize(action:, error:, skip_reason:, status:, created_at: nil, message_id: nil, node_id: nil, updated_at: nil)
       #   Some parameter documentations has been truncated, see
       #   {Courier::Models::JourneyRunStep} for more details.
       #
@@ -51,6 +64,10 @@ module Courier
       #
       #   @param action [String] The kind of node that ran, e.g. `send`, `delay`, or `exit`.
       #
+      #   @param error [Courier::Models::JourneyRunStep::Error, nil] Why the step failed. Set when `status` is `ERROR`, `null` otherwise.
+      #
+      #   @param skip_reason [String, nil] Why the step was skipped, e.g. `Node conditions not met`. Set when `status` is `
+      #
       #   @param status [String] The state of the step: the seven run statuses, plus `SKIPPED` and `COMPUTING`. N
       #
       #   @param created_at [String] When the step started, as an ISO 8601 timestamp.
@@ -60,6 +77,24 @@ module Courier
       #   @param node_id [String] The id of the node in the published Journey that this step executed.
       #
       #   @param updated_at [String] When the step last changed state, as an ISO 8601 timestamp.
+
+      # @see Courier::Models::JourneyRunStep#error
+      class Error < Courier::Internal::Type::BaseModel
+        # @!attribute message
+        #   The reason, e.g. `Fetch failed: GET api.example.com returned 404` or
+        #   `AI step timed out after 15 minutes`.
+        #
+        #   @return [String]
+        required :message, String
+
+        # @!method initialize(message:)
+        #   Some parameter documentations has been truncated, see
+        #   {Courier::Models::JourneyRunStep::Error} for more details.
+        #
+        #   Why the step failed. Set when `status` is `ERROR`, `null` otherwise.
+        #
+        #   @param message [String] The reason, e.g. `Fetch failed: GET api.example.com returned 404` or `AI step ti
+      end
     end
   end
 end

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.13.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/journey_run_step.rbi

@@ -12,6 +12,20 @@ module Courier
       sig { returns(String) }
       attr_accessor :action
 
+      # Why the step failed. Set when `status` is `ERROR`, `null` otherwise.
+      sig { returns(T.nilable(Courier::JourneyRunStep::Error)) }
+      attr_reader :error
+
+      sig do
+        params(error: T.nilable(Courier::JourneyRunStep::Error::OrHash)).void
+      end
+      attr_writer :error
+
+      # Why the step was skipped, e.g. `Node conditions not met`. Set when `status` is
+      # `SKIPPED`, `null` otherwise.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :skip_reason
+
       # The state of the step: the seven run statuses, plus `SKIPPED` and `COMPUTING`.
       # Not an enum — new values have been added before.
       sig { returns(String) }
@@ -52,6 +66,8 @@ module Courier
       sig do
         params(
           action: String,
+          error: T.nilable(Courier::JourneyRunStep::Error::OrHash),
+          skip_reason: T.nilable(String),
           status: String,
           created_at: String,
           message_id: String,
@@ -62,6 +78,11 @@ module Courier
       def self.new(
         # The kind of node that ran, e.g. `send`, `delay`, or `exit`.
         action:,
+        # Why the step failed. Set when `status` is `ERROR`, `null` otherwise.
+        error:,
+        # Why the step was skipped, e.g. `Node conditions not met`. Set when `status` is
+        # `SKIPPED`, `null` otherwise.
+        skip_reason:,
         # The state of the step: the seven run statuses, plus `SKIPPED` and `COMPUTING`.
         # Not an enum — new values have been added before.
         status:,
@@ -82,6 +103,8 @@ module Courier
         override.returns(
           {
             action: String,
+            error: T.nilable(Courier::JourneyRunStep::Error),
+            skip_reason: T.nilable(String),
             status: String,
             created_at: String,
             message_id: String,
@@ -92,6 +115,31 @@ module Courier
       end
       def to_hash
       end
+
+      class Error < Courier::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(Courier::JourneyRunStep::Error, Courier::Internal::AnyHash)
+          end
+
+        # The reason, e.g. `Fetch failed: GET api.example.com returned 404` or
+        # `AI step timed out after 15 minutes`.
+        sig { returns(String) }
+        attr_accessor :message
+
+        # Why the step failed. Set when `status` is `ERROR`, `null` otherwise.
+        sig { params(message: String).returns(T.attached_class) }
+        def self.new(
+          # The reason, e.g. `Fetch failed: GET api.example.com returned 404` or
+          # `AI step timed out after 15 minutes`.
+          message:
+        )
+        end
+
+        sig { override.returns({ message: String }) }
+        def to_hash
+        end
+      end
     end
   end
 end

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