trycourier 4.17.0 → 4.17.1

data/lib/courier/resources/notifications/checks.rb

@@ -4,7 +4,7 @@ module Courier
   module Resources
     class Notifications
       class Checks
-        # Replace the checks for a notification template submission.
+        # Replace the submission checks for a notification template.
         #
         # @overload update(submission_id, id:, checks:, request_options: {})
         #
@@ -34,7 +34,7 @@ module Courier
           )
         end
 
-        # Retrieve the checks for a notification template submission.
+        # Retrieve the submission checks for a notification template.
         #
         # @overload list(submission_id, id:, request_options: {})
         #
@@ -61,7 +61,7 @@ module Courier
           )
         end
 
-        # Cancel a notification template submission.
+        # Cancel a submission for a notification template.
         #
         # @overload delete(submission_id, id:, request_options: {})
         #

data/lib/courier/resources/{preference_sections → workspace_preferences}/topics.rb

@@ -2,23 +2,24 @@
 
 module Courier
   module Resources
-    class PreferenceSections
+    class WorkspacePreferences
       class Topics
         # Some parameter documentations has been truncated, see
-        # {Courier::Models::PreferenceSections::TopicCreateParams} for more details.
+        # {Courier::Models::WorkspacePreferences::TopicCreateParams} for more details.
         #
-        # Create a subscription preference topic inside a section. Fails with 404 if the
-        # section does not exist. The topic id is generated and returned.
+        # Create a subscription preference topic inside a workspace preference. Fails with
+        # 404 if the workspace preference does not exist. The topic id is generated and
+        # returned.
         #
         # @overload create(section_id, default_status:, name:, allowed_preferences: nil, include_unsubscribe_header: nil, routing_options: nil, topic_data: nil, request_options: {})
         #
-        # @param section_id [String] Id of the preference section to create the topic in.
+        # @param section_id [String] Id of the workspace preference to create the topic in.
         #
-        # @param default_status [Symbol, Courier::Models::PreferenceTopicCreateRequest::DefaultStatus] The default subscription status applied when a recipient has not set their own.
+        # @param default_status [Symbol, Courier::Models::WorkspacePreferenceTopicCreateRequest::DefaultStatus] The default subscription status applied when a recipient has not set their own.
         #
         # @param name [String] Human-readable name for the preference topic.
         #
-        # @param allowed_preferences [Array<Symbol, Courier::Models::PreferenceTopicCreateRequest::AllowedPreference>, nil] Preference controls a recipient may customize for this topic. Defaults to empty
+        # @param allowed_preferences [Array<Symbol, Courier::Models::WorkspacePreferenceTopicCreateRequest::AllowedPreference>, nil] Preference controls a recipient may customize for this topic. Defaults to empty
         #
         # @param include_unsubscribe_header [Boolean, nil] Whether to include a list-unsubscribe header on emails for this topic.
         #
@@ -28,36 +29,37 @@ module Courier
         #
         # @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}, nil]
         #
-        # @return [Courier::Models::PreferenceTopicGetResponse]
+        # @return [Courier::Models::WorkspacePreferenceTopicGetResponse]
         #
-        # @see Courier::Models::PreferenceSections::TopicCreateParams
+        # @see Courier::Models::WorkspacePreferences::TopicCreateParams
         def create(section_id, params)
-          parsed, options = Courier::PreferenceSections::TopicCreateParams.dump_request(params)
+          parsed, options = Courier::WorkspacePreferences::TopicCreateParams.dump_request(params)
           @client.request(
             method: :post,
             path: ["preferences/sections/%1$s/topics", section_id],
             body: parsed,
-            model: Courier::PreferenceTopicGetResponse,
+            model: Courier::WorkspacePreferenceTopicGetResponse,
             options: options
           )
         end
 
-        # Retrieve a topic within a section. Returns 404 if the section does not exist,
-        # the topic does not exist, or the topic belongs to a different section.
+        # Retrieve a topic within a workspace preference. Returns 404 if the workspace
+        # preference does not exist, the topic does not exist, or the topic belongs to a
+        # different workspace preference.
         #
         # @overload retrieve(topic_id, section_id:, request_options: {})
         #
         # @param topic_id [String] Id of the subscription preference topic.
         #
