trycourier 6.9.0 → 6.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6b9fddd9ae2196561574c358366ddd7830227d3990aaa52e89858de7e6b84cd9
-  data.tar.gz: a8c10271062a26d1389aee6ba8a645c05f35261b4db2b713b37868ce6fc504ea
+  metadata.gz: 2bab9f203d342c48548c1f0e174e23733585494b0b3b8369d2ccedab9fbbaf34
+  data.tar.gz: 86a57ea48f82c3e4f7da5536bd4c2a3b80c07dfb9178ccdc8d36da6ef74c74ad
 SHA512:
-  metadata.gz: 8d783b22c1f61fc844e696322372651dd2204b99c7a3d661d0223e64fb2e328bee79853279612d989540d92b2c97e82ca0f46a1ebc444020b855cadb9b0fa0dc
-  data.tar.gz: e351011729fe6a218f2730bc2f2e2d5b7f4e722c80d9416fe74b95159634e00562eec047035d84f43ef65cc2c6b0f1f91ffbf890da900e7fc630b164ea52bdf4
+  metadata.gz: 94fb163ff7c2e6cd81eb20e028fbbf5a0cedc2f3eb299864a3c7f19c6c2d838f329dcf329b02438318bc1ab20cba5d56604377f2e359d54d298c620ac0384340
+  data.tar.gz: e7f0b03ecf872ddf5bc0b38a28fbd0c1bd169241e31c9729c623f1b1e7f42b58155d1ec30e3ddf60ae93aa9fb9a40337403b7f7bc581f0852a3f11cd844b5d54

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [6.10.0](https://github.com/trycourier/courier-ruby/compare/v6.9.0...v6.10.0) (2026-09-24)
+
+
+### Features
+
+* **api:** add GET /preferences/logs [C-21018] ([9303520](https://github.com/trycourier/courier-ruby/commit/930352053ab0a9ca9db9b5a06b7da82ce7f6c811))
+
 ## [6.9.0](https://github.com/trycourier/courier-ruby/compare/v6.8.0...v6.9.0) (2026-09-23)
 
 

data/README.md

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

data/lib/courier/models/preference_change_log_entry.rb

@@ -0,0 +1,94 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    class PreferenceChangeLogEntry < Courier::Internal::Type::BaseModel
+      # @!attribute id
+      #   Unique identifier for this change.
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute custom_routing
+      #   The channels chosen for this topic, present only when has_custom_routing is
+      #   true. Empty otherwise.
+      #
+      #   @return [Array<Symbol, Courier::Models::ChannelClassification>]
+      required :custom_routing, -> { Courier::Internal::Type::ArrayOf[enum: Courier::ChannelClassification] }
+
+      # @!attribute has_custom_routing
+      #   Whether specific delivery channels were chosen for this topic rather than the
+      #   topic's default routing.
+      #
+      #   @return [Boolean]
+      required :has_custom_routing, Courier::Internal::Type::Boolean
+
+      # @!attribute status
+      #   The subscription status the change set.
+      #
+      #   @return [Symbol, Courier::Models::PreferenceStatus]
+      required :status, enum: -> { Courier::PreferenceStatus }
+
+      # @!attribute timestamp
+      #   When the change was made, as an ISO-8601 date-time in UTC.
+      #
+      #   @return [String]
+      required :timestamp, String
+
+      # @!attribute topic_id
+      #   The subscription topic the change applies to.
+      #
+      #   @return [String]
+      required :topic_id, String
+
+      # @!attribute topic_name
+      #   The display name of that topic when the change was made.
+      #
+      #   @return [String]
+      required :topic_name, String
+
+      # @!attribute user_id
+      #   The user whose preference changed.
+      #
+      #   @return [String]
+      required :user_id, String
+
+      # @!attribute previous
+      #   The value before this change, where it was recorded.
+      #
+      #   @return [Courier::Models::PreferenceChangeLogValue, nil]
+      optional :previous, -> { Courier::PreferenceChangeLogValue }
+
+      # @!attribute tenant_id
+      #   The tenant context the change was made in. Absent when the user set the
+      #   preference outside any tenant.
+      #
+      #   @return [String, nil]
+      optional :tenant_id, String
+
+      # @!method initialize(id:, custom_routing:, has_custom_routing:, status:, timestamp:, topic_id:, topic_name:, user_id:, previous: nil, tenant_id: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Courier::Models::PreferenceChangeLogEntry} for more details.
+      #
+      #   @param id [String] Unique identifier for this change.
+      #
+      #   @param custom_routing [Array<Symbol, Courier::Models::ChannelClassification>] The channels chosen for this topic, present only when has_custom_routing is true
+      #
+      #   @param has_custom_routing [Boolean] Whether specific delivery channels were chosen for this topic rather than the to
+      #
+      #   @param status [Symbol, Courier::Models::PreferenceStatus] The subscription status the change set.
+      #
+      #   @param timestamp [String] When the change was made, as an ISO-8601 date-time in UTC.
+      #
+      #   @param topic_id [String] The subscription topic the change applies to.
+      #
+      #   @param topic_name [String] The display name of that topic when the change was made.
+      #
+      #   @param user_id [String] The user whose preference changed.
+      #
+      #   @param previous [Courier::Models::PreferenceChangeLogValue] The value before this change, where it was recorded.
+      #
+      #   @param tenant_id [String] The tenant context the change was made in. Absent when the user set the preferen
+    end
+  end
+end

data/lib/courier/models/preference_change_log_value.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    class PreferenceChangeLogValue < Courier::Internal::Type::BaseModel
+      # @!attribute custom_routing
+      #   The channels chosen before the change.
+      #
+      #   @return [Array<Symbol, Courier::Models::ChannelClassification>]
+      required :custom_routing, -> { Courier::Internal::Type::ArrayOf[enum: Courier::ChannelClassification] }
+
+      # @!attribute has_custom_routing
+      #   Whether custom routing was in effect before the change.
+      #
+      #   @return [Boolean]
+      required :has_custom_routing, Courier::Internal::Type::Boolean
+
+      # @!attribute status
+      #   The subscription status before the change.
+      #
+      #   @return [Symbol, Courier::Models::PreferenceStatus]
+      required :status, enum: -> { Courier::PreferenceStatus }
+
+      # @!method initialize(custom_routing:, has_custom_routing:, status:)
+      #   @param custom_routing [Array<Symbol, Courier::Models::ChannelClassification>] The channels chosen before the change.
+      #
+      #   @param has_custom_routing [Boolean] Whether custom routing was in effect before the change.
+      #
+      #   @param status [Symbol, Courier::Models::PreferenceStatus] The subscription status before the change.
+    end
+  end
+end

data/lib/courier/models/preference_logs_list_response.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # @see Courier::Resources::WorkspacePreferences#list_logs
+    class PreferenceLogsListResponse < Courier::Internal::Type::BaseModel
+      # @!attribute items
+      #   One entry per preference change, newest first.
+      #
+      #   @return [Array<Courier::Models::PreferenceChangeLogEntry>]
+      required :items, -> { Courier::Internal::Type::ArrayOf[Courier::PreferenceChangeLogEntry] }
+
+      # @!attribute paging
+      #
+      #   @return [Courier::Models::Paging]
+      required :paging, -> { Courier::Paging }
+
+      # @!method initialize(items:, paging:)
+      #   @param items [Array<Courier::Models::PreferenceChangeLogEntry>] One entry per preference change, newest first.
+      #
+      #   @param paging [Courier::Models::Paging]
+    end
+  end
+end

data/lib/courier/models/workspace_preference_list_logs_params.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # @see Courier::Resources::WorkspacePreferences#list_logs
+    class WorkspacePreferenceListLogsParams < Courier::Internal::Type::BaseModel
+      extend Courier::Internal::Type::RequestParameters::Converter
+      include Courier::Internal::Type::RequestParameters
+
+      # @!attribute cursor
+      #   A cursor from a previous response's paging.cursor. Continue only while
+      #   paging.more is true; the cursor is omitted on the last page.
+      #
+      #   @return [String, nil]
+      optional :cursor, String
+
+      # @!attribute limit
+      #   How many entries to return. Defaults to 25.
+      #
+      #   @return [Integer, nil]
+      optional :limit, Integer
+
+      # @!attribute since
+      #   Return only changes at or after this time, as an ISO-8601 date or date-time. A
+      #   date alone is read as the start of that day in UTC.
+      #
+      #   @return [String, nil]
+      optional :since, String
+
+      # @!attribute tenant_id
+      #   Narrow to the changes this user made in one tenant context. Only valid together
+      #   with user_id.
+      #
+      #   @return [String, nil]
+      optional :tenant_id, String
+
+      # @!attribute user_id
+      #   Return only this user's changes. Omit it to read every change in the
+      #   environment.
+      #
+      #   @return [String, nil]
+      optional :user_id, String
+
+      # @!method initialize(cursor: nil, limit: nil, since: nil, tenant_id: nil, user_id: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Courier::Models::WorkspacePreferenceListLogsParams} for more details.
+      #
+      #   @param cursor [String] A cursor from a previous response's paging.cursor. Continue only while paging.mo
+      #
+      #   @param limit [Integer] How many entries to return. Defaults to 25.
+      #
+      #   @param since [String] Return only changes at or after this time, as an ISO-8601 date or date-time. A d
+      #
+      #   @param tenant_id [String] Narrow to the changes this user made in one tenant context. Only valid together
+      #
+      #   @param user_id [String] Return only this user's changes. Omit it to read every change in the environment
+      #
+      #   @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/courier/models.rb

@@ -517,6 +517,12 @@ module Courier
 
   Preference = Courier::Models::Preference
 
+  PreferenceChangeLogEntry = Courier::Models::PreferenceChangeLogEntry
+
+  PreferenceChangeLogValue = Courier::Models::PreferenceChangeLogValue
+
+  PreferenceLogsListResponse = Courier::Models::PreferenceLogsListResponse
+
   PreferenceStatus = Courier::Models::PreferenceStatus
 
   ProfileCreateParams = Courier::Models::ProfileCreateParams
@@ -699,6 +705,8 @@ module Courier
 
   WorkspacePreferenceGetResponse = Courier::Models::WorkspacePreferenceGetResponse
 
+  WorkspacePreferenceListLogsParams = Courier::Models::WorkspacePreferenceListLogsParams
+
   WorkspacePreferenceListParams = Courier::Models::WorkspacePreferenceListParams
 
   WorkspacePreferenceListResponse = Courier::Models::WorkspacePreferenceListResponse

data/lib/courier/resources/workspace_preferences.rb

@@ -108,6 +108,43 @@ module Courier
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Courier::Models::WorkspacePreferenceListLogsParams} for more details.
+      #
+      # Returns the history of preference changes in this environment, newest first.
+      # Each entry records one change a user made to one subscription topic, and carries
+      # the value before it where there was one. Supply user_id to read a single user's
+      # history instead of the whole environment.
+      #
+      # @overload list_logs(cursor: nil, limit: nil, since: nil, tenant_id: nil, user_id: nil, request_options: {})
+      #
+      # @param cursor [String] A cursor from a previous response's paging.cursor. Continue only while paging.mo
+      #
+      # @param limit [Integer] How many entries to return. Defaults to 25.
+      #
+      # @param since [String] Return only changes at or after this time, as an ISO-8601 date or date-time. A d
+      #
+      # @param tenant_id [String] Narrow to the changes this user made in one tenant context. Only valid together
+      #
+      # @param user_id [String] Return only this user's changes. Omit it to read every change in the environment
+      #
+      # @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Courier::Models::PreferenceLogsListResponse]
+      #
+      # @see Courier::Models::WorkspacePreferenceListLogsParams
+      def list_logs(params = {})
+        parsed, options = Courier::WorkspacePreferenceListLogsParams.dump_request(params)
+        query = Courier::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "preferences/logs",
+          query: query,
+          model: Courier::PreferenceLogsListResponse,
+          options: options
+        )
+      end
+
       # Some parameter documentations has been truncated, see
       # {Courier::Models::WorkspacePreferencePublishParams} for more details.
       #

data/lib/courier/version.rb

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

data/lib/courier.rb

@@ -345,6 +345,9 @@ require_relative "courier/models/pagerduty_recipient"
 require_relative "courier/models/paging"
 require_relative "courier/models/post_tenant_template_publish_response"
 require_relative "courier/models/preference"
+require_relative "courier/models/preference_change_log_entry"
+require_relative "courier/models/preference_change_log_value"
+require_relative "courier/models/preference_logs_list_response"
 require_relative "courier/models/preference_status"
 require_relative "courier/models/profile_create_params"
 require_relative "courier/models/profile_create_response"
@@ -474,6 +477,7 @@ require_relative "courier/models/widget_background"
 require_relative "courier/models/workspace_preference_archive_params"
 require_relative "courier/models/workspace_preference_create_params"
 require_relative "courier/models/workspace_preference_get_response"
+require_relative "courier/models/workspace_preference_list_logs_params"
 require_relative "courier/models/workspace_preference_list_params"
 require_relative "courier/models/workspace_preference_list_response"
 require_relative "courier/models/workspace_preference_publish_params"

data/rbi/courier/models/preference_change_log_entry.rbi

@@ -0,0 +1,122 @@
+# typed: strong
+
+module Courier
+  module Models
+    class PreferenceChangeLogEntry < Courier::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Courier::PreferenceChangeLogEntry, Courier::Internal::AnyHash)
+        end
+
+      # Unique identifier for this change.
+      sig { returns(String) }
+      attr_accessor :id
+
+      # The channels chosen for this topic, present only when has_custom_routing is
+      # true. Empty otherwise.
+      sig { returns(T::Array[Courier::ChannelClassification::TaggedSymbol]) }
+      attr_accessor :custom_routing
+
+      # Whether specific delivery channels were chosen for this topic rather than the
+      # topic's default routing.
+      sig { returns(T::Boolean) }
+      attr_accessor :has_custom_routing
+
+      # The subscription status the change set.
+      sig { returns(Courier::PreferenceStatus::TaggedSymbol) }
+      attr_accessor :status
+
+      # When the change was made, as an ISO-8601 date-time in UTC.
+      sig { returns(String) }
+      attr_accessor :timestamp
+
+      # The subscription topic the change applies to.
+      sig { returns(String) }
+      attr_accessor :topic_id
+
+      # The display name of that topic when the change was made.
+      sig { returns(String) }
+      attr_accessor :topic_name
+
+      # The user whose preference changed.
+      sig { returns(String) }
+      attr_accessor :user_id
+
+      # The value before this change, where it was recorded.
+      sig { returns(T.nilable(Courier::PreferenceChangeLogValue)) }
+      attr_reader :previous
+
+      sig { params(previous: Courier::PreferenceChangeLogValue::OrHash).void }
+      attr_writer :previous
+
+      # The tenant context the change was made in. Absent when the user set the
+      # preference outside any tenant.
+      sig { returns(T.nilable(String)) }
+      attr_reader :tenant_id
+
+      sig { params(tenant_id: String).void }
+      attr_writer :tenant_id
+
+      sig do
+        params(
+          id: String,
+          custom_routing: T::Array[Courier::ChannelClassification::OrSymbol],
+          has_custom_routing: T::Boolean,
+          status: Courier::PreferenceStatus::OrSymbol,
+          timestamp: String,
+          topic_id: String,
+          topic_name: String,
+          user_id: String,
+          previous: Courier::PreferenceChangeLogValue::OrHash,
+          tenant_id: String
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Unique identifier for this change.
+        id:,
+        # The channels chosen for this topic, present only when has_custom_routing is
+        # true. Empty otherwise.
+        custom_routing:,
+        # Whether specific delivery channels were chosen for this topic rather than the
+        # topic's default routing.
+        has_custom_routing:,
+        # The subscription status the change set.
+        status:,
+        # When the change was made, as an ISO-8601 date-time in UTC.
+        timestamp:,
+        # The subscription topic the change applies to.
+        topic_id:,
+        # The display name of that topic when the change was made.
+        topic_name:,
+        # The user whose preference changed.
+        user_id:,
+        # The value before this change, where it was recorded.
+        previous: nil,
+        # The tenant context the change was made in. Absent when the user set the
+        # preference outside any tenant.
+        tenant_id: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            id: String,
+            custom_routing:
+              T::Array[Courier::ChannelClassification::TaggedSymbol],
+            has_custom_routing: T::Boolean,
+            status: Courier::PreferenceStatus::TaggedSymbol,
+            timestamp: String,
+            topic_id: String,
+            topic_name: String,
+            user_id: String,
+            previous: Courier::PreferenceChangeLogValue,
+            tenant_id: String
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/courier/models/preference_change_log_value.rbi

@@ -0,0 +1,54 @@
+# typed: strong
+
+module Courier
+  module Models
+    class PreferenceChangeLogValue < Courier::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Courier::PreferenceChangeLogValue, Courier::Internal::AnyHash)
+        end
+
+      # The channels chosen before the change.
+      sig { returns(T::Array[Courier::ChannelClassification::TaggedSymbol]) }
+      attr_accessor :custom_routing
+
+      # Whether custom routing was in effect before the change.
+      sig { returns(T::Boolean) }
+      attr_accessor :has_custom_routing
+
+      # The subscription status before the change.
+      sig { returns(Courier::PreferenceStatus::TaggedSymbol) }
+      attr_accessor :status
+
+      sig do
+        params(
+          custom_routing: T::Array[Courier::ChannelClassification::OrSymbol],
+          has_custom_routing: T::Boolean,
+          status: Courier::PreferenceStatus::OrSymbol
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The channels chosen before the change.
+        custom_routing:,
+        # Whether custom routing was in effect before the change.
+        has_custom_routing:,
+        # The subscription status before the change.
+        status:
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            custom_routing:
+              T::Array[Courier::ChannelClassification::TaggedSymbol],
+            has_custom_routing: T::Boolean,
+            status: Courier::PreferenceStatus::TaggedSymbol
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/courier/models/preference_logs_list_response.rbi

@@ -0,0 +1,46 @@
+# typed: strong
+
+module Courier
+  module Models
+    class PreferenceLogsListResponse < Courier::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Courier::PreferenceLogsListResponse, Courier::Internal::AnyHash)
+        end
+
+      # One entry per preference change, newest first.
+      sig { returns(T::Array[Courier::PreferenceChangeLogEntry]) }
+      attr_accessor :items
+
+      sig { returns(Courier::Paging) }
+      attr_reader :paging
+
+      sig { params(paging: Courier::Paging::OrHash).void }
+      attr_writer :paging
+
+      sig do
+        params(
+          items: T::Array[Courier::PreferenceChangeLogEntry::OrHash],
+          paging: Courier::Paging::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # One entry per preference change, newest first.
+        items:,
+        paging:
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            items: T::Array[Courier::PreferenceChangeLogEntry],
+            paging: Courier::Paging
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/courier/models/workspace_preference_list_logs_params.rbi

@@ -0,0 +1,101 @@
+# typed: strong
+
+module Courier
+  module Models
+    class WorkspacePreferenceListLogsParams < Courier::Internal::Type::BaseModel
+      extend Courier::Internal::Type::RequestParameters::Converter
+      include Courier::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(
+            Courier::WorkspacePreferenceListLogsParams,
+            Courier::Internal::AnyHash
+          )
+        end
+
+      # A cursor from a previous response's paging.cursor. Continue only while
+      # paging.more is true; the cursor is omitted on the last page.
+      sig { returns(T.nilable(String)) }
+      attr_reader :cursor
+
+      sig { params(cursor: String).void }
+      attr_writer :cursor
+
+      # How many entries to return. Defaults to 25.
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :limit
+
+      sig { params(limit: Integer).void }
+      attr_writer :limit
+
+      # Return only changes at or after this time, as an ISO-8601 date or date-time. A
+      # date alone is read as the start of that day in UTC.
+      sig { returns(T.nilable(String)) }
+      attr_reader :since
+
+      sig { params(since: String).void }
+      attr_writer :since
+
+      # Narrow to the changes this user made in one tenant context. Only valid together
+      # with user_id.
+      sig { returns(T.nilable(String)) }
+      attr_reader :tenant_id
+
+      sig { params(tenant_id: String).void }
+      attr_writer :tenant_id
+
+      # Return only this user's changes. Omit it to read every change in the
+      # environment.
+      sig { returns(T.nilable(String)) }
+      attr_reader :user_id
+
+      sig { params(user_id: String).void }
+      attr_writer :user_id
+
+      sig do
+        params(
+          cursor: String,
+          limit: Integer,
+          since: String,
+          tenant_id: String,
+          user_id: String,
+          request_options: Courier::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # A cursor from a previous response's paging.cursor. Continue only while
+        # paging.more is true; the cursor is omitted on the last page.
+        cursor: nil,
+        # How many entries to return. Defaults to 25.
+        limit: nil,
+        # Return only changes at or after this time, as an ISO-8601 date or date-time. A
+        # date alone is read as the start of that day in UTC.
+        since: nil,
+        # Narrow to the changes this user made in one tenant context. Only valid together
+        # with user_id.
+        tenant_id: nil,
+        # Return only this user's changes. Omit it to read every change in the
+        # environment.
+        user_id: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            cursor: String,
+            limit: Integer,
+            since: String,
+            tenant_id: String,
+            user_id: String,
+            request_options: Courier::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/courier/models.rbi

@@ -495,6 +495,12 @@ module Courier
 
   Preference = Courier::Models::Preference
 
+  PreferenceChangeLogEntry = Courier::Models::PreferenceChangeLogEntry
+
+  PreferenceChangeLogValue = Courier::Models::PreferenceChangeLogValue
+
+  PreferenceLogsListResponse = Courier::Models::PreferenceLogsListResponse
+
   PreferenceStatus = Courier::Models::PreferenceStatus
 
   ProfileCreateParams = Courier::Models::ProfileCreateParams
@@ -682,6 +688,9 @@ module Courier
   WorkspacePreferenceGetResponse =
     Courier::Models::WorkspacePreferenceGetResponse
 
+  WorkspacePreferenceListLogsParams =
+    Courier::Models::WorkspacePreferenceListLogsParams
+
   WorkspacePreferenceListParams = Courier::Models::WorkspacePreferenceListParams
 
   WorkspacePreferenceListResponse =

data/rbi/courier/resources/workspace_preferences.rbi

@@ -90,6 +90,39 @@ module Courier
       )
       end
 
+      # Returns the history of preference changes in this environment, newest first.
+      # Each entry records one change a user made to one subscription topic, and carries
+      # the value before it where there was one. Supply user_id to read a single user's
+      # history instead of the whole environment.
+      sig do
+        params(
+          cursor: String,
+          limit: Integer,
+          since: String,
+          tenant_id: String,
+          user_id: String,
+          request_options: Courier::RequestOptions::OrHash
+        ).returns(Courier::PreferenceLogsListResponse)
+      end
+      def list_logs(
+        # A cursor from a previous response's paging.cursor. Continue only while
+        # paging.more is true; the cursor is omitted on the last page.
+        cursor: nil,
+        # How many entries to return. Defaults to 25.
+        limit: nil,
+        # Return only changes at or after this time, as an ISO-8601 date or date-time. A
+        # date alone is read as the start of that day in UTC.
+        since: nil,
+        # Narrow to the changes this user made in one tenant context. Only valid together
+        # with user_id.
+        tenant_id: nil,
+        # Return only this user's changes. Omit it to read every change in the
+        # environment.
+        user_id: nil,
+        request_options: {}
+      )
+      end
+
       # Publishes the workspace preference page, snapshotting every preference and
       # topic, and returns the page id and a preview URL.
       sig do

data/sig/courier/models/preference_change_log_entry.rbs

@@ -0,0 +1,71 @@
+module Courier
+  module Models
+    type preference_change_log_entry =
+      {
+        id: String,
+        custom_routing: ::Array[Courier::Models::channel_classification],
+        has_custom_routing: bool,
+        status: Courier::Models::preference_status,
+        timestamp: String,
+        topic_id: String,
+        topic_name: String,
+        user_id: String,
+        previous: Courier::PreferenceChangeLogValue,
+        tenant_id: String
+      }
+
+    class PreferenceChangeLogEntry < Courier::Internal::Type::BaseModel
+      attr_accessor id: String
+
+      attr_accessor custom_routing: ::Array[Courier::Models::channel_classification]
+
+      attr_accessor has_custom_routing: bool
+
+      attr_accessor status: Courier::Models::preference_status
+
+      attr_accessor timestamp: String
+
+      attr_accessor topic_id: String
+
+      attr_accessor topic_name: String
+
+      attr_accessor user_id: String
+
+      attr_reader previous: Courier::PreferenceChangeLogValue?
+
+      def previous=: (
+        Courier::PreferenceChangeLogValue
+      ) -> Courier::PreferenceChangeLogValue
+
+      attr_reader tenant_id: String?
+
+      def tenant_id=: (String) -> String
+
+      def initialize: (
+        id: String,
+        custom_routing: ::Array[Courier::Models::channel_classification],
+        has_custom_routing: bool,
+        status: Courier::Models::preference_status,
+        timestamp: String,
+        topic_id: String,
+        topic_name: String,
+        user_id: String,
+        ?previous: Courier::PreferenceChangeLogValue,
+        ?tenant_id: String
+      ) -> void
+
+      def to_hash: -> {
+        id: String,
+        custom_routing: ::Array[Courier::Models::channel_classification],
+        has_custom_routing: bool,
+        status: Courier::Models::preference_status,
+        timestamp: String,
+        topic_id: String,
+        topic_name: String,
+        user_id: String,
+        previous: Courier::PreferenceChangeLogValue,
+        tenant_id: String
+      }
+    end
+  end
+end

data/sig/courier/models/preference_change_log_value.rbs

@@ -0,0 +1,30 @@
+module Courier
+  module Models
+    type preference_change_log_value =
+      {
+        custom_routing: ::Array[Courier::Models::channel_classification],
+        has_custom_routing: bool,
+        status: Courier::Models::preference_status
+      }
+
+    class PreferenceChangeLogValue < Courier::Internal::Type::BaseModel
+      attr_accessor custom_routing: ::Array[Courier::Models::channel_classification]
+
+      attr_accessor has_custom_routing: bool
+
+      attr_accessor status: Courier::Models::preference_status
+
+      def initialize: (
+        custom_routing: ::Array[Courier::Models::channel_classification],
+        has_custom_routing: bool,
+        status: Courier::Models::preference_status
+      ) -> void
+
+      def to_hash: -> {
+        custom_routing: ::Array[Courier::Models::channel_classification],
+        has_custom_routing: bool,
+        status: Courier::Models::preference_status
+      }
+    end
+  end
+end

data/sig/courier/models/preference_logs_list_response.rbs

@@ -0,0 +1,25 @@
+module Courier
+  module Models
+    type preference_logs_list_response =
+      {
+        items: ::Array[Courier::PreferenceChangeLogEntry],
+        paging: Courier::Paging
+      }
+
+    class PreferenceLogsListResponse < Courier::Internal::Type::BaseModel
+      attr_accessor items: ::Array[Courier::PreferenceChangeLogEntry]
+
+      attr_accessor paging: Courier::Paging
+
+      def initialize: (
+        items: ::Array[Courier::PreferenceChangeLogEntry],
+        paging: Courier::Paging
+      ) -> void
+
+      def to_hash: -> {
+        items: ::Array[Courier::PreferenceChangeLogEntry],
+        paging: Courier::Paging
+      }
+    end
+  end
+end

data/sig/courier/models/workspace_preference_list_logs_params.rbs

@@ -0,0 +1,56 @@
+module Courier
+  module Models
+    type workspace_preference_list_logs_params =
+      {
+        cursor: String,
+        limit: Integer,
+        since: String,
+        tenant_id: String,
+        user_id: String
+      }
+      & Courier::Internal::Type::request_parameters
+
+    class WorkspacePreferenceListLogsParams < Courier::Internal::Type::BaseModel
+      extend Courier::Internal::Type::RequestParameters::Converter
+      include Courier::Internal::Type::RequestParameters
+
+      attr_reader cursor: String?
+
+      def cursor=: (String) -> String
+
+      attr_reader limit: Integer?
+
+      def limit=: (Integer) -> Integer
+
+      attr_reader since: String?
+
+      def since=: (String) -> String
+
+      attr_reader tenant_id: String?
+
+      def tenant_id=: (String) -> String
+
+      attr_reader user_id: String?
+
+      def user_id=: (String) -> String
+
+      def initialize: (
+        ?cursor: String,
+        ?limit: Integer,
+        ?since: String,
+        ?tenant_id: String,
+        ?user_id: String,
+        ?request_options: Courier::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        cursor: String,
+        limit: Integer,
+        since: String,
+        tenant_id: String,
+        user_id: String,
+        request_options: Courier::RequestOptions
+      }
+    end
+  end
+end

data/sig/courier/models.rbs

@@ -473,6 +473,12 @@ module Courier
 
   class Preference = Courier::Models::Preference
 
+  class PreferenceChangeLogEntry = Courier::Models::PreferenceChangeLogEntry
+
+  class PreferenceChangeLogValue = Courier::Models::PreferenceChangeLogValue
+
+  class PreferenceLogsListResponse = Courier::Models::PreferenceLogsListResponse
+
   module PreferenceStatus = Courier::Models::PreferenceStatus
 
   class ProfileCreateParams = Courier::Models::ProfileCreateParams
@@ -655,6 +661,8 @@ module Courier
 
   class WorkspacePreferenceGetResponse = Courier::Models::WorkspacePreferenceGetResponse
 
+  class WorkspacePreferenceListLogsParams = Courier::Models::WorkspacePreferenceListLogsParams
+
   class WorkspacePreferenceListParams = Courier::Models::WorkspacePreferenceListParams
 
   class WorkspacePreferenceListResponse = Courier::Models::WorkspacePreferenceListResponse

data/sig/courier/resources/workspace_preferences.rbs

@@ -27,6 +27,15 @@ module Courier
         ?request_options: Courier::request_opts
       ) -> nil
 
+      def list_logs: (
+        ?cursor: String,
+        ?limit: Integer,
+        ?since: String,
+        ?tenant_id: String,
+        ?user_id: String,
+        ?request_options: Courier::request_opts
+      ) -> Courier::PreferenceLogsListResponse
+
       def publish: (
         ?brand_id: String?,
         ?description: String?,

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: trycourier
 version: !ruby/object:Gem::Version
-  version: 6.9.0
+  version: 6.10.0
 platform: ruby
 authors:
 - Courier
@@ -348,6 +348,9 @@ files:
 - lib/courier/models/post_tenant_template_publish_request.rb
 - lib/courier/models/post_tenant_template_publish_response.rb
 - lib/courier/models/preference.rb
+- lib/courier/models/preference_change_log_entry.rb
+- lib/courier/models/preference_change_log_value.rb
+- lib/courier/models/preference_logs_list_response.rb
 - lib/courier/models/preference_status.rb
 - lib/courier/models/profile_create_params.rb
 - lib/courier/models/profile_create_response.rb
@@ -488,6 +491,7 @@ files:
 - lib/courier/models/workspace_preference_create_params.rb
 - lib/courier/models/workspace_preference_create_request.rb
 - lib/courier/models/workspace_preference_get_response.rb
+- lib/courier/models/workspace_preference_list_logs_params.rb
 - lib/courier/models/workspace_preference_list_params.rb
 - lib/courier/models/workspace_preference_list_response.rb
 - lib/courier/models/workspace_preference_publish_params.rb
@@ -845,6 +849,9 @@ files:
 - rbi/courier/models/post_tenant_template_publish_request.rbi
 - rbi/courier/models/post_tenant_template_publish_response.rbi
 - rbi/courier/models/preference.rbi
+- rbi/courier/models/preference_change_log_entry.rbi
+- rbi/courier/models/preference_change_log_value.rbi
+- rbi/courier/models/preference_logs_list_response.rbi
 - rbi/courier/models/preference_status.rbi
 - rbi/courier/models/profile_create_params.rbi
 - rbi/courier/models/profile_create_response.rbi
@@ -985,6 +992,7 @@ files:
 - rbi/courier/models/workspace_preference_create_params.rbi
 - rbi/courier/models/workspace_preference_create_request.rbi
 - rbi/courier/models/workspace_preference_get_response.rbi
+- rbi/courier/models/workspace_preference_list_logs_params.rbi
 - rbi/courier/models/workspace_preference_list_params.rbi
 - rbi/courier/models/workspace_preference_list_response.rbi
 - rbi/courier/models/workspace_preference_publish_params.rbi
@@ -1341,6 +1349,9 @@ files:
 - sig/courier/models/post_tenant_template_publish_request.rbs
 - sig/courier/models/post_tenant_template_publish_response.rbs
 - sig/courier/models/preference.rbs
+- sig/courier/models/preference_change_log_entry.rbs
+- sig/courier/models/preference_change_log_value.rbs
+- sig/courier/models/preference_logs_list_response.rbs
 - sig/courier/models/preference_status.rbs
 - sig/courier/models/profile_create_params.rbs
 - sig/courier/models/profile_create_response.rbs
@@ -1481,6 +1492,7 @@ files:
 - sig/courier/models/workspace_preference_create_params.rbs
 - sig/courier/models/workspace_preference_create_request.rbs
 - sig/courier/models/workspace_preference_get_response.rbs
+- sig/courier/models/workspace_preference_list_logs_params.rbs
 - sig/courier/models/workspace_preference_list_params.rbs
 - sig/courier/models/workspace_preference_list_response.rbs
 - sig/courier/models/workspace_preference_publish_params.rbs