trycourier 6.5.0 → 6.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aec72cc2e6e742c57ffd2f2c5f8fde487e6597a34d0351cf4613abc3f369ab07
-  data.tar.gz: 037cfdab670141377df8fa5a5443c24b8d66e98b6ccc56b68c5db6176139bbb9
+  metadata.gz: 72f51e60173a98ce2cc1e4b6d3c0613e82f18de751e7ea855ed2418808cac4d9
+  data.tar.gz: 5a10110fea4a9c3b8c5acaf39d169a902c7a8566e4ddfb49933eaed3600c0924
 SHA512:
-  metadata.gz: f9355b12ee2ed402c0f2e13d1f20b23cf5e3ee63e23e627894f66f517cf0522f866626b28485d3a5c98cfd021869f3fea6aeb3112a3e2208d65abc2733b0b10a
-  data.tar.gz: 45f4b13f45dbb29cdc1ed14845e7ff243fa90f215f45a6c4fcc324a3c725ed750d907da8571e4eb2ccf7b894aa7b9884bba71892454bc0f36f9d0f8036668695
+  metadata.gz: 7940121c65ecbb1ef483b5f8594cdde2a3b08f1c93d22c04ebbd829b2989030e6d3bc43359b98196fc749a4c21fe8d54cb2a3355f37e057996da472e807751eb
+  data.tar.gz: 569ff793ab8fa5d18202278cd38630cb6556c391f3097e2931c938afb87e2a6c163c4b061bab684dc4a18d668843d0b36a7ebbb5b11699976483d49e466d5370

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [6.6.0](https://github.com/trycourier/courier-ruby/compare/v6.5.0...v6.6.0) (2026-09-15)
+
+
+### Features
+
+* **api:** digest configuration, per-recipient schedules, and release ([#154](https://github.com/trycourier/courier-ruby/issues/154)) ([abaf9f2](https://github.com/trycourier/courier-ruby/commit/abaf9f215ae6c9e6aaeb36e7313c9300da23b39b))
+
+
+### Documentation
+
+* **api:** group the topic digest endpoints under Digests, and match the docs voice ([#155](https://github.com/trycourier/courier-ruby/issues/155)) ([cb00e91](https://github.com/trycourier/courier-ruby/commit/cb00e91773b41f312db5c627ee500080da48b051))
+* **api:** stop teaching an aud_ prefix that Courier does not issue ([#152](https://github.com/trycourier/courier-ruby/issues/152)) ([1bd0f05](https://github.com/trycourier/courier-ruby/commit/1bd0f05a5e3db1e593c04046a7b20e9bdd1f64bf))
+
 ## [6.5.0](https://github.com/trycourier/courier-ruby/compare/v6.4.4...v6.5.0) (2026-09-04)
 
 

data/README.md

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

data/lib/courier/models/digest_day_of_week.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # A day of the week. Accepted case-insensitively, returned lowercase.
+    module DigestDayOfWeek
+      extend Courier::Internal::Type::Enum
+
+      SUNDAY = :sunday
+      MONDAY = :monday
+      TUESDAY = :tuesday
+      WEDNESDAY = :wednesday
+      THURSDAY = :thursday
+      FRIDAY = :friday
+      SATURDAY = :saturday
+
+      # @!method self.values
+      #   @return [Array<Symbol>]
+    end
+  end
+end

data/lib/courier/models/digest_frequency.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # How often a digest is delivered. `instant` delivers immediately without
+    # batching, and is the one value that takes no `time`.
+    module DigestFrequency
+      extend Courier::Internal::Type::Enum
+
+      INSTANT = :instant
+      DAILY = :daily
+      WEEKDAYS = :weekdays
+      WEEKLY = :weekly
+      CUSTOM_DAYS = :custom_days
+      MONTHLY = :monthly
+
+      # @!method self.values
+      #   @return [Array<Symbol>]
+    end
+  end
+end

data/lib/courier/models/journey_conditions_field.rb

@@ -12,10 +12,20 @@ module Courier
       # - Binary form (3 elements): `[path, operator, value]` where `operator`
       #   is one of `is equal`, `is not equal`, `contains`, `does not contain`,
       #   `starts with`, `ends with`, `greater than`, `greater than or equal`,
-      #   `less than`, `less than or equal`.
+      #   `less than`, `less than or equal`, `was`, `was not`.
       #
       #   Example: `["user.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`,
+      #   `OPENED`, `CLICKED`, `UNDELIVERABLE`. The first four are cumulative
+      #   and ordered `SENT < DELIVERED < OPENED < CLICKED`, so `was DELIVERED`
+      #   is true once the message has reached DELIVERED, OPENED, or CLICKED.
+      #   `UNDELIVERABLE` is an exact match only and is never part of that
+      #   ordering, in either direction.
+      #   Example:
+      #   `["send_status.P9Z3VCRJG647M7QNJZR3548HW741", "was", "DELIVERED"]`.
+      #
       # - Unary form (2 elements): `[path, operator]` where `operator` is
       #   one of `exists`, `does not exist`.
       #

data/lib/courier/models/journey_node.rb

@@ -47,7 +47,11 @@ module Courier
       # Collect events arriving at the node into a single batch and fire one downstream step with the aggregated payload. The first event into a batch owns the run; later contributing events terminate at the batch step. The batch releases when any of `max_items` is reached, a quiet window of `wait_period` elapses, or the `max_wait_period` ceiling hits.
       variant -> { Courier::JourneyNode::JourneyBatchNode }
 
-      # Add the current event to a digest keyed by the given subscription topic. The digest accumulates events and releases them on the schedule configured for the topic.
+      # Add the current event to a digest keyed by the given subscription topic. The digest accumulates events and releases them on the schedule configured for the topic, using the notification template configured on that topic. This node's `type` value is `add-to-digest`.
+      #
+      # **The topic must have a template configured.** If the topic has no template when the first event reaches this node, the journey run fails immediately: the run is marked `ERROR`, no digest instance is created, and the journey does not continue past this node. Configure the topic's template before using the topic in a journey.
+      #
+      # If the journey run is scoped to a tenant, digests are kept separate per tenant: two runs for the same user under different tenants accumulate and release as separate digests, even on the same topic.
       variant -> { Courier::JourneyNode::JourneyAddToDigestNode }
 
       # Terminate the journey run.
@@ -240,7 +244,18 @@ module Courier
         #
         #   Add the current event to a digest keyed by the given subscription topic. The
         #   digest accumulates events and releases them on the schedule configured for the
-        #   topic.
+        #   topic, using the notification template configured on that topic. This node's
+        #   `type` value is `add-to-digest`.
+        #
+        #   **The topic must have a template configured.** If the topic has no template when
+        #   the first event reaches this node, the journey run fails immediately: the run is
+        #   marked `ERROR`, no digest instance is created, and the journey does not continue
+        #   past this node. Configure the topic's template before using the topic in a
+        #   journey.
+        #
+        #   If the journey run is scoped to a tenant, digests are kept separate per tenant:
+        #   two runs for the same user under different tenants accumulate and release as
+        #   separate digests, even on the same topic.
         #
         #   @param subscription_topic_id [String] The subscription topic that owns the digest the event is added to.
         #

data/lib/courier/models/topic_digest_category.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    class TopicDigestCategory < Courier::Internal::Type::BaseModel
+      # @!attribute category_key
+      #   The key that identifies the category within the digest.
+      #
+      #   @return [String]
+      required :category_key, String
+
+      # @!attribute limit
+      #   How many collected events are carried into the rendered digest. Defaults to 10.
+      #
+      #   Events beyond the limit are discarded, not held back for the next digest: the
+      #   release consumes everything collected so far and only `limit` of them appear.
+      #   `retain` decides which ones those are.
+      #
+      #   @return [Integer, nil]
+      optional :limit, Integer
+
+      # @!attribute retain
+      #   Which collected events survive the `limit`. `FIRST` and `LOWEST` keep the
+      #   earliest or smallest; `LAST` and `HIGHEST` keep the latest or largest. Accepted
+      #   case-insensitively, returned uppercase.
+      #
+      #   @return [Symbol, Courier::Models::TopicDigestCategory::Retain, nil]
+      optional :retain, enum: -> { Courier::TopicDigestCategory::Retain }
+
+      # @!attribute sort_key
+      #   The data key used to rank events. Required when `retain` is `HIGHEST` or
+      #   `LOWEST`.
+      #
+      #   @return [String, nil]
+      optional :sort_key, String
+
+      # @!method initialize(category_key:, limit: nil, retain: nil, sort_key: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Courier::Models::TopicDigestCategory} for more details.
+      #
+      #   How events collected under a category key are retained when a digest holds more
+      #   than it will render.
+      #
+      #   @param category_key [String] The key that identifies the category within the digest.
+      #
+      #   @param limit [Integer] How many collected events are carried into the rendered digest. Defaults to 10.
+      #
+      #   @param retain [Symbol, Courier::Models::TopicDigestCategory::Retain] Which collected events survive the `limit`. `FIRST` and `LOWEST` keep the earlie
+      #
+      #   @param sort_key [String] The data key used to rank events. Required when `retain` is `HIGHEST` or `LOWEST
+
+      # Which collected events survive the `limit`. `FIRST` and `LOWEST` keep the
+      # earliest or smallest; `LAST` and `HIGHEST` keep the latest or largest. Accepted
+      # case-insensitively, returned uppercase.
+      #
+      # @see Courier::Models::TopicDigestCategory#retain
+      module Retain
+        extend Courier::Internal::Type::Enum
+
+        FIRST = :FIRST
+        LAST = :LAST
+        HIGHEST = :HIGHEST
+        LOWEST = :LOWEST
+        NONE = :NONE
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/courier/models/topic_digest_release_request.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    class TopicDigestReleaseRequest < Courier::Internal::Type::BaseModel
+      # @!attribute user_id
+      #   The recipient whose digest to release. Required: there is no "release everyone
+      #   on this topic" form, because a whole-schedule flush already has its own endpoint
+      #   and a body-shaped difference between one recipient and all of them is too easy
+      #   to get wrong.
+      #
+      #   @return [String]
+      required :user_id, String
+
+      # @!attribute tenant_id
+      #   The recipient's tenant, when they were sent to as part of one -- the same value
+      #   returned as `tenant_id` on a digest instance and sent as
+      #   `message.context.tenant_id`. It is part of the held digest's key, so a tenanted
+      #   recipient cannot be found without it. Omit for an ordinary recipient.
+      #
+      #   @return [String, nil]
+      optional :tenant_id, String
+
+      # @!method initialize(user_id:, tenant_id: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Courier::Models::TopicDigestReleaseRequest} for more details.
+      #
+      #   Which recipient's held digest to release.
+      #
+      #   @param user_id [String] The recipient whose digest to release. Required: there is no "release everyone o
+      #
+      #   @param tenant_id [String] The recipient's tenant, when they were sent to as part of one -- the same value
+    end
+  end
+end

data/lib/courier/models/topic_digest_request.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    class TopicDigestRequest < Courier::Internal::Type::BaseModel
+      # @!attribute schedules
+      #   The cadences this digest delivers on. At least one is required: a digest with no
+      #   schedule collects events into an instance that can never fire. Omitting the key
+      #   on a replace leaves stored schedules untouched; sending `[]` is a `400`.
+      #
+      #   @return [Array<Courier::Models::TopicDigestScheduleRequest>]
+      required :schedules, -> { Courier::Internal::Type::ArrayOf[Courier::TopicDigestScheduleRequest] }
+
+      # @!attribute template_id
+      #   The notification template that renders the digest. A digest with no template
+      #   collects nothing, so this is required.
+      #
+      #   @return [String]
+      required :template_id, String
+
+      # @!attribute audience_id
+      #   Optional audience the digest is scoped to.
+      #
+      #   @return [String, nil]
+      optional :audience_id, String
+
+      # @!attribute categories
+      #   Retention rules per category key. Defaults to a single `digest` category
+      #   retaining `FIRST`.
+      #
+      #   @return [Array<Courier::Models::TopicDigestCategory>, nil]
+      optional :categories, -> { Courier::Internal::Type::ArrayOf[Courier::TopicDigestCategory] }
+
+      # @!attribute trigger_empty
+      #   Whether to deliver the digest even when nothing was collected.
+      #
+      #   @return [Boolean, nil]
+      optional :trigger_empty, Courier::Internal::Type::Boolean
+
+      # @!method initialize(schedules:, template_id:, audience_id: nil, categories: nil, trigger_empty: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Courier::Models::TopicDigestRequest} for more details.
+      #
+      #   A topic's digest configuration: the template that renders it, the cadences it
+      #   delivers on, and how collected events are retained.
+      #
+      #   Send `null` for the whole object to turn a digest off, which unlinks the
+      #   template and removes its schedules. There is no `enabled` flag, and
+      #   `schedules: []` is rejected, because both states are un-deliverable rather than
+      #   merely off.
+      #
+      #   @param schedules [Array<Courier::Models::TopicDigestScheduleRequest>] The cadences this digest delivers on. At least one is required: a digest with no
+      #
+      #   @param template_id [String] The notification template that renders the digest. A digest with no template col
+      #
+      #   @param audience_id [String] Optional audience the digest is scoped to.
+      #
+      #   @param categories [Array<Courier::Models::TopicDigestCategory>] Retention rules per category key. Defaults to a single `digest` category retaini
+      #
+      #   @param trigger_empty [Boolean] Whether to deliver the digest even when nothing was collected.
+    end
+  end
+end

data/lib/courier/models/topic_digest_response.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    class TopicDigestResponse < Courier::Internal::Type::BaseModel
+      # @!attribute categories
+      #   Retention rules per category key.
+      #
+      #   @return [Array<Courier::Models::TopicDigestCategory>]
+      required :categories, -> { Courier::Internal::Type::ArrayOf[Courier::TopicDigestCategory] }
+
+      # @!attribute schedules
+      #   The digest's delivery cadences, each with its server-assigned `schedule_id`.
+      #
+      #   @return [Array<Courier::Models::TopicDigestScheduleResponse>]
+      required :schedules, -> { Courier::Internal::Type::ArrayOf[Courier::TopicDigestScheduleResponse] }
+
+      # @!attribute template_id
+      #   The notification template that renders the digest.
+      #
+      #   @return [String]
+      required :template_id, String
+
+      # @!attribute audience_id
+      #   The audience the digest is scoped to, when set.
+      #
+      #   @return [String, nil]
+      optional :audience_id, String
+
+      # @!attribute created
+      #   ISO-8601 timestamp of when the digest was configured.
+      #
+      #   @return [String, nil]
+      optional :created, String
+
+      # @!attribute trigger_empty
+      #   Whether the digest is delivered even when nothing was collected.
+      #
+      #   @return [Boolean, nil]
+      optional :trigger_empty, Courier::Internal::Type::Boolean
+
+      # @!attribute updated
+      #   ISO-8601 timestamp of the last update.
+      #
+      #   @return [String, nil]
+      optional :updated, String
+
+      # @!method initialize(categories:, schedules:, template_id:, audience_id: nil, created: nil, trigger_empty: nil, updated: nil)
+      #   A topic's digest configuration.
+      #
+      #   @param categories [Array<Courier::Models::TopicDigestCategory>] Retention rules per category key.
+      #
+      #   @param schedules [Array<Courier::Models::TopicDigestScheduleResponse>] The digest's delivery cadences, each with its server-assigned `schedule_id`.
+      #
+      #   @param template_id [String] The notification template that renders the digest.
+      #
+      #   @param audience_id [String] The audience the digest is scoped to, when set.
+      #
+      #   @param created [String] ISO-8601 timestamp of when the digest was configured.
+      #
+      #   @param trigger_empty [Boolean] Whether the digest is delivered even when nothing was collected.
+      #
+      #   @param updated [String] ISO-8601 timestamp of the last update.
+    end
+  end
+end

data/lib/courier/models/topic_digest_schedule_request.rb

@@ -0,0 +1,93 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    class TopicDigestScheduleRequest < Courier::Internal::Type::BaseModel
+      # @!attribute frequency
+      #   How often a digest is delivered. `instant` delivers immediately without
+      #   batching, and is the one value that takes no `time`.
+      #
+      #   @return [Symbol, Courier::Models::DigestFrequency]
+      required :frequency, enum: -> { Courier::DigestFrequency }
+
+      # @!attribute day_of_month
+      #   Required when `frequency` is `monthly`.
+      #
+      #   @return [Integer, nil]
+      optional :day_of_month, Integer
+
+      # @!attribute day_of_week
+      #   Required when `frequency` is `weekly`.
+      #
+      #   @return [Symbol, Courier::Models::DigestDayOfWeek, nil]
+      optional :day_of_week, enum: -> { Courier::DigestDayOfWeek }
+
+      # @!attribute days_of_week
+      #   Required when `frequency` is `custom_days`.
+      #
+      #   @return [Array<Symbol, Courier::Models::DigestDayOfWeek>, nil]
+      optional :days_of_week, -> { Courier::Internal::Type::ArrayOf[enum: Courier::DigestDayOfWeek] }
+
+      # @!attribute disabled
+      #   Whether the schedule is disabled.
+      #
+      #   @return [Boolean, nil]
+      optional :disabled, Courier::Internal::Type::Boolean
+
+      # @!attribute is_default
+      #   The schedule recipients are placed on when they have not chosen one. Set this
+      #   explicitly rather than relying on array position.
+      #
+      #   @return [Boolean, nil]
+      optional :is_default, Courier::Internal::Type::Boolean
+
+      # @!attribute schedule_id
+      #   Identifier of an existing schedule to update. Omit when creating a new one.
+      #
+      #   @return [String, nil]
+      optional :schedule_id, String
+
+      # @!attribute time
+      #   24-hour local delivery time, `HH:MM`. Required for every frequency except
+      #   `instant`.
+      #
+      #   @return [String, nil]
+      optional :time, String
+
+      # @!attribute timezone
+      #   IANA timezone the `time` and day fields are expressed in, e.g.
+      #   `America/New_York`. Absent means UTC. Delivery follows the same local wall-clock
+      #   across daylight-saving changes.
+      #
+      #   @return [String, nil]
+      optional :timezone, String
+
+      # @!method initialize(frequency:, day_of_month: nil, day_of_week: nil, days_of_week: nil, disabled: nil, is_default: nil, schedule_id: nil, time: nil, timezone: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Courier::Models::TopicDigestScheduleRequest} for more details.
+      #
+      #   One delivery cadence for a topic's digest. Supply `schedule_id` to update an
+      #   existing schedule in place; omit it and one is assigned and returned. The
+      #   `schedules` array is a full replacement, so a stored schedule absent from it is
+      #   deleted along with its delivery rule.
+      #
+      #   @param frequency [Symbol, Courier::Models::DigestFrequency] How often a digest is delivered. `instant` delivers immediately without batching
+      #
+      #   @param day_of_month [Integer] Required when `frequency` is `monthly`.
+      #
+      #   @param day_of_week [Symbol, Courier::Models::DigestDayOfWeek] Required when `frequency` is `weekly`.
+      #
+      #   @param days_of_week [Array<Symbol, Courier::Models::DigestDayOfWeek>] Required when `frequency` is `custom_days`.
+      #
+      #   @param disabled [Boolean] Whether the schedule is disabled.
+      #
+      #   @param is_default [Boolean] The schedule recipients are placed on when they have not chosen one. Set this ex
+      #
+      #   @param schedule_id [String] Identifier of an existing schedule to update. Omit when creating a new one.
+      #
+      #   @param time [String] 24-hour local delivery time, `HH:MM`. Required for every frequency except `insta
+      #
+      #   @param timezone [String] IANA timezone the `time` and day fields are expressed in, e.g. `America/New_York
+    end
+  end
+end

data/lib/courier/models/topic_digest_schedule_response.rb

@@ -0,0 +1,103 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    class TopicDigestScheduleResponse < Courier::Internal::Type::BaseModel
+      # @!attribute schedule_id
+      #   The schedule's identifier, assigned by the server. This is the value the
+      #   `/digests/schedules/{schedule_id}` endpoints are keyed by.
+      #
+      #   @return [String]
+      required :schedule_id, String
+
+      # @!attribute created
+      #   ISO-8601 timestamp of when the schedule was created.
+      #
+      #   @return [String, nil]
+      optional :created, String
+
+      # @!attribute day_of_month
+      #   Day of the month, 1-31.
+      #
+      #   @return [Integer, nil]
+      optional :day_of_month, Integer
+
+      # @!attribute day_of_week
+      #   A day of the week. Accepted case-insensitively, returned lowercase.
+      #
+      #   @return [Symbol, Courier::Models::DigestDayOfWeek, nil]
+      optional :day_of_week, enum: -> { Courier::DigestDayOfWeek }
+
+      # @!attribute days_of_week
+      #
+      #   @return [Array<Symbol, Courier::Models::DigestDayOfWeek>, nil]
+      optional :days_of_week, -> { Courier::Internal::Type::ArrayOf[enum: Courier::DigestDayOfWeek] }
+
+      # @!attribute disabled
+      #   Whether the schedule is disabled.
+      #
+      #   @return [Boolean, nil]
+      optional :disabled, Courier::Internal::Type::Boolean
+
+      # @!attribute frequency
+      #   Omitted for a stored schedule this enum cannot express. Those schedules never
+      #   fire, but their `schedule_id` is still returned so the `/digests/*` endpoints
+      #   remain reachable for them.
+      #
+      #   @return [Symbol, Courier::Models::DigestFrequency, nil]
+      optional :frequency, enum: -> { Courier::DigestFrequency }
+
+      # @!attribute is_default
+      #   Whether this is the schedule recipients are placed on by default.
+      #
+      #   @return [Boolean, nil]
+      optional :is_default, Courier::Internal::Type::Boolean
+
+      # @!attribute time
+      #   24-hour local delivery time, `HH:MM`.
+      #
+      #   @return [String, nil]
+      optional :time, String
+
+      # @!attribute timezone
+      #   IANA timezone the schedule is expressed in. Absent means UTC.
+      #
+      #   @return [String, nil]
+      optional :timezone, String
+
+      # @!attribute updated
+      #   ISO-8601 timestamp of the last update.
+      #
+      #   @return [String, nil]
+      optional :updated, String
+
+      # @!method initialize(schedule_id:, created: nil, day_of_month: nil, day_of_week: nil, days_of_week: nil, disabled: nil, frequency: nil, is_default: nil, time: nil, timezone: nil, updated: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Courier::Models::TopicDigestScheduleResponse} for more details.
+      #
+      #   A delivery cadence for a topic's digest, with its assigned id.
+      #
+      #   @param schedule_id [String] The schedule's identifier, assigned by the server. This is the value the `/diges
+      #
+      #   @param created [String] ISO-8601 timestamp of when the schedule was created.
+      #
+      #   @param day_of_month [Integer] Day of the month, 1-31.
+      #
+      #   @param day_of_week [Symbol, Courier::Models::DigestDayOfWeek] A day of the week. Accepted case-insensitively, returned lowercase.
+      #
+      #   @param days_of_week [Array<Symbol, Courier::Models::DigestDayOfWeek>]
+      #
+      #   @param disabled [Boolean] Whether the schedule is disabled.
+      #
+      #   @param frequency [Symbol, Courier::Models::DigestFrequency] Omitted for a stored schedule this enum cannot express. Those schedules never fi
+      #
+      #   @param is_default [Boolean] Whether this is the schedule recipients are placed on by default.
+      #
+      #   @param time [String] 24-hour local delivery time, `HH:MM`.
+      #
+      #   @param timezone [String] IANA timezone the schedule is expressed in. Absent means UTC.
+      #
+      #   @param updated [String] ISO-8601 timestamp of the last update.
+    end
+  end
+end

data/lib/courier/models/users/preference_update_or_create_topic_params.rb

@@ -58,6 +58,16 @@ module Courier
                    -> { Courier::Internal::Type::ArrayOf[enum: Courier::ChannelClassification] },
                    nil?: true
 
+          # @!attribute digest_schedule_id
+          #   Put this recipient on one of the topic's digest schedules. Send `null` to clear
+          #   the choice and return them to the topic's default. Omit to leave an existing
+          #   choice alone, unlike the routing fields, which this endpoint replaces. An id
+          #   that is not an active schedule on the topic is rejected with a `400` before
+          #   anything is written.
+          #
+          #   @return [String, nil]
+          optional :digest_schedule_id, String, nil?: true
+
           # @!attribute has_custom_routing
           #   Set to true to route this topic to the channels in custom_routing instead of the
           #   topic's default routing.
@@ -65,7 +75,7 @@ module Courier
           #   @return [Boolean, nil]
           optional :has_custom_routing, Courier::Internal::Type::Boolean, nil?: true
 
-          # @!method initialize(status:, custom_routing: nil, has_custom_routing: nil)
+          # @!method initialize(status:, custom_routing: nil, digest_schedule_id: nil, has_custom_routing: nil)
           #   Some parameter documentations has been truncated, see
           #   {Courier::Models::Users::PreferenceUpdateOrCreateTopicParams::Topic} for more
           #   details.
@@ -74,6 +84,8 @@ module Courier
           #
           #   @param custom_routing [Array<Symbol, Courier::Models::ChannelClassification>, nil] The channels to deliver this topic on when has_custom_routing is true. One or mo
           #
+          #   @param digest_schedule_id [String, nil] Put this recipient on one of the topic's digest schedules. Send `null` to clear
+          #
           #   @param has_custom_routing [Boolean, nil] Set to true to route this topic to the channels in custom_routing instead of the
         end
       end

data/lib/courier/models/users/topic_preference.rb

@@ -41,6 +41,15 @@ module Courier
                  -> { Courier::Internal::Type::ArrayOf[enum: Courier::ChannelClassification] },
                  nil?: true
 
+        # @!attribute digest_schedule_id
+        #   The digest schedule this recipient is on for the topic. Omitted rather than null
+        #   when they have not chosen one, in which case the topic's default schedule
+        #   applies. Ids come from the topic's digest configuration or from
+        #   `GET /digests/schedules`.
+        #
+        #   @return [String, nil]
+        optional :digest_schedule_id, String
+
         # @!attribute has_custom_routing
         #   Whether the user has chosen specific delivery channels for this topic (listed in
         #   custom_routing) rather than the topic's default routing.
@@ -64,7 +73,7 @@ module Courier
         #   @return [String, nil]
         optional :section_name, String
 
-        # @!method initialize(default_status:, status:, topic_id:, topic_name:, custom_routing: nil, has_custom_routing: nil, section_id: nil, section_name: nil)
+        # @!method initialize(default_status:, status:, topic_id:, topic_name:, custom_routing: nil, digest_schedule_id: nil, has_custom_routing: nil, section_id: nil, section_name: nil)
         #   Some parameter documentations has been truncated, see
         #   {Courier::Models::Users::TopicPreference} for more details.
         #
@@ -78,6 +87,8 @@ module Courier
         #
         #   @param custom_routing [Array<Symbol, Courier::Models::ChannelClassification>, nil] The channels the user has chosen to receive this topic on, present only when has
         #
+        #   @param digest_schedule_id [String] The digest schedule this recipient is on for the topic. Omitted rather than null
+        #
         #   @param has_custom_routing [Boolean, nil] Whether the user has chosen specific delivery channels for this topic (listed in
         #
         #   @param section_id [String] The unique identifier of the section this topic belongs to. Always present when