-        # @param section_id [String] Id of the preference section.
+        # @param section_id [String] Id of the workspace preference.
         #
         # @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}, nil]
         #
-        # @return [Courier::Models::PreferenceTopicGetResponse]
+        # @return [Courier::Models::WorkspacePreferenceTopicGetResponse]
         #
-        # @see Courier::Models::PreferenceSections::TopicRetrieveParams
+        # @see Courier::Models::WorkspacePreferences::TopicRetrieveParams
         def retrieve(topic_id, params)
-          parsed, options = Courier::PreferenceSections::TopicRetrieveParams.dump_request(params)
+          parsed, options = Courier::WorkspacePreferences::TopicRetrieveParams.dump_request(params)
           section_id =
             parsed.delete(:section_id) do
               raise ArgumentError.new("missing required path argument #{_1}")
@@ -65,46 +67,47 @@ module Courier
           @client.request(
             method: :get,
             path: ["preferences/sections/%1$s/topics/%2$s", section_id, topic_id],
-            model: Courier::PreferenceTopicGetResponse,
+            model: Courier::WorkspacePreferenceTopicGetResponse,
             options: options
           )
         end
 
-        # List the topics in a preference section.
+        # List the topics in a workspace preference.
         #
         # @overload list(section_id, request_options: {})
         #
-        # @param section_id [String] Id of the preference section.
+        # @param section_id [String] Id of the workspace preference.
         #
         # @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}, nil]
         #
-        # @return [Courier::Models::PreferenceTopicListResponse]
+        # @return [Courier::Models::WorkspacePreferenceTopicListResponse]
         #
-        # @see Courier::Models::PreferenceSections::TopicListParams
+        # @see Courier::Models::WorkspacePreferences::TopicListParams
         def list(section_id, params = {})
           @client.request(
             method: :get,
             path: ["preferences/sections/%1$s/topics", section_id],
-            model: Courier::PreferenceTopicListResponse,
+            model: Courier::WorkspacePreferenceTopicListResponse,
             options: params[:request_options]
           )
         end
 
-        # Archive a topic and remove it from its section. Same 404 rules as GET.
+        # Archive a topic and remove it from its workspace preference. Same 404 rules as
+        # GET.
         #
         # @overload archive(topic_id, section_id:, request_options: {})
         #
         # @param topic_id [String] Id of the subscription preference topic.
         #
-        # @param section_id [String] Id of the preference section.
+        # @param section_id [String] Id of the workspace preference.
         #
         # @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [nil]
         #
-        # @see Courier::Models::PreferenceSections::TopicArchiveParams
+        # @see Courier::Models::WorkspacePreferences::TopicArchiveParams
         def archive(topic_id, params)
-          parsed, options = Courier::PreferenceSections::TopicArchiveParams.dump_request(params)
+          parsed, options = Courier::WorkspacePreferences::TopicArchiveParams.dump_request(params)
           section_id =
             parsed.delete(:section_id) do
               raise ArgumentError.new("missing required path argument #{_1}")
@@ -118,22 +121,22 @@ module Courier
         end
 
         # Some parameter documentations has been truncated, see
-        # {Courier::Models::PreferenceSections::TopicReplaceParams} for more details.
+        # {Courier::Models::WorkspacePreferences::TopicReplaceParams} for more details.
         #
-        # Replace a topic within a section. Full document replacement; missing optional
-        # fields are cleared. Same 404 rules as GET.
+        # Replace a topic within a workspace preference. Full document replacement;
+        # missing optional fields are cleared. Same 404 rules as GET.
         #
         # @overload replace(topic_id, section_id:, default_status:, name:, allowed_preferences: nil, include_unsubscribe_header: nil, routing_options: nil, topic_data: nil, request_options: {})
         #
         # @param topic_id [String] Path param: Id of the subscription preference topic.
         #
-        # @param section_id [String] Path param: Id of the preference section.
+        # @param section_id [String] Path param: Id of the workspace preference.
         #
-        # @param default_status [Symbol, Courier::Models::PreferenceTopicReplaceRequest::DefaultStatus] Body param: The default subscription status applied when a recipient has not set
+        # @param default_status [Symbol, Courier::Models::WorkspacePreferenceTopicReplaceRequest::DefaultStatus] Body param: The default subscription status applied when a recipient has not set
         #
         # @param name [String] Body param: Human-readable name for the preference topic.
         #
-        # @param allowed_preferences [Array<Symbol, Courier::Models::PreferenceTopicReplaceRequest::AllowedPreference>, nil] Body param: Preference controls a recipient may customize. Omit to clear.
+        # @param allowed_preferences [Array<Symbol, Courier::Models::WorkspacePreferenceTopicReplaceRequest::AllowedPreference>, nil] Body param: Preference controls a recipient may customize. Omit to clear.
         #
         # @param include_unsubscribe_header [Boolean, nil] Body param: Whether to include a list-unsubscribe header on emails for this topi
         #
@@ -143,11 +146,11 @@ module Courier
         #
         # @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}, nil]
         #
-        # @return [Courier::Models::PreferenceTopicGetResponse]
+        # @return [Courier::Models::WorkspacePreferenceTopicGetResponse]
         #
-        # @see Courier::Models::PreferenceSections::TopicReplaceParams
+        # @see Courier::Models::WorkspacePreferences::TopicReplaceParams
         def replace(topic_id, params)
-          parsed, options = Courier::PreferenceSections::TopicReplaceParams.dump_request(params)
+          parsed, options = Courier::WorkspacePreferences::TopicReplaceParams.dump_request(params)
           section_id =
             parsed.delete(:section_id) do
               raise ArgumentError.new("missing required path argument #{_1}")
@@ -156,7 +159,7 @@ module Courier
             method: :put,
             path: ["preferences/sections/%1$s/topics/%2$s", section_id, topic_id],
             body: parsed,
-            model: Courier::PreferenceTopicGetResponse,
+            model: Courier::WorkspacePreferenceTopicGetResponse,
             options: options
           )
         end

data/lib/courier/resources/{preference_sections.rb → workspace_preferences.rb}

@@ -2,89 +2,89 @@
 
 module Courier
   module Resources
-    class PreferenceSections
-      # @return [Courier::Resources::PreferenceSections::Topics]
+    class WorkspacePreferences
+      # @return [Courier::Resources::WorkspacePreferences::Topics]
       attr_reader :topics
 
-      # Create a preference section in your workspace. The section id is generated and
-      # returned. Topics are created inside a section via POST
+      # Create a workspace preference. The workspace preference id is generated and
+      # returned. Topics are created inside a workspace preference via POST
       # /preferences/sections/{section_id}/topics.
       #
       # @overload create(name:, has_custom_routing: nil, routing_options: nil, request_options: {})
       #
-      # @param name [String] Human-readable name for the section.
+      # @param name [String] Human-readable name for the workspace preference.
       #
-      # @param has_custom_routing [Boolean, nil] Whether the section defines custom routing for its topics.
+      # @param has_custom_routing [Boolean, nil] Whether the workspace preference defines custom routing for its topics.
       #
-      # @param routing_options [Array<Symbol, Courier::Models::ChannelClassification>, nil] Default channels for the section. Defaults to empty if omitted.
+      # @param routing_options [Array<Symbol, Courier::Models::ChannelClassification>, nil] Default channels for the workspace preference. Defaults to empty if omitted.
       #
       # @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Courier::Models::PreferenceSectionGetResponse]
+      # @return [Courier::Models::WorkspacePreferenceGetResponse]
       #
-      # @see Courier::Models::PreferenceSectionCreateParams
+      # @see Courier::Models::WorkspacePreferenceCreateParams
       def create(params)
-        parsed, options = Courier::PreferenceSectionCreateParams.dump_request(params)
+        parsed, options = Courier::WorkspacePreferenceCreateParams.dump_request(params)
         @client.request(
           method: :post,
           path: "preferences/sections",
           body: parsed,
-          model: Courier::PreferenceSectionGetResponse,
+          model: Courier::WorkspacePreferenceGetResponse,
           options: options
         )
       end
 
-      # Retrieve a preference section by id, including its topics.
+      # Retrieve a workspace preference by id, including its topics.
       #
       # @overload retrieve(section_id, request_options: {})
       #
-      # @param section_id [String] Id of the preference section.
+      # @param section_id [String] Id of the workspace preference.
       #
       # @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Courier::Models::PreferenceSectionGetResponse]
+      # @return [Courier::Models::WorkspacePreferenceGetResponse]
       #
-      # @see Courier::Models::PreferenceSectionRetrieveParams
+      # @see Courier::Models::WorkspacePreferenceRetrieveParams
       def retrieve(section_id, params = {})
         @client.request(
           method: :get,
           path: ["preferences/sections/%1$s", section_id],
-          model: Courier::PreferenceSectionGetResponse,
+          model: Courier::WorkspacePreferenceGetResponse,
           options: params[:request_options]
         )
       end
 
-      # List the workspace's preference sections. Each section embeds its topics. Scoped
-      # to the workspace of the API key.
+      # List the workspace's preferences. Each workspace preference embeds its topics.
+      # Scoped to the workspace of the API key.
       #
       # @overload list(request_options: {})
       #
       # @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Courier::Models::PreferenceSectionListResponse]
+      # @return [Courier::Models::WorkspacePreferenceListResponse]
       #
-      # @see Courier::Models::PreferenceSectionListParams
+      # @see Courier::Models::WorkspacePreferenceListParams
       def list(params = {})
         @client.request(
           method: :get,
           path: "preferences/sections",
-          model: Courier::PreferenceSectionListResponse,
+          model: Courier::WorkspacePreferenceListResponse,
           options: params[:request_options]
         )
       end
 
-      # Archive a preference section. The section must be empty: delete its topics
-      # first, otherwise the request fails with 409.
+      # Archive a workspace preference. The workspace preference must be empty: delete
+      # its topics first, otherwise the request fails with 409.
       #
       # @overload archive(section_id, request_options: {})
       #
-      # @param section_id [String] Id of the preference section.
+      # @param section_id [String] Id of the workspace preference.
       #
       # @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [nil]
       #
-      # @see Courier::Models::PreferenceSectionArchiveParams
+      # @see Courier::Models::WorkspacePreferenceArchiveParams
       def archive(section_id, params = {})
         @client.request(
           method: :delete,
@@ -94,9 +94,9 @@ module Courier
         )
       end
 
-      # Publish the workspace's preferences page. Takes a snapshot of every section with
-      # its topics under a new published version, making the current state visible on
-      # the hosted preferences page (non-draft).
+      # Publish the workspace's preferences page. Takes a snapshot of every workspace
+      # preference with its topics under a new published version, making the current
+      # state visible on the hosted preferences page (non-draft).
       #
       # @overload publish(request_options: {})
       #
@@ -104,7 +104,7 @@ module Courier
       #
       # @return [Courier::Models::PublishPreferencesResponse]
       #
-      # @see Courier::Models::PreferenceSectionPublishParams
+      # @see Courier::Models::WorkspacePreferencePublishParams
       def publish(params = {})
         @client.request(
           method: :post,
@@ -114,31 +114,31 @@ module Courier
         )
       end
 
-      # Replace a preference section. Full document replacement; missing optional fields
-      # are cleared. Topics attached to the section are unaffected.
+      # Replace a workspace preference. Full document replacement; missing optional
+      # fields are cleared. Topics attached to the workspace preference are unaffected.
       #
       # @overload replace(section_id, name:, has_custom_routing: nil, routing_options: nil, request_options: {})
       #
-      # @param section_id [String] Id of the preference section.
+      # @param section_id [String] Id of the workspace preference.
       #
-      # @param name [String] Human-readable name for the section.
+      # @param name [String] Human-readable name for the workspace preference.
       #
-      # @param has_custom_routing [Boolean, nil] Whether the section defines custom routing for its topics.
+      # @param has_custom_routing [Boolean, nil] Whether the workspace preference defines custom routing for its topics.
       #
-      # @param routing_options [Array<Symbol, Courier::Models::ChannelClassification>, nil] Default channels for the section. Omit to clear.
+      # @param routing_options [Array<Symbol, Courier::Models::ChannelClassification>, nil] Default channels for the workspace preference. Omit to clear.
       #
       # @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Courier::Models::PreferenceSectionGetResponse]
+      # @return [Courier::Models::WorkspacePreferenceGetResponse]
       #
-      # @see Courier::Models::PreferenceSectionReplaceParams
+      # @see Courier::Models::WorkspacePreferenceReplaceParams
       def replace(section_id, params)
-        parsed, options = Courier::PreferenceSectionReplaceParams.dump_request(params)
+        parsed, options = Courier::WorkspacePreferenceReplaceParams.dump_request(params)
         @client.request(
           method: :put,
           path: ["preferences/sections/%1$s", section_id],
           body: parsed,
-          model: Courier::PreferenceSectionGetResponse,
+          model: Courier::WorkspacePreferenceGetResponse,
           options: options
         )
       end
@@ -148,7 +148,7 @@ module Courier
       # @param client [Courier::Client]
       def initialize(client:)
         @client = client
-        @topics = Courier::Resources::PreferenceSections::Topics.new(client: client)
+        @topics = Courier::Resources::WorkspacePreferences::Topics.new(client: client)
       end
     end
   end

data/lib/courier/version.rb

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

data/lib/courier.rb

@@ -72,16 +72,16 @@ require_relative "courier/models/notification_template_publish_request"
 require_relative "courier/models/notification_element_put_request"
 require_relative "courier/models/notification_template_update_request"
 require_relative "courier/models/notification_template_payload"
-require_relative "courier/models/preference_section_create_request"
-require_relative "courier/models/preference_section_replace_request"
-require_relative "courier/models/preference_topic_create_request"
-require_relative "courier/models/preference_topic_replace_request"
 require_relative "courier/models/routing_strategy_create_request"
 require_relative "courier/models/routing_strategy_replace_request"
 require_relative "courier/models/base_template_tenant_association"
 require_relative "courier/models/post_tenant_template_publish_request"
 require_relative "courier/models/put_tenant_template_request"
 require_relative "courier/models/users/user_token"
+require_relative "courier/models/workspace_preference_create_request"
+require_relative "courier/models/workspace_preference_replace_request"
+require_relative "courier/models/workspace_preference_topic_create_request"
+require_relative "courier/models/workspace_preference_topic_replace_request"
 require_relative "courier/models/airship_profile"
 require_relative "courier/models/airship_profile_audience"
 require_relative "courier/models/alignment"
@@ -279,22 +279,7 @@ 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_section_archive_params"
-require_relative "courier/models/preference_section_create_params"
-require_relative "courier/models/preference_section_get_response"
-require_relative "courier/models/preference_section_list_params"
-require_relative "courier/models/preference_section_list_response"
-require_relative "courier/models/preference_section_publish_params"
-require_relative "courier/models/preference_section_replace_params"
-require_relative "courier/models/preference_section_retrieve_params"
-require_relative "courier/models/preference_sections/topic_archive_params"
-require_relative "courier/models/preference_sections/topic_create_params"
-require_relative "courier/models/preference_sections/topic_list_params"
-require_relative "courier/models/preference_sections/topic_replace_params"
-require_relative "courier/models/preference_sections/topic_retrieve_params"
 require_relative "courier/models/preference_status"
-require_relative "courier/models/preference_topic_get_response"
-require_relative "courier/models/preference_topic_list_response"
 require_relative "courier/models/profile_create_params"
 require_relative "courier/models/profile_create_response"
 require_relative "courier/models/profile_delete_params"
@@ -410,6 +395,21 @@ require_relative "courier/models/webhook_profile"
 require_relative "courier/models/webhook_profile_type"
 require_relative "courier/models/webhook_recipient"
 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_params"
+require_relative "courier/models/workspace_preference_list_response"
+require_relative "courier/models/workspace_preference_publish_params"
+require_relative "courier/models/workspace_preference_replace_params"
+require_relative "courier/models/workspace_preference_retrieve_params"
+require_relative "courier/models/workspace_preferences/topic_archive_params"
+require_relative "courier/models/workspace_preferences/topic_create_params"
+require_relative "courier/models/workspace_preferences/topic_list_params"
+require_relative "courier/models/workspace_preferences/topic_replace_params"
+require_relative "courier/models/workspace_preferences/topic_retrieve_params"
+require_relative "courier/models/workspace_preference_topic_get_response"
+require_relative "courier/models/workspace_preference_topic_list_response"
 require_relative "courier/models"
 require_relative "courier/resources/audiences"
 require_relative "courier/resources/audit_events"
@@ -428,8 +428,6 @@ require_relative "courier/resources/lists/subscriptions"
 require_relative "courier/resources/messages"
 require_relative "courier/resources/notifications"
 require_relative "courier/resources/notifications/checks"
-require_relative "courier/resources/preference_sections"
-require_relative "courier/resources/preference_sections/topics"
 require_relative "courier/resources/profiles"
 require_relative "courier/resources/profiles/lists"
 require_relative "courier/resources/providers"
@@ -447,3 +445,5 @@ require_relative "courier/resources/users"
 require_relative "courier/resources/users/preferences"
 require_relative "courier/resources/users/tenants"
 require_relative "courier/resources/users/tokens"
+require_relative "courier/resources/workspace_preferences"
+require_relative "courier/resources/workspace_preferences/topics"

data/rbi/courier/client.rbi

@@ -61,8 +61,8 @@ module Courier
     sig { returns(Courier::Resources::RoutingStrategies) }
     attr_reader :routing_strategies
 
-    sig { returns(Courier::Resources::PreferenceSections) }
-    attr_reader :preference_sections
+    sig { returns(Courier::Resources::WorkspacePreferences) }
+    attr_reader :workspace_preferences
 
     sig { returns(Courier::Resources::Profiles) }
     attr_reader :profiles

data/rbi/courier/models/{preference_section_retrieve_params.rbi → workspace_preference_archive_params.rbi}

@@ -2,14 +2,14 @@
 
 module Courier
   module Models
-    class PreferenceSectionRetrieveParams < Courier::Internal::Type::BaseModel
+    class WorkspacePreferenceArchiveParams < Courier::Internal::Type::BaseModel
       extend Courier::Internal::Type::RequestParameters::Converter
       include Courier::Internal::Type::RequestParameters
 
       OrHash =
         T.type_alias do
           T.any(
-            Courier::PreferenceSectionRetrieveParams,
+            Courier::WorkspacePreferenceArchiveParams,
             Courier::Internal::AnyHash
           )
         end

data/rbi/courier/models/{preference_section_create_params.rbi → workspace_preference_create_params.rbi}

@@ -2,14 +2,14 @@
 
 module Courier
   module Models
-    class PreferenceSectionCreateParams < Courier::Models::PreferenceSectionCreateRequest
+    class WorkspacePreferenceCreateParams < Courier::Models::WorkspacePreferenceCreateRequest
       extend Courier::Internal::Type::RequestParameters::Converter
       include Courier::Internal::Type::RequestParameters
 
       OrHash =
         T.type_alias do
           T.any(
-            Courier::PreferenceSectionCreateParams,
+            Courier::WorkspacePreferenceCreateParams,
             Courier::Internal::AnyHash
           )
         end

data/rbi/courier/models/{preference_section_create_request.rbi → workspace_preference_create_request.rbi}

@@ -2,30 +2,30 @@
 
 module Courier
   module Models
-    class PreferenceSectionCreateRequest < Courier::Internal::Type::BaseModel
+    class WorkspacePreferenceCreateRequest < Courier::Internal::Type::BaseModel
       OrHash =
         T.type_alias do
           T.any(
-            Courier::PreferenceSectionCreateRequest,
+            Courier::WorkspacePreferenceCreateRequest,
             Courier::Internal::AnyHash
           )
         end
 
-      # Human-readable name for the section.
+      # Human-readable name for the workspace preference.
       sig { returns(String) }
       attr_accessor :name
 
-      # Whether the section defines custom routing for its topics.
+      # Whether the workspace preference defines custom routing for its topics.
       sig { returns(T.nilable(T::Boolean)) }
       attr_accessor :has_custom_routing
 
-      # Default channels for the section. Defaults to empty if omitted.
+      # Default channels for the workspace preference. Defaults to empty if omitted.
       sig do
         returns(T.nilable(T::Array[Courier::ChannelClassification::OrSymbol]))
       end
       attr_accessor :routing_options
 
-      # Request body for creating a preference section.
+      # Request body for creating a workspace preference.
       sig do
         params(
           name: String,
@@ -35,11 +35,11 @@ module Courier
         ).returns(T.attached_class)
       end
       def self.new(
-        # Human-readable name for the section.
+        # Human-readable name for the workspace preference.
         name:,
-        # Whether the section defines custom routing for its topics.
+        # Whether the workspace preference defines custom routing for its topics.
         has_custom_routing: nil,
-        # Default channels for the section. Defaults to empty if omitted.
+        # Default channels for the workspace preference. Defaults to empty if omitted.
         routing_options: nil
       )
       end