growsurf-ruby 1.13.0 → 1.13.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 442841d57191df0f9e6a803984d7d76ef7dc3e61b2cd7820ac89c0a07c69cb53
-  data.tar.gz: 33068c528f6fc764da5801b39c604259fdb4538dedbbe29b5131d8c634048602
+  metadata.gz: f6d2dc9919ceef21fe534f95e3b51189b4801902cb7d5b5e930145c3b38ab6d6
+  data.tar.gz: 0e63f2406c0c7767ea0fc0b22244ce13da2de1b93a34b1e19bc484de2fd72d02
 SHA512:
-  metadata.gz: 3b03ce3772e8ae528438e52a4945e68fa119e74839e364625952038aa0d87238dcecdb8afcae01e62fd560f33adeb6d2d462d3742be21ce4ce8646244f2c9799
-  data.tar.gz: 1e4fbeaef362092363b5d9eccdb3ce9e4b7331f44cfebc7874099b367662c0d7dc2b771ebb0d1e3dcac63f1af167d4ca5792b14886d269a9349cc6c18ac97af0
+  metadata.gz: 223dd14d46675ed5fa185c8b75815d50eed2221bde317f2dbb20d11ba35f6d1d33b363af1e6a3b93c17bd0e9f080aa8443029db3dd25b6d9765a3e33545c4c30
+  data.tar.gz: d2d3d0de619f63a1786e63283d17ce998355e2834d1c976034ee579e502474a9951b989198cd99484abc988fe077e9ea35994124b75948f80c0be2da70810495

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## [1.13.1](https://github.com/growsurf/growsurf-ruby/compare/v1.13.0...v1.13.1) (2026-10-14)
+
+
+### Documentation
+
+* note Business plan covers any language change while languages are on ([10cb2ca](https://github.com/growsurf/growsurf-ruby/commit/10cb2ca8522e15e509b7a31774a7da0571859ebc))
+* sync SDK comments with the REST API contract ([28ab4fd](https://github.com/growsurf/growsurf-ruby/commit/28ab4fddd5f58bb2234d018f10afdda047df3c00))
+* sync SDK guidance with the REST API contract ([d2e01f5](https://github.com/growsurf/growsurf-ruby/commit/d2e01f53d729d54220b56c766160f15ff19e14d0))
+
 ## [1.13.0](https://github.com/growsurf/growsurf-ruby/compare/v1.12.0...v1.13.0) (2026-10-09)
 
 

data/README.md

@@ -17,7 +17,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "growsurf-ruby", "~> 1.13.0"
+gem "growsurf-ruby", "~> 1.13.1"
 ```
 
 <!-- x-release-please-end -->

data/lib/growsurf_ruby/resources/campaign/design.rb

@@ -44,6 +44,10 @@ module GrowsurfRuby
         # anything you leave out is untouched (arrays such as `signup.fields` replace wholesale).
         # Unknown fields, fields not available for the program type, and invalid values return a
         # `400`. Landing-page custom code and JavaScript are not editable via the API.
+        # Changes to participant email content are checked before saving. Rejected content
+        # returns `400`; if the check is unavailable, `503` asks you to retry. Neither
+        # response saves the change. A concurrent edit can return `409`; reload the
+        # program before retrying.
         #
         # @overload update(id, body, request_options: {})
         #

data/lib/growsurf_ruby/resources/campaign/emails.rb

@@ -39,6 +39,10 @@ module GrowsurfRuby
         # available for the program type returns a `400`. Some fields are read-only
         # (`settings.sender.fromEmail`, whose custom value requires dashboard domain
         # verification).
+        # Changes to participant email content are checked before saving. Rejected content
+        # returns `400`; if the check is unavailable, `503` asks you to retry. Neither
+        # response saves the change. A concurrent edit can return `409`; reload the
+        # program before retrying.
         #
         # @overload update(id, body, request_options: {})
         #

data/lib/growsurf_ruby/resources/campaign/installation.rb

@@ -32,6 +32,10 @@ module GrowsurfRuby
         # enabling `mobile.isEnabled` creates one. Changing `shareUrl` re-resolves its
         # redirect destinations, which may take a moment to complete. URLs must include an
         # explicit `http://` or `https://` scheme.
+        # Changes to participant email content are checked before saving. Rejected content
+        # returns `400`; if the check is unavailable, `503` asks you to retry. Neither
+        # response saves the change. A concurrent edit can return `409`; reload the
+        # program before retrying.
         #
         # @overload update(id, body, request_options: {})
         #

data/lib/growsurf_ruby/resources/campaign/options.rb

@@ -5,10 +5,10 @@ module GrowsurfRuby
     class Campaign
       class Options
         # Retrieves a program's options — the same surface as the dashboard Program
-        # Editor's **Options** tab. Includes reward/fraud approval, anti-fraud lists +
-        # toggles, referral cookie/credit windows, reCAPTCHA, affiliate enrollment +
-        # application review, payout threshold + tax settings (affiliate only),
-        # notification-email settings, and the program's languages.
+        # Editor's **Options** tab. Includes the attribution model, reward/fraud approval,
+        # anti-fraud lists + toggles, referral cookie/credit windows, reCAPTCHA, affiliate
+        # enrollment + application review, payout threshold + tax settings (affiliate
+        # only), notification-email settings, and the program's languages.
         # `fraud.recaptcha.secretKey` is never returned.
         #
         # @overload retrieve(id, request_options: {})
@@ -34,7 +34,12 @@ module GrowsurfRuby
         # programs require `requireParticipantAuth: true`). `fraud.recaptcha.secretKey`
         # is write-only. `referralCreditWindowDays: null` means "never expires".
         # Turning on `languages.additionalLanguages` requires the Business plan or
-        # higher (`403` otherwise).
+        # higher. While any are on, every `languages` change, including turning them
+        # off, requires it too (`403` otherwise).
+        # Changes to participant email content are checked before saving. Rejected content
+        # returns `400`; if the check is unavailable, `503` asks you to retry. Neither
+        # response saves the change. A concurrent edit can return `409`; reload the
+        # program before retrying.
         #
         # @overload update(id, body, request_options: {})
         #

data/lib/growsurf_ruby/resources/campaign/rewards.rb

@@ -31,6 +31,7 @@ module GrowsurfRuby
         # Enabling an active reward of a type automatically enables that reward type on
         # the program. For an affiliate reward, `commissionStructure.event: LEAD`
         # requires a `FIXED` commission with a positive `amount`.
+        # A concurrent edit can return `409`; reload the program before retrying.
         #
         # @overload create(id, type:, commission_structure: nil, conversions_required: nil, coupon_code: nil, description: nil, event: nil, image_url: nil, is_unlimited: nil, is_visible: nil, limit: nil, limit_duration: nil, metadata: nil, next_milestone_prefix: nil, next_milestone_suffix: nil, number_of_winners: nil, order: nil, referral_coupon_code: nil, referral_description: nil, referred_reward_upfront: nil, referred_value: nil, title: nil, value: nil, request_options: {})
         #
@@ -102,6 +103,10 @@ module GrowsurfRuby
         # copy; removing a key that campaign copy still references returns a `409` listing
         # the referencing fields. For an affiliate reward, `commissionStructure.event:
         # LEAD` requires a `FIXED` commission with a positive `amount`.
+        # Changes to participant email content are checked before saving. Rejected content
+        # returns `400`; if the check is unavailable, `503` asks you to retry. Neither
+        # response saves the change. A concurrent edit can return `409`; reload the
+        # program before retrying.
         #
         # @overload update(campaign_reward_id, id:, commission_structure: nil, conversions_required: nil, coupon_code: nil, description: nil, event: nil, image_url: nil, is_unlimited: nil, is_visible: nil, limit: nil, limit_duration: nil, metadata: nil, next_milestone_prefix: nil, next_milestone_suffix: nil, number_of_winners: nil, order: nil, referral_coupon_code: nil, referral_description: nil, referred_reward_upfront: nil, referred_value: nil, title: nil, value: nil, request_options: {})
         #

data/lib/growsurf_ruby/resources/campaign.rb

@@ -124,6 +124,10 @@ module GrowsurfRuby
       # configuration (design, emails, options, installation) is edited via the
       # dedicated config sub-resources, not here. The program cannot be deleted via this
       # endpoint.
+      # Changes to participant email content are checked before saving. Rejected content
+      # returns `400`; if the check is unavailable, `503` asks you to retry. Neither
+      # response saves the change. A concurrent edit can return `409`; reload the program
+      # before retrying.
       #
       # @overload update(id, company_logo_image_url: nil, company_name: nil, name: nil, status: nil, request_options: {})
       #
@@ -155,6 +159,7 @@ module GrowsurfRuby
 
       # Clones an existing program into a new `DRAFT` program. Integrations and
       # credentials are not copied; active rewards are cloned.
+      # A concurrent edit to the program can return `409`; retry the clone.
       #
       # @overload clone(id, request_options: {})
       #

data/lib/growsurf_ruby/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module GrowsurfRuby
-  VERSION = "1.13.0"
+  VERSION = "1.13.1"
 end

data/rbi/growsurf_ruby/resources/campaign/design.rbi

@@ -63,6 +63,10 @@ module GrowsurfRuby
         # wholesale). Unknown fields, fields not available for the program type, and invalid
         # values return a `400`. Landing-page custom code and JavaScript are not editable via the
         # API.
+        # Changes to participant email content are checked before saving. Rejected content
+        # returns `400`; if the check is unavailable, `503` asks you to retry. Neither
+        # response saves the change. A concurrent edit can return `409`; reload the
+        # program before retrying.
         sig do
           params(
             id: String,

data/rbi/growsurf_ruby/resources/campaign/emails.rbi

@@ -33,6 +33,10 @@ module GrowsurfRuby
         # available for the program type returns a `400`. Some fields are read-only
         # (`settings.sender.fromEmail`, whose custom value requires dashboard domain
         # verification).
+        # Changes to participant email content are checked before saving. Rejected content
+        # returns `400`; if the check is unavailable, `503` asks you to retry. Neither
+        # response saves the change. A concurrent edit can return `409`; reload the
+        # program before retrying.
         sig do
           params(
             id: String,

data/rbi/growsurf_ruby/resources/campaign/installation.rbi

@@ -27,6 +27,10 @@ module GrowsurfRuby
         # enabling `mobile.isEnabled` creates one. Changing `shareUrl` re-resolves its
         # redirect destinations, which may take a moment to complete. URLs must include an
         # explicit `http://` or `https://` scheme.
+        # Changes to participant email content are checked before saving. Rejected content
+        # returns `400`; if the check is unavailable, `503` asks you to retry. Neither
+        # response saves the change. A concurrent edit can return `409`; reload the
+        # program before retrying.
         sig do
           params(
             id: String,

data/rbi/growsurf_ruby/resources/campaign/options.rbi

@@ -5,10 +5,10 @@ module GrowsurfRuby
     class Campaign
       class Options
         # Retrieves a program's options — the same surface as the dashboard Program
-        # Editor's **Options** tab. Includes reward/fraud approval, anti-fraud lists +
-        # toggles, referral cookie/credit windows, reCAPTCHA, affiliate enrollment +
-        # application review, payout threshold + tax settings (affiliate only),
-        # notification-email settings, and the program's languages.
+        # Editor's **Options** tab. Includes the attribution model, reward/fraud approval,
+        # anti-fraud lists + toggles, referral cookie/credit windows, reCAPTCHA, affiliate
+        # enrollment + application review, payout threshold + tax settings (affiliate
+        # only), notification-email settings, and the program's languages.
         # `fraud.recaptcha.secretKey` is never returned.
         sig do
           params(
@@ -30,7 +30,12 @@ module GrowsurfRuby
         # programs require `requireParticipantAuth: true`). `fraud.recaptcha.secretKey`
         # is write-only. `referralCreditWindowDays: null` means "never expires".
         # Turning on `languages.additionalLanguages` requires the Business plan or
-        # higher (`403` otherwise).
+        # higher. While any are on, every `languages` change, including turning them
+        # off, requires it too (`403` otherwise).
+        # Changes to participant email content are checked before saving. Rejected content
+        # returns `400`; if the check is unavailable, `503` asks you to retry. Neither
+        # response saves the change. A concurrent edit can return `409`; reload the
+        # program before retrying.
         sig do
           params(
             id: String,

data/rbi/growsurf_ruby/resources/campaign/rewards.rbi

@@ -27,6 +27,7 @@ module GrowsurfRuby
         # Enabling an active reward of a type automatically enables that reward type on
         # the program. For an affiliate reward, `commissionStructure.event: LEAD`
         # requires a `FIXED` commission with a positive `amount`.
+        # A concurrent edit can return `409`; reload the program before retrying.
         sig do
           params(
             id: String,
@@ -134,6 +135,10 @@ module GrowsurfRuby
         # copy; removing a key that campaign copy still references returns a `409` listing
         # the referencing fields. For an affiliate reward, `commissionStructure.event:
         # LEAD` requires a `FIXED` commission with a positive `amount`.
+        # Changes to participant email content are checked before saving. Rejected content
+        # returns `400`; if the check is unavailable, `503` asks you to retry. Neither
+        # response saves the change. A concurrent edit can return `409`; reload the
+        # program before retrying.
         sig do
           params(
             campaign_reward_id: String,

data/rbi/growsurf_ruby/resources/campaign.rbi

@@ -110,6 +110,10 @@ module GrowsurfRuby
       # configuration (design, emails, options, installation) is edited via the
       # dedicated config sub-resources, not here. The program cannot be deleted via this
       # endpoint.
+      # Changes to participant email content are checked before saving. Rejected content
+      # returns `400`; if the check is unavailable, `503` asks you to retry. Neither
+      # response saves the change. A concurrent edit can return `409`; reload the program
+      # before retrying.
       sig do
         params(
           id: String,
@@ -138,6 +142,7 @@ module GrowsurfRuby
 
       # Clones an existing program into a new `DRAFT` program. Integrations and
       # credentials are not copied; active rewards are cloned.
+      # A concurrent edit to the program can return `409`; retry the clone.
       sig do
         params(
           id: String,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: growsurf-ruby
 version: !ruby/object:Gem::Version
-  version: 1.13.0
+  version: 1.13.1
 platform: ruby
 authors:
 - Growsurf
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-10-09 00:00:00.000000000 Z
+date: 2026-10-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi