trycourier 4.17.1 → 4.18.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 767d16490b100cdf1a74b068086a2d8dce286dc441ceaf2d6a1014f7a87e8117
-  data.tar.gz: c5d5013207f3876f9a2a98c87ece15788851f3720dc48a4e5814a3a7ba0273d7
+  metadata.gz: ce3813405deb188367bed5849b23a16ea329a497b654278d0a18b2f992b15bec
+  data.tar.gz: dd921945bf22141d5505b42420046cd6447a77b033f9866714c8f6fa7692e240
 SHA512:
-  metadata.gz: 170f814c04185d95c823f0309563ba0223b661d4079dc8cddd34785234fe39b2c8c7a1dfa54171f7e752897f82be866d26a6bd97f54a4a06babb23a155aa4b9b
-  data.tar.gz: f18775095318e5eafdd9cc9b7cfe8b8109d06f7ba86c61e397436db89173030257808fc07a75b1ffeb7f6f63777fc4c8d6d6e7dded71c29d5c2e601a7a09f7ff
+  metadata.gz: 9174a2e66c46289020fe6d1837690667a7fc1918b7035a18f964be0b46b55eb41cee98a5f8befd8c5acae02b07030e47d0c49e6fd50114be096565850981c849
+  data.tar.gz: 48a7ccea6a0357ae2c452a7f9e727daf41b4675a884eb7c03dc1cf20b18a052bae53b022357f69a1e3841ab4ad38662ccca5b026beea8e5261dd44238f69291e

data/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog
 
+## 4.18.1 (2026-07-07)
+
+Full Changelog: [v4.18.0...v4.18.1](https://github.com/trycourier/courier-ruby/compare/v4.18.0...v4.18.1)
+
+### Documentation
+
+* **openapi:** document audiences filter combinator (SUP-686) ([fdf42fe](https://github.com/trycourier/courier-ruby/commit/fdf42fecbd77058dbba53a198942efa509bbc1a1))
+
+## 4.18.0 (2026-07-06)
+
+Full Changelog: [v4.17.1...v4.18.0](https://github.com/trycourier/courier-ruby/compare/v4.17.1...v4.18.0)
+
+### Features
+
+* **openapi:** Journeys cancel-by-token endpoint + send-node experiments (C-18986) ([12613c6](https://github.com/trycourier/courier-ruby/commit/12613c65e9b4facc19f7fa23cc92fac0b2ea8684))
+
+
+### Chores
+
+* **internal:** bound formatter parallelism to CPU count ([192d613](https://github.com/trycourier/courier-ruby/commit/192d6133c29e2ae7bfcd7c54bd1c244894f01b94))
+
+
+### Documentation
+
+* **openapi:** reword Cancel journey runs 400 description (re-trigger deploy) ([89ceaab](https://github.com/trycourier/courier-ruby/commit/89ceaab2e20d45c3dd807427f5e4d248ba94cc8a))
+* **openapi:** reword Cancel journey runs description (re-trigger deploy) ([ccce802](https://github.com/trycourier/courier-ruby/commit/ccce8027d4279de031ff2f7e95a250e512dbfbed))
+* **openapi:** tighten Journeys cancel/experiment copy (C-19177) ([10c4f1d](https://github.com/trycourier/courier-ruby/commit/10c4f1d3ca27c525ec5d75d49f4bb30cc0d6180d))
+
 ## 4.17.1 (2026-06-25)
 
 Full Changelog: [v4.17.0...v4.17.1](https://github.com/trycourier/courier-ruby/compare/v4.17.0...v4.17.1)

data/lib/courier/models/audience.rb

@@ -39,7 +39,8 @@ module Courier
       optional :filter, -> { Courier::AudienceFilterConfig }, nil?: true
 
       # @!attribute operator
-      #   The logical operator (AND/OR) for the top-level filter
+      #   The logical operator (AND/OR) combining the top-level `filter.filters`.
+      #   Convenience alias for `filter.operator`.
       #
       #   @return [Symbol, Courier::Models::Audience::Operator, nil]
       optional :operator, enum: -> { Courier::Audience::Operator }
@@ -60,9 +61,10 @@ module Courier
       #
       #   @param filter [Courier::Models::AudienceFilterConfig, nil] Filter configuration for audience membership containing an array of filter rules
       #
-      #   @param operator [Symbol, Courier::Models::Audience::Operator] The logical operator (AND/OR) for the top-level filter
+      #   @param operator [Symbol, Courier::Models::Audience::Operator] The logical operator (AND/OR) combining the top-level `filter.filters`. Convenie
 
-      # The logical operator (AND/OR) for the top-level filter
+      # The logical operator (AND/OR) combining the top-level `filter.filters`.
+      # Convenience alias for `filter.operator`.
       #
       # @see Courier::Models::Audience#operator
       module Operator

data/lib/courier/models/audience_filter_config.rb

@@ -9,10 +9,38 @@ module Courier
       #   @return [Array<Courier::Models::FilterConfig>]
       required :filters, -> { Courier::Internal::Type::ArrayOf[Courier::FilterConfig] }
 
-      # @!method initialize(filters:)
+      # @!attribute operator
+      #   The logical operator (AND/OR) combining the rules in `filters`. Required when
+      #   `filters` contains more than one rule. If omitted, the top-level `operator`
+      #   field on the request is used instead.
+      #
+      #   @return [Symbol, Courier::Models::AudienceFilterConfig::Operator, nil]
+      optional :operator, enum: -> { Courier::AudienceFilterConfig::Operator }
+
+      # @!method initialize(filters:, operator: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Courier::Models::AudienceFilterConfig} for more details.
+      #
       #   Filter configuration for audience membership containing an array of filter rules
       #
       #   @param filters [Array<Courier::Models::FilterConfig>] Array of filter rules (single conditions or nested groups)
+      #
+      #   @param operator [Symbol, Courier::Models::AudienceFilterConfig::Operator] The logical operator (AND/OR) combining the rules in `filters`. Required when `f
+
+      # The logical operator (AND/OR) combining the rules in `filters`. Required when
+      # `filters` contains more than one rule. If omitted, the top-level `operator`
+      # field on the request is used instead.
+      #
+      # @see Courier::Models::AudienceFilterConfig#operator
+      module Operator
+        extend Courier::Internal::Type::Enum
+
+        AND = :AND
+        OR = :OR
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
     end
   end
 end

data/lib/courier/models/audience_update_params.rb

@@ -31,7 +31,9 @@ module Courier
       optional :name, String, nil?: true
 
       # @!attribute operator
-      #   The logical operator (AND/OR) for the top-level filter
+      #   The logical operator (AND/OR) combining the top-level `filter.filters`.
+      #   Convenience alias for `filter.operator`: if set, it is applied to the top-level
+      #   filter group. Prefer setting `operator` directly inside `filter`.
       #
       #   @return [Symbol, Courier::Models::AudienceUpdateParams::Operator, nil]
       optional :operator, enum: -> { Courier::AudienceUpdateParams::Operator }, nil?: true
@@ -48,11 +50,13 @@ module Courier
       #
       #   @param name [String, nil] The name of the audience
       #
-      #   @param operator [Symbol, Courier::Models::AudienceUpdateParams::Operator, nil] The logical operator (AND/OR) for the top-level filter
+      #   @param operator [Symbol, Courier::Models::AudienceUpdateParams::Operator, nil] The logical operator (AND/OR) combining the top-level `filter.filters`. Convenie
       #
       #   @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
 
-      # The logical operator (AND/OR) for the top-level filter
+      # The logical operator (AND/OR) combining the top-level `filter.filters`.
+      # Convenience alias for `filter.operator`: if set, it is applied to the top-level
+      # filter group. Prefer setting `operator` directly inside `filter`.
       module Operator
         extend Courier::Internal::Type::Enum
 

data/lib/courier/models/cancel_journey_request.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # Request body for `POST /journeys/cancel`. Provide EXACTLY ONE of
+    # `cancelation_token` (cancels every run associated with the token) or `run_id`
+    # (cancels a single tenant-scoped run).
+    module CancelJourneyRequest
+      extend Courier::Internal::Type::Union
+
+      variant -> { Courier::CancelJourneyRequest::ByCancelationToken }
+
+      variant -> { Courier::CancelJourneyRequest::ByRunID }
+
+      class ByCancelationToken < Courier::Internal::Type::BaseModel
+        # @!attribute cancelation_token
+        #
+        #   @return [String]
+        required :cancelation_token, String
+
+        # @!method initialize(cancelation_token:)
+        #   @param cancelation_token [String]
+      end
+
+      class ByRunID < Courier::Internal::Type::BaseModel
+        # @!attribute run_id
+        #
+        #   @return [String]
+        required :run_id, String
+
+        # @!method initialize(run_id:)
+        #   @param run_id [String]
+      end
+
+      # @!method self.variants
+      #   @return [Array(Courier::Models::CancelJourneyRequest::ByCancelationToken, Courier::Models::CancelJourneyRequest::ByRunID)]
+    end
+  end
+end

data/lib/courier/models/cancel_journey_response.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # `202 Accepted` body for `POST /journeys/cancel`, returning the submitted
+    # identifier. When called with `cancelation_token`, returns
+    # `{ cancelation_token }`; when called with `run_id`, returns
+    # `{ run_id, status }`.
+    #
+    # @see Courier::Resources::Journeys#cancel
+    module CancelJourneyResponse
+      extend Courier::Internal::Type::Union
+
+      variant -> { Courier::CancelJourneyResponse::TokenBranch }
+
+      variant -> { Courier::CancelJourneyResponse::RunIDBranch }
+
+      class TokenBranch < Courier::Internal::Type::BaseModel
+        # @!attribute cancelation_token
+        #
+        #   @return [String]
+        required :cancelation_token, String
+
+        # @!method initialize(cancelation_token:)
+        #   @param cancelation_token [String]
+      end
+
+      class RunIDBranch < Courier::Internal::Type::BaseModel
+        # @!attribute run_id
+        #
+        #   @return [String]
+        required :run_id, String
+
+        # @!attribute status
+        #   The run's resulting status. `CANCELED` when the run was active and has been
+        #   canceled; `PROCESSED` or `ERROR` when the run had already finished and was left
+        #   unchanged; `CANCELED` for an already-canceled run.
+        #
+        #   @return [String]
+        required :status, String
+
+        # @!method initialize(run_id:, status:)
+        #   Some parameter documentations has been truncated, see
+        #   {Courier::Models::CancelJourneyResponse::RunIDBranch} for more details.
+        #
+        #   @param run_id [String]
+        #
+        #   @param status [String] The run's resulting status. `CANCELED` when the run was active and has been canc
+      end
+
+      # @!method self.variants
+      #   @return [Array(Courier::Models::CancelJourneyResponse::TokenBranch, Courier::Models::CancelJourneyResponse::RunIDBranch)]
+    end
+  end
+end

data/lib/courier/models/journey_cancel_params.rb

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

data/lib/courier/models/journey_experiment.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    class JourneyExperiment < Courier::Internal::Type::BaseModel
+      # @!attribute bucketing_key
+      #   The value used to deterministically assign a recipient to a variant. Must be
+      #   non-empty with no leading or trailing whitespace.
+      #
+      #   @return [String]
+      required :bucketing_key, String, api_name: :bucketingKey
+
+      # @!attribute variants
+      #   Between 2 and 10 weighted template variants.
+      #
+      #   @return [Array<Courier::Models::JourneyExperimentVariant>]
+      required :variants, -> { Courier::Internal::Type::ArrayOf[Courier::JourneyExperimentVariant] }
+
+      # @!attribute id
+      #   Unique experiment id (prefixed `exp_`). Omit to have one generated
+      #   automatically; when supplied it must be a valid `exp_` id.
+      #
+      #   @return [String, nil]
+      optional :id, String
+
+      # @!attribute name
+      #   Optional display name for the experiment.
+      #
+      #   @return [String, nil]
+      optional :name, String
+
+      # @!method initialize(bucketing_key:, variants:, id: nil, name: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Courier::Models::JourneyExperiment} for more details.
+      #
+      #   A/B experiment config for a send node. The recipient is deterministically
+      #   bucketed by `bucketingKey` and routed to one of the `variants` in proportion to
+      #   its `weight`. Present on a send node INSTEAD OF `message.template`.
+      #
+      #   @param bucketing_key [String] The value used to deterministically assign a recipient to a variant. Must be non
+      #
+      #   @param variants [Array<Courier::Models::JourneyExperimentVariant>] Between 2 and 10 weighted template variants.
+      #
+      #   @param id [String] Unique experiment id (prefixed `exp_`). Omit to have one generated automatically
+      #
+      #   @param name [String] Optional display name for the experiment.
+    end
+  end
+end

data/lib/courier/models/journey_experiment_variant.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    class JourneyExperimentVariant < Courier::Internal::Type::BaseModel
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute template_id
+      #   The notification template sent for this variant.
+      #
+      #   @return [String]
+      required :template_id, String, api_name: :templateId
+
+      # @!attribute weight
+      #   Relative routing weight. Must be non-negative.
+      #
+      #   @return [Float]
+      required :weight, Float
+
+      # @!attribute name
+      #   Optional display name for the variant.
+      #
+      #   @return [String, nil]
+      optional :name, String
+
+      # @!method initialize(id:, template_id:, weight:, name: nil)
+      #   A single weighted variant of an experiment. Variant ids must be unique within
+      #   the experiment and the sum of all variant weights must be greater than 0.
+      #   Weights are relative (no sum-to-100 requirement) — routing normalizes them
+      #   proportionally.
+      #
+      #   @param id [String]
+      #
+      #   @param template_id [String] The notification template sent for this variant.
+      #
+      #   @param weight [Float] Relative routing weight. Must be non-negative.
+      #
+      #   @param name [String] Optional display name for the variant.
+    end
+  end
+end

data/lib/courier/models/journey_node.rb

@@ -14,7 +14,7 @@ module Courier
       # Trigger fired by a segment event (`identify`, `group`, or `track`).
       variant -> { Courier::JourneySegmentTriggerNode }
 
-      # Send a notification template to the recipient. Optionally override the recipient address, delay the send, or attach `data`.
+      # Send to the recipient. A send node sources its content from EXACTLY ONE of `message.template` (a single notification template) or `experiment` (an A/B split across weighted template variants) — supplying both, or neither, is rejected. Optionally override the recipient address, delay the send, or attach `data`.
       variant -> { Courier::JourneySendNode }
 
       # Pause the journey run for a fixed `duration`.

data/lib/courier/models/journey_send_node.rb

@@ -26,12 +26,23 @@ module Courier
       #   @return [Array<String>, Courier::Models::JourneyConditionGroup, Courier::Models::JourneyConditionNestedGroup, nil]
       optional :conditions, union: -> { Courier::JourneyConditionsField }
 
-      # @!method initialize(message:, type:, id: nil, conditions: nil)
+      # @!attribute experiment
+      #   A/B experiment config for a send node. The recipient is deterministically
+      #   bucketed by `bucketingKey` and routed to one of the `variants` in proportion to
+      #   its `weight`. Present on a send node INSTEAD OF `message.template`.
+      #
+      #   @return [Courier::Models::JourneyExperiment, nil]
+      optional :experiment, -> { Courier::JourneyExperiment }
+
+      # @!method initialize(message:, type:, id: nil, conditions: nil, experiment: nil)
       #   Some parameter documentations has been truncated, see
       #   {Courier::Models::JourneySendNode} for more details.
       #
-      #   Send a notification template to the recipient. Optionally override the recipient
-      #   address, delay the send, or attach `data`.
+      #   Send to the recipient. A send node sources its content from EXACTLY ONE of
+      #   `message.template` (a single notification template) or `experiment` (an A/B
+      #   split across weighted template variants) — supplying both, or neither, is
+      #   rejected. Optionally override the recipient address, delay the send, or attach
+      #   `data`.
       #
       #   @param message [Courier::Models::JourneySendNode::Message]
       #
@@ -40,14 +51,11 @@ module Courier
       #   @param id [String]
       #
       #   @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 experiment [Courier::Models::JourneyExperiment] A/B experiment config for a send node. The recipient is deterministically bucket
 
       # @see Courier::Models::JourneySendNode#message
       class Message < Courier::Internal::Type::BaseModel
-        # @!attribute template
-        #
-        #   @return [String]
-        required :template, String
-
         # @!attribute data
         #
         #   @return [Hash{Symbol=>Object}, nil]
@@ -58,15 +66,20 @@ module Courier
         #   @return [Courier::Models::JourneySendNode::Message::Delay, nil]
         optional :delay, -> { Courier::JourneySendNode::Message::Delay }
 
+        # @!attribute template
+        #
+        #   @return [String, nil]
+        optional :template, String
+
         # @!attribute to
         #
         #   @return [Courier::Models::JourneySendNode::Message::To, nil]
         optional :to, -> { Courier::JourneySendNode::Message::To }
 
-        # @!method initialize(template:, data: nil, delay: nil, to: nil)
-        #   @param template [String]
+        # @!method initialize(data: nil, delay: nil, template: nil, to: nil)
         #   @param data [Hash{Symbol=>Object}]
         #   @param delay [Courier::Models::JourneySendNode::Message::Delay]
+        #   @param template [String]
         #   @param to [Courier::Models::JourneySendNode::Message::To]
 
         # @see Courier::Models::JourneySendNode::Message#delay

data/lib/courier/models.rb

@@ -123,6 +123,10 @@ module Courier
 
   BulkRunJobParams = Courier::Models::BulkRunJobParams
 
+  CancelJourneyRequest = Courier::Models::CancelJourneyRequest
+
+  CancelJourneyResponse = Courier::Models::CancelJourneyResponse
+
   Channel = Courier::Models::Channel
 
   ChannelClassification = Courier::Models::ChannelClassification
@@ -207,6 +211,8 @@ module Courier
 
   JourneyArchiveParams = Courier::Models::JourneyArchiveParams
 
+  JourneyCancelParams = Courier::Models::JourneyCancelParams
+
   # @type [Courier::Internal::Type::Converter]
   JourneyConditionAtom = Courier::Models::JourneyConditionAtom
 
@@ -224,6 +230,10 @@ module Courier
 
   JourneyExitNode = Courier::Models::JourneyExitNode
 
+  JourneyExperiment = Courier::Models::JourneyExperiment
+
+  JourneyExperimentVariant = Courier::Models::JourneyExperimentVariant
+
   JourneyFetchGetDeleteNode = Courier::Models::JourneyFetchGetDeleteNode
 
   JourneyFetchPostPutNode = Courier::Models::JourneyFetchPostPutNode

data/lib/courier/resources/audiences.rb

@@ -38,7 +38,7 @@ module Courier
       #
       # @param name [String, nil] The name of the audience
       #
-      # @param operator [Symbol, Courier::Models::AudienceUpdateParams::Operator, nil] The logical operator (AND/OR) for the top-level filter
+      # @param operator [Symbol, Courier::Models::AudienceUpdateParams::Operator, nil] The logical operator (AND/OR) combining the top-level `filter.filters`. Convenie
       #
       # @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}, nil]
       #

data/lib/courier/resources/journeys.rb

@@ -114,6 +114,36 @@ module Courier
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Courier::Models::JourneyCancelParams} for more details.
+      #
+      # Cancel journey runs. The request body must include EXACTLY ONE of
+      # `cancelation_token` (cancels every run associated with the token) or `run_id`
+      # (cancels a single tenant-scoped run). Supplying both or neither returns a `400`.
+      # A `run_id` that does not match a run for the tenant returns `404`. Cancelation
+      # is idempotent: a run that has already finished (`PROCESSED`/`ERROR`) or was
+      # already `CANCELED` is left unchanged and its current status is returned.
+      #
+      # @overload cancel(cancel_journey_request:, request_options: {})
+      #
+      # @param cancel_journey_request [Courier::Models::CancelJourneyRequest::ByCancelationToken, Courier::Models::CancelJourneyRequest::ByRunID] Request body for `POST /journeys/cancel`. Provide EXACTLY ONE of `cancelation_to
+      #
+      # @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Courier::Models::CancelJourneyResponse::TokenBranch, Courier::Models::CancelJourneyResponse::RunIDBranch]
+      #
+      # @see Courier::Models::JourneyCancelParams
+      def cancel(params)
+        parsed, options = Courier::JourneyCancelParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "journeys/cancel",
+          body: parsed[:cancel_journey_request],
+          model: Courier::CancelJourneyResponse,
+          options: options
+        )
+      end
+
       # Some parameter documentations has been truncated, see
       # {Courier::Models::JourneyInvokeParams} for more details.
       #

data/lib/courier/version.rb

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

data/lib/courier.rb

@@ -58,6 +58,7 @@ require_relative "courier/models/inbound_bulk_message_user"
 require_relative "courier/models/base_check"
 require_relative "courier/models/subscription_topic_new"
 require_relative "courier/models/elemental_channel_node"
+require_relative "courier/models/cancel_journey_request"
 require_relative "courier/models/create_journey_request"
 require_relative "courier/models/journeys_invoke_request"
 require_relative "courier/models/journey_publish_request"
@@ -131,6 +132,7 @@ require_relative "courier/models/bulk_list_users_response"
 require_relative "courier/models/bulk_retrieve_job_params"
 require_relative "courier/models/bulk_retrieve_job_response"
 require_relative "courier/models/bulk_run_job_params"
+require_relative "courier/models/cancel_journey_response"
 require_relative "courier/models/channel"
 require_relative "courier/models/channel_classification"
 require_relative "courier/models/channel_metadata"
@@ -171,6 +173,7 @@ require_relative "courier/models/journey"
 require_relative "courier/models/journey_ai_node"
 require_relative "courier/models/journey_api_invoke_trigger_node"
 require_relative "courier/models/journey_archive_params"
+require_relative "courier/models/journey_cancel_params"
 require_relative "courier/models/journey_condition_atom"
 require_relative "courier/models/journey_condition_group"
 require_relative "courier/models/journey_condition_nested_group"
@@ -179,6 +182,8 @@ require_relative "courier/models/journey_create_params"
 require_relative "courier/models/journey_delay_duration_node"
 require_relative "courier/models/journey_delay_until_node"
 require_relative "courier/models/journey_exit_node"
+require_relative "courier/models/journey_experiment"
+require_relative "courier/models/journey_experiment_variant"
 require_relative "courier/models/journey_fetch_get_delete_node"
 require_relative "courier/models/journey_fetch_post_put_node"
 require_relative "courier/models/journey_invoke_params"

data/rbi/courier/models/audience.rbi

@@ -33,7 +33,8 @@ module Courier
       end
       attr_writer :filter
 
-      # The logical operator (AND/OR) for the top-level filter
+      # The logical operator (AND/OR) combining the top-level `filter.filters`.
+      # Convenience alias for `filter.operator`.
       sig { returns(T.nilable(Courier::Audience::Operator::TaggedSymbol)) }
       attr_reader :operator
 
@@ -62,7 +63,8 @@ module Courier
         updated_at:,
         # Filter configuration for audience membership containing an array of filter rules
         filter: nil,
-        # The logical operator (AND/OR) for the top-level filter
+        # The logical operator (AND/OR) combining the top-level `filter.filters`.
+        # Convenience alias for `filter.operator`.
         operator: nil
       )
       end
@@ -83,7 +85,8 @@ module Courier
       def to_hash
       end
 
-      # The logical operator (AND/OR) for the top-level filter
+      # The logical operator (AND/OR) combining the top-level `filter.filters`.
+      # Convenience alias for `filter.operator`.
       module Operator
         extend Courier::Internal::Type::Enum
 

data/rbi/courier/models/audience_filter_config.rbi

@@ -12,21 +12,70 @@ module Courier
       sig { returns(T::Array[Courier::FilterConfig]) }
       attr_accessor :filters
 
+      # The logical operator (AND/OR) combining the rules in `filters`. Required when
+      # `filters` contains more than one rule. If omitted, the top-level `operator`
+      # field on the request is used instead.
+      sig do
+        returns(T.nilable(Courier::AudienceFilterConfig::Operator::OrSymbol))
+      end
+      attr_reader :operator
+
+      sig do
+        params(operator: Courier::AudienceFilterConfig::Operator::OrSymbol).void
+      end
+      attr_writer :operator
+
       # Filter configuration for audience membership containing an array of filter rules
       sig do
-        params(filters: T::Array[Courier::FilterConfig::OrHash]).returns(
-          T.attached_class
-        )
+        params(
+          filters: T::Array[Courier::FilterConfig::OrHash],
+          operator: Courier::AudienceFilterConfig::Operator::OrSymbol
+        ).returns(T.attached_class)
       end
       def self.new(
         # Array of filter rules (single conditions or nested groups)
-        filters:
+        filters:,
+        # The logical operator (AND/OR) combining the rules in `filters`. Required when
+        # `filters` contains more than one rule. If omitted, the top-level `operator`
+        # field on the request is used instead.
+        operator: nil
       )
       end
 
-      sig { override.returns({ filters: T::Array[Courier::FilterConfig] }) }
+      sig do
+        override.returns(
+          {
+            filters: T::Array[Courier::FilterConfig],
+            operator: Courier::AudienceFilterConfig::Operator::OrSymbol
+          }
+        )
+      end
       def to_hash
       end
+
+      # The logical operator (AND/OR) combining the rules in `filters`. Required when
+      # `filters` contains more than one rule. If omitted, the top-level `operator`
+      # field on the request is used instead.
+      module Operator
+        extend Courier::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Courier::AudienceFilterConfig::Operator)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        AND = T.let(:AND, Courier::AudienceFilterConfig::Operator::TaggedSymbol)
+        OR = T.let(:OR, Courier::AudienceFilterConfig::Operator::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[Courier::AudienceFilterConfig::Operator::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
     end
   end
 end