trycourier 4.20.0 → 4.22.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6a432e5519e4d84dc11a93b4a0f4801f76ce5a0f3ef2f898304335a29c2dab09
-  data.tar.gz: 1267ecc520dd85dc4953f658a9a251dad688d8eb3668e1cd666f8f8829c1b1c0
+  metadata.gz: 0af9de60ad16c83c8fd9376ca8b10f3647d7673932ad891b5570534a7b061b47
+  data.tar.gz: e978830eee9f6617bcc0871ad4741b1f33af873bfa5be4f9dcb1313aae343d52
 SHA512:
-  metadata.gz: a43868c8bb50e8dc543ecb1c9224e85149294f7f88bae99c7e5e4e3625189e2c8b60186ff221c7f76b000cadf10b6a03ea80c1bea123ed07598ba4e7fa9019ba
-  data.tar.gz: c65e517247b08d26f7e21a7725ce12eb212654e1627635d5ad1523bc99656dd8864ba7f2debc75a65b6e405317b9c2b845d995c111e509a8a12cd9faefc386f3
+  metadata.gz: a00a9043cbbf7ed380707868a3949fcb99ad614224411458167a8bc5d818efe799a5938eeee91f019d88f6e37e794761262f4e7d608792961b76719348c99ee5
+  data.tar.gz: '08205fc11ce3a0f9bbf3ad3fa20b17f5f8640504ce79973848d162e8be66f7b684c1f8a3d63322c79c2a6952eaccaa9b49581a659a68892bf7af5fb2cf69e961'

data/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## 4.22.0 (2026-07-29)
+
+Full Changelog: [v4.21.0...v4.22.0](https://github.com/trycourier/courier-ruby/compare/v4.21.0...v4.22.0)
+
+### Features
+
+* Document DELETE/PUT restore for inbox messages (C-19268) ([#175](https://github.com/trycourier/courier-ruby/issues/175)) ([36c1d01](https://github.com/trycourier/courier-ruby/commit/36c1d0116770621edfefe94781e72a8061e43781))
+* spec: rename and reorder the API reference sections ([#179](https://github.com/trycourier/courier-ruby/issues/179)) ([997010e](https://github.com/trycourier/courier-ruby/commit/997010e32d3e0aed0ac138c67a8383ba1f99d416))
+
+
+### Documentation
+
+* **openapi:** describe user topic-preference fields explicitly ([#172](https://github.com/trycourier/courier-ruby/issues/172)) ([c540bdb](https://github.com/trycourier/courier-ruby/commit/c540bdb855f180d850feeabf1a30ed4394092b50))
+* **openapi:** document Idempotency-Key header on idempotent POST endpoints ([#176](https://github.com/trycourier/courier-ruby/issues/176)) ([b76b6bb](https://github.com/trycourier/courier-ruby/commit/b76b6bbbd0e856d486037d7d140b2d934eb150ea))
+* **openapi:** rewrite operation descriptions for agents and SEO ([#174](https://github.com/trycourier/courier-ruby/issues/174)) ([8a8c25b](https://github.com/trycourier/courier-ruby/commit/8a8c25b54b9a8db2cd906ab09ac8729423fa35b8))
+
+## 4.21.0 (2026-07-23)
+
+Full Changelog: [v4.20.0...v4.21.0](https://github.com/trycourier/courier-ruby/compare/v4.20.0...v4.21.0)
+
+### Features
+
+* Remove /bulk endpoints from api-spec (C-19507) ([#171](https://github.com/trycourier/courier-ruby/issues/171)) ([e10d767](https://github.com/trycourier/courier-ruby/commit/e10d767174c28e0ae756041d7d2f1f78f2c72241))
+
 ## 4.20.0 (2026-07-20)
 
 Full Changelog: [v4.19.2...v4.20.0](https://github.com/trycourier/courier-ruby/compare/v4.19.2...v4.20.0)

data/lib/courier/client.rb

@@ -18,63 +18,98 @@ module Courier
     # @return [String]
     attr_reader :api_key
 
+    # Send a message to one or more recipients — users, lists, audiences, or tenants —
+    # across every channel you have configured.
     # @return [Courier::Resources::Send]
     attr_reader :send_
 
+    # Define filter-based groups whose membership Courier recalculates as user
+    # profiles change.
     # @return [Courier::Resources::Audiences]
     attr_reader :audiences
 
+    # Configure the channel providers Courier delivers through, and browse the
+    # provider types it supports.
     # @return [Courier::Resources::Providers]
     attr_reader :providers
 
+    # Read the audit trail of configuration and access changes in your workspace.
     # @return [Courier::Resources::AuditEvents]
     attr_reader :audit_events
 
+    # Issue scoped, short-lived JWTs so client-side SDKs — Inbox, Preferences, and the
+    # embedded designer — can call Courier as a single user. Server-side requests
+    # authenticate with your workspace API key instead.
     # @return [Courier::Resources::Auth]
     attr_reader :auth
 
+    # Invoke a stored automation template or an ad hoc automation defined in the
+    # request.
     # @return [Courier::Resources::Automations]
     attr_reader :automations
 
+    # Build, version, publish, invoke, and cancel multi-step notification workflows,
+    # along with the templates scoped to them.
     # @return [Courier::Resources::Journeys]
     attr_reader :journeys
 
+    # Manage the logos, colors, and layout that give the templates you send a
+    # consistent look.
     # @return [Courier::Resources::Brands]
     attr_reader :brands
 
-    # @return [Courier::Resources::Bulk]
-    attr_reader :bulk
-
     # @return [Courier::Resources::Digests]
     attr_reader :digests
 
+    # Record an inbound event that triggers the journeys and automations mapped to it.
     # @return [Courier::Resources::Inbound]
     attr_reader :inbound
 
+    # Manage static groups of users that you subscribe explicitly, and send to them by
+    # list id or list pattern.
     # @return [Courier::Resources::Lists]
     attr_reader :lists
 
+    # @return [Courier::Resources::Inbox]
+    attr_reader :inbox
+
+    # Look up the messages Courier has accepted, inspect their delivery history and
+    # rendered output, and cancel, resend, or archive them.
     # @return [Courier::Resources::Messages]
     attr_reader :messages
 
+    # Look up the messages Courier has accepted, inspect their delivery history and
+    # rendered output, and cancel, resend, or archive them.
     # @return [Courier::Resources::Requests]
     attr_reader :requests
 
+    # Create, update, version, publish, and localize notification templates and their
+    # content.
     # @return [Courier::Resources::Notifications]
     attr_reader :notifications
 
+    # Define reusable channel routing and failover strategies, and see which templates
+    # use them.
     # @return [Courier::Resources::RoutingStrategies]
     attr_reader :routing_strategies
 
+    # Manage the workspace catalog of subscription topics, the sections that group
+    # them, and publishing the preference page.
     # @return [Courier::Resources::WorkspacePreferences]
     attr_reader :workspace_preferences
 
+    # Store the contact information Courier delivers to for each user — email, phone
+    # number, push tokens, and any custom data you send to.
     # @return [Courier::Resources::Profiles]
     attr_reader :profiles
 
+    # Manage tenants — the organizations, teams, or accounts your users belong to —
+    # along with their users and default preferences.
     # @return [Courier::Resources::Tenants]
     attr_reader :tenants
 
+    # Store and retrieve the translation strings Courier uses to render localized
+    # template content.
     # @return [Courier::Resources::Translations]
     attr_reader :translations
 
@@ -150,10 +185,10 @@ module Courier
       @automations = Courier::Resources::Automations.new(client: self)
       @journeys = Courier::Resources::Journeys.new(client: self)
       @brands = Courier::Resources::Brands.new(client: self)
-      @bulk = Courier::Resources::Bulk.new(client: self)
       @digests = Courier::Resources::Digests.new(client: self)
       @inbound = Courier::Resources::Inbound.new(client: self)
       @lists = Courier::Resources::Lists.new(client: self)
+      @inbox = Courier::Resources::Inbox.new(client: self)
       @messages = Courier::Resources::Messages.new(client: self)
       @requests = Courier::Resources::Requests.new(client: self)
       @notifications = Courier::Resources::Notifications.new(client: self)

data/lib/courier/models/automations/invoke_invoke_ad_hoc_params.rb

@@ -38,13 +38,25 @@ module Courier
         #   @return [String, nil]
         optional :template, String, nil?: true
 
-        # @!method initialize(automation:, brand: nil, data: nil, profile: nil, recipient: nil, template: nil, request_options: {})
+        # @!attribute idempotency_key
+        #
+        #   @return [String, nil]
+        optional :idempotency_key, String
+
+        # @!attribute x_idempotency_expiration
+        #
+        #   @return [String, nil]
+        optional :x_idempotency_expiration, String
+
+        # @!method initialize(automation:, brand: nil, data: nil, profile: nil, recipient: nil, template: nil, idempotency_key: nil, x_idempotency_expiration: nil, request_options: {})
         #   @param automation [Courier::Models::Automations::InvokeInvokeAdHocParams::Automation]
         #   @param brand [String, nil]
         #   @param data [Hash{Symbol=>Object}, nil]
         #   @param profile [Hash{Symbol=>Object}, nil]
         #   @param recipient [String, nil]
         #   @param template [String, nil]
+        #   @param idempotency_key [String]
+        #   @param x_idempotency_expiration [String]
         #   @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
 
         class Automation < Courier::Internal::Type::BaseModel

data/lib/courier/models/automations/invoke_invoke_by_template_params.rb

@@ -38,13 +38,25 @@ module Courier
         #   @return [String, nil]
         optional :template, String, nil?: true
 
-        # @!method initialize(template_id:, recipient:, brand: nil, data: nil, profile: nil, template: nil, request_options: {})
+        # @!attribute idempotency_key
+        #
+        #   @return [String, nil]
+        optional :idempotency_key, String
+
+        # @!attribute x_idempotency_expiration
+        #
+        #   @return [String, nil]
+        optional :x_idempotency_expiration, String
+
+        # @!method initialize(template_id:, recipient:, brand: nil, data: nil, profile: nil, template: nil, idempotency_key: nil, x_idempotency_expiration: nil, request_options: {})
         #   @param template_id [String]
         #   @param recipient [String, nil]
         #   @param brand [String, nil]
         #   @param data [Hash{Symbol=>Object}, nil]
         #   @param profile [Hash{Symbol=>Object}, nil]
         #   @param template [String, nil]
+        #   @param idempotency_key [String]
+        #   @param x_idempotency_expiration [String]
         #   @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
       end
     end

data/lib/courier/models/brand_create_params.rb

@@ -27,11 +27,23 @@ module Courier
       #   @return [Courier::Models::BrandSnippets, nil]
       optional :snippets, -> { Courier::BrandSnippets }, nil?: true
 
-      # @!method initialize(name:, settings:, id: nil, snippets: nil, request_options: {})
+      # @!attribute idempotency_key
+      #
+      #   @return [String, nil]
+      optional :idempotency_key, String
+
+      # @!attribute x_idempotency_expiration
+      #
+      #   @return [String, nil]
+      optional :x_idempotency_expiration, String
+
+      # @!method initialize(name:, settings:, id: nil, snippets: nil, idempotency_key: nil, x_idempotency_expiration: nil, request_options: {})
       #   @param name [String]
       #   @param settings [Courier::Models::BrandSettings]
       #   @param id [String, nil]
       #   @param snippets [Courier::Models::BrandSnippets, nil]
+      #   @param idempotency_key [String]
+      #   @param x_idempotency_expiration [String]
       #   @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/courier/models/inbox/message_delete_params.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    module Inbox
+      # @see Courier::Resources::Inbox::Messages#delete
+      class MessageDeleteParams < Courier::Internal::Type::BaseModel
+        extend Courier::Internal::Type::RequestParameters::Converter
+        include Courier::Internal::Type::RequestParameters
+
+        # @!attribute message_id
+        #
+        #   @return [String]
+        required :message_id, String
+
+        # @!method initialize(message_id:, request_options: {})
+        #   @param message_id [String]
+        #   @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/courier/models/inbox/message_restore_params.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    module Inbox
+      # @see Courier::Resources::Inbox::Messages#restore
+      class MessageRestoreParams < Courier::Internal::Type::BaseModel
+        extend Courier::Internal::Type::RequestParameters::Converter
+        include Courier::Internal::Type::RequestParameters
+
+        # @!attribute message_id
+        #
+        #   @return [String]
+        required :message_id, String
+
+        # @!method initialize(message_id:, request_options: {})
+        #   @param message_id [String]
+        #   @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/courier/models/journey_cancel_params.rb

@@ -7,7 +7,19 @@ module Courier
       extend Courier::Internal::Type::RequestParameters::Converter
       include Courier::Internal::Type::RequestParameters
 
-      # @!method initialize(request_options: {})
+      # @!attribute idempotency_key
+      #
+      #   @return [String, nil]
+      optional :idempotency_key, String
+
+      # @!attribute x_idempotency_expiration
+      #
+      #   @return [String, nil]
+      optional :x_idempotency_expiration, String
+
+      # @!method initialize(idempotency_key: nil, x_idempotency_expiration: nil, request_options: {})
+      #   @param idempotency_key [String]
+      #   @param x_idempotency_expiration [String]
       #   @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/courier/models/journey_create_params.rb

@@ -7,7 +7,19 @@ module Courier
       extend Courier::Internal::Type::RequestParameters::Converter
       include Courier::Internal::Type::RequestParameters
 
-      # @!method initialize(request_options: {})
+      # @!attribute idempotency_key
+      #
+      #   @return [String, nil]
+      optional :idempotency_key, String
+
+      # @!attribute x_idempotency_expiration
+      #
+      #   @return [String, nil]
+      optional :x_idempotency_expiration, String
+
+      # @!method initialize(idempotency_key: nil, x_idempotency_expiration: nil, request_options: {})
+      #   @param idempotency_key [String]
+      #   @param x_idempotency_expiration [String]
       #   @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/courier/models/journey_invoke_params.rb

@@ -12,8 +12,20 @@ module Courier
       #   @return [String]
       required :template_id, String
 
-      # @!method initialize(template_id:, request_options: {})
+      # @!attribute idempotency_key
+      #
+      #   @return [String, nil]
+      optional :idempotency_key, String
+
+      # @!attribute x_idempotency_expiration
+      #
+      #   @return [String, nil]
+      optional :x_idempotency_expiration, String
+
+      # @!method initialize(template_id:, idempotency_key: nil, x_idempotency_expiration: nil, request_options: {})
       #   @param template_id [String]
+      #   @param idempotency_key [String]
+      #   @param x_idempotency_expiration [String]
       #   @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/courier/models/journey_publish_params.rb

@@ -12,8 +12,20 @@ module Courier
       #   @return [String]
       required :template_id, String
 
-      # @!method initialize(template_id:, request_options: {})
+      # @!attribute idempotency_key
+      #
+      #   @return [String, nil]
+      optional :idempotency_key, String
+
+      # @!attribute x_idempotency_expiration
+      #
+      #   @return [String, nil]
+      optional :x_idempotency_expiration, String
+
+      # @!method initialize(template_id:, idempotency_key: nil, x_idempotency_expiration: nil, request_options: {})
       #   @param template_id [String]
+      #   @param idempotency_key [String]
+      #   @param x_idempotency_expiration [String]
       #   @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/courier/models/journeys/template_create_params.rb

@@ -13,8 +13,20 @@ module Courier
         #   @return [String]
         required :template_id, String
 
-        # @!method initialize(template_id:, request_options: {})
+        # @!attribute idempotency_key
+        #
+        #   @return [String, nil]
+        optional :idempotency_key, String
+
+        # @!attribute x_idempotency_expiration
+        #
+        #   @return [String, nil]
+        optional :x_idempotency_expiration, String
+
+        # @!method initialize(template_id:, idempotency_key: nil, x_idempotency_expiration: nil, request_options: {})
         #   @param template_id [String]
+        #   @param idempotency_key [String]
+        #   @param x_idempotency_expiration [String]
         #   @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
       end
     end

data/lib/courier/models/journeys/template_publish_params.rb

@@ -18,9 +18,21 @@ module Courier
         #   @return [String]
         required :notification_id, String
 
-        # @!method initialize(template_id:, notification_id:, request_options: {})
+        # @!attribute idempotency_key
+        #
+        #   @return [String, nil]
+        optional :idempotency_key, String
+
+        # @!attribute x_idempotency_expiration
+        #
+        #   @return [String, nil]
+        optional :x_idempotency_expiration, String
+
+        # @!method initialize(template_id:, notification_id:, idempotency_key: nil, x_idempotency_expiration: nil, request_options: {})
         #   @param template_id [String]
         #   @param notification_id [String]
+        #   @param idempotency_key [String]
+        #   @param x_idempotency_expiration [String]
         #   @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
       end
     end

data/lib/courier/models/lists/subscription_add_params.rb

@@ -18,9 +18,21 @@ module Courier
         #   @return [Array<Courier::Models::PutSubscriptionsRecipient>]
         required :recipients, -> { Courier::Internal::Type::ArrayOf[Courier::PutSubscriptionsRecipient] }
 
-        # @!method initialize(list_id:, recipients:, request_options: {})
+        # @!attribute idempotency_key
+        #
+        #   @return [String, nil]
+        optional :idempotency_key, String
+
+        # @!attribute x_idempotency_expiration
+        #
+        #   @return [String, nil]
+        optional :x_idempotency_expiration, String
+
+        # @!method initialize(list_id:, recipients:, idempotency_key: nil, x_idempotency_expiration: nil, request_options: {})
         #   @param list_id [String]
         #   @param recipients [Array<Courier::Models::PutSubscriptionsRecipient>]
+        #   @param idempotency_key [String]
+        #   @param x_idempotency_expiration [String]
         #   @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
       end
     end

data/lib/courier/models/notification_create_params.rb

@@ -7,7 +7,19 @@ module Courier
       extend Courier::Internal::Type::RequestParameters::Converter
       include Courier::Internal::Type::RequestParameters
 
-      # @!method initialize(request_options: {})
+      # @!attribute idempotency_key
+      #
+      #   @return [String, nil]
+      optional :idempotency_key, String
+
+      # @!attribute x_idempotency_expiration
+      #
+      #   @return [String, nil]
+      optional :x_idempotency_expiration, String
+
+      # @!method initialize(idempotency_key: nil, x_idempotency_expiration: nil, request_options: {})
+      #   @param idempotency_key [String]
+      #   @param x_idempotency_expiration [String]
       #   @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/courier/models/notification_publish_params.rb

@@ -12,8 +12,20 @@ module Courier
       #   @return [String]
       required :id, String
 
-      # @!method initialize(id:, request_options: {})
+      # @!attribute idempotency_key
+      #
+      #   @return [String, nil]
+      optional :idempotency_key, String
+
+      # @!attribute x_idempotency_expiration
+      #
+      #   @return [String, nil]
+      optional :x_idempotency_expiration, String
+
+      # @!method initialize(id:, idempotency_key: nil, x_idempotency_expiration: nil, request_options: {})
       #   @param id [String]
+      #   @param idempotency_key [String]
+      #   @param x_idempotency_expiration [String]
       #   @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/courier/models/profile_create_params.rb

@@ -17,9 +17,21 @@ module Courier
       #   @return [Hash{Symbol=>Object}]
       required :profile, Courier::Internal::Type::HashOf[Courier::Internal::Type::Unknown]
 
-      # @!method initialize(user_id:, profile:, request_options: {})
+      # @!attribute idempotency_key
+      #
+      #   @return [String, nil]
+      optional :idempotency_key, String
+
+      # @!attribute x_idempotency_expiration
+      #
+      #   @return [String, nil]
+      optional :x_idempotency_expiration, String
+
+      # @!method initialize(user_id:, profile:, idempotency_key: nil, x_idempotency_expiration: nil, request_options: {})
       #   @param user_id [String]
       #   @param profile [Hash{Symbol=>Object}]
+      #   @param idempotency_key [String]
+      #   @param x_idempotency_expiration [String]
       #   @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/courier/models/profiles/list_subscribe_params.rb

@@ -18,9 +18,21 @@ module Courier
         #   @return [Array<Courier::Models::SubscribeToListsRequestItem>]
         required :lists, -> { Courier::Internal::Type::ArrayOf[Courier::SubscribeToListsRequestItem] }
 
-        # @!method initialize(user_id:, lists:, request_options: {})
+        # @!attribute idempotency_key
+        #
+        #   @return [String, nil]
+        optional :idempotency_key, String
+
+        # @!attribute x_idempotency_expiration
+        #
+        #   @return [String, nil]
+        optional :x_idempotency_expiration, String
+
+        # @!method initialize(user_id:, lists:, idempotency_key: nil, x_idempotency_expiration: nil, request_options: {})
         #   @param user_id [String]
         #   @param lists [Array<Courier::Models::SubscribeToListsRequestItem>]
+        #   @param idempotency_key [String]
+        #   @param x_idempotency_expiration [String]
         #   @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
       end
     end

data/lib/courier/models/provider_create_params.rb

@@ -34,7 +34,17 @@ module Courier
       #   @return [String, nil]
       optional :title, String
 
-      # @!method initialize(provider:, alias_: nil, settings: nil, title: nil, request_options: {})
+      # @!attribute idempotency_key
+      #
+      #   @return [String, nil]
+      optional :idempotency_key, String
+
+      # @!attribute x_idempotency_expiration
+      #
+      #   @return [String, nil]
+      optional :x_idempotency_expiration, String
+
+      # @!method initialize(provider:, alias_: nil, settings: nil, title: nil, idempotency_key: nil, x_idempotency_expiration: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Courier::Models::ProviderCreateParams} for more details.
       #
@@ -46,6 +56,10 @@ module Courier
       #
       #   @param title [String] Optional display title. Omit to use "Default Configuration".
       #
+      #   @param idempotency_key [String]
+      #
+      #   @param x_idempotency_expiration [String]
+      #
       #   @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/courier/models/routing_strategy_create_params.rb

@@ -7,7 +7,19 @@ module Courier
       extend Courier::Internal::Type::RequestParameters::Converter
       include Courier::Internal::Type::RequestParameters
 
-      # @!method initialize(request_options: {})
+      # @!attribute idempotency_key
+      #
+      #   @return [String, nil]
+      optional :idempotency_key, String
+
+      # @!attribute x_idempotency_expiration
+      #
+      #   @return [String, nil]
+      optional :x_idempotency_expiration, String
+
+      # @!method initialize(idempotency_key: nil, x_idempotency_expiration: nil, request_options: {})
+      #   @param idempotency_key [String]
+      #   @param x_idempotency_expiration [String]
       #   @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/courier/models/send_message_params.rb

@@ -14,12 +14,26 @@ module Courier
       #   @return [Courier::Models::SendMessageParams::Message]
       required :message, -> { Courier::SendMessageParams::Message }
 
-      # @!method initialize(message:, request_options: {})
+      # @!attribute idempotency_key
+      #
+      #   @return [String, nil]
+      optional :idempotency_key, String
+
+      # @!attribute x_idempotency_expiration
+      #
+      #   @return [String, nil]
+      optional :x_idempotency_expiration, String
+
+      # @!method initialize(message:, idempotency_key: nil, x_idempotency_expiration: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Courier::Models::SendMessageParams} for more details.
       #
       #   @param message [Courier::Models::SendMessageParams::Message] The message property has the following primary top-level properties. They define
       #
+      #   @param idempotency_key [String]
+      #
+      #   @param x_idempotency_expiration [String]
+      #
       #   @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
 
       class Message < Courier::Internal::Type::BaseModel

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

@@ -27,7 +27,17 @@ module Courier
         #   @return [String, nil]
         optional :tenant_id, String, nil?: true
 
-        # @!method initialize(user_id:, topics:, tenant_id: nil, request_options: {})
+        # @!attribute idempotency_key
+        #
+        #   @return [String, nil]
+        optional :idempotency_key, String
+
+        # @!attribute x_idempotency_expiration
+        #
+        #   @return [String, nil]
+        optional :x_idempotency_expiration, String
+
+        # @!method initialize(user_id:, topics:, tenant_id: nil, idempotency_key: nil, x_idempotency_expiration: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {Courier::Models::Users::PreferenceBulkUpdateParams} for more details.
         #
@@ -37,6 +47,10 @@ module Courier
         #
         #   @param tenant_id [String, nil] Update the preferences of a user for this specific tenant context.
         #
+        #   @param idempotency_key [String]
+        #
+        #   @param x_idempotency_expiration [String]
+        #
         #   @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
 
         class Topic < Courier::Internal::Type::BaseModel