growsurf-python 1.12.0__tar.gz → 1.13.1__tar.gz

growsurf_python-1.13.1/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "1.13.1"
+}

{growsurf_python-1.12.0 → growsurf_python-1.13.1}/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## [1.13.1](https://github.com/growsurf/growsurf-python/compare/v1.13.0...v1.13.1) (2026-10-14)
+
+
+### Documentation
+
+* align SDK option guidance with the REST API ([f93027e](https://github.com/growsurf/growsurf-python/commit/f93027e3580e7412a7991c817912c19901d32721))
+* document language picker flag option ([304a4b4](https://github.com/growsurf/growsurf-python/commit/304a4b4dc9b452c07c04b694b6374df7e535d0e4))
+* sync SDK comments with the REST API contract ([bf3e679](https://github.com/growsurf/growsurf-python/commit/bf3e679d1dcb9db0380babec0f8030a8c0156454))
+
+## [1.13.0](https://github.com/growsurf/growsurf-python/compare/v1.12.0...v1.13.0) (2026-10-09)
+
+
+### Features
+
+* add program and participant language support ([57890e4](https://github.com/growsurf/growsurf-python/commit/57890e4ddfd3b2af6ac43d8caafdcf8ab013f3a6))
+* add program languages and update SDK guidance ([1925adb](https://github.com/growsurf/growsurf-python/commit/1925adb305c1ba3743dcbac397c06dfcb2444743))
+
 ## [1.12.0](https://github.com/growsurf/growsurf-python/compare/v1.11.0...v1.12.0) (2026-10-07)
 
 

{growsurf_python-1.12.0 → growsurf_python-1.13.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: growsurf-python
-Version: 1.12.0
+Version: 1.13.1
 Summary: The official Python library for the growsurf API
 Project-URL: Homepage, https://growsurf.com/
 Project-URL: Repository, https://github.com/growsurf/growsurf-python

growsurf_python-1.13.1/SECURITY.md

@@ -0,0 +1,13 @@
+# Security Policy
+
+## Reporting Security Issues
+
+GrowSurf maintains this SDK. If you believe you have found a security vulnerability in it, please report it to support@growsurf.com rather than opening a public issue.
+
+## Responsible Disclosure
+
+Please give us a reasonable amount of time to investigate and address the issue before making any information public. We appreciate the efforts of security researchers who help keep this SDK and the systems it talks to secure.
+
+## Other GrowSurf Security Issues
+
+For security issues in GrowSurf products or services that are not related to this SDK, contact support@growsurf.com as well.

{growsurf_python-1.12.0 → growsurf_python-1.13.1}/api.md

@@ -105,6 +105,7 @@ Types:
 ```python
 from growsurf.types.campaign import (
     FraudRiskLevel,
+    Language,
     Participant,
     ParticipantReward,
     ReferralSource,

{growsurf_python-1.12.0 → growsurf_python-1.13.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "growsurf-python"
-version = "1.12.0"
+version = "1.13.1"
 description = "The official Python library for the growsurf API"
 dynamic = ["readme"]
 license = "Apache-2.0"

{growsurf_python-1.12.0 → growsurf_python-1.13.1}/src/growsurf/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "growsurf"
-__version__ = "1.12.0"  # x-release-please-version
+__version__ = "1.13.1"  # x-release-please-version

{growsurf_python-1.12.0 → growsurf_python-1.13.1}/src/growsurf/resources/campaign/campaign.py

@@ -127,6 +127,7 @@ from ...types.referral_list import ReferralList
 from ...types.affiliate_invite import AffiliateInvite
 from ...types.participant_list import ParticipantList
 from ...types.campaign.campaign import Campaign
+from ...types.campaign.language import Language
 from ...types.affiliate_application import AffiliateApplication
 from ...types.campaign_list_response import CampaignListResponse
 from ...types.participant_payout_list import ParticipantPayoutList
@@ -345,6 +346,9 @@ class CampaignResource(SyncAPIResource):
         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.
 
         Args:
           status: The requested program status. `IN_PROGRESS` publishes or resumes the program;
@@ -410,6 +414,7 @@ class CampaignResource(SyncAPIResource):
         """
         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.
 
         Args:
           extra_headers: Send extra headers
@@ -439,6 +444,7 @@ class CampaignResource(SyncAPIResource):
         first_name: str | Omit = omit,
         ip_address: str | Omit = omit,
         is_affiliate: bool | Omit = omit,
+        language: Language | Omit = omit,
         last_name: str | Omit = omit,
         metadata: Dict[str, object] | Omit = omit,
         mobile_instance_id: str | Omit = omit,
@@ -466,6 +472,9 @@ class CampaignResource(SyncAPIResource):
 
           is_affiliate: Affiliate programs only. Controls affiliate enrollment for a new participant.
 
+          language: The language of the participant's portal and program emails. Must be one of the
+              program's languages. Applied only when this request creates the participant.
+
           referred_by: Referrer participant ID or email address.
 
           extra_headers: Send extra headers
@@ -487,6 +496,7 @@ class CampaignResource(SyncAPIResource):
                     "first_name": first_name,
                     "ip_address": ip_address,
                     "is_affiliate": is_affiliate,
+                    "language": language,
                     "last_name": last_name,
                     "metadata": metadata,
                     "mobile_instance_id": mobile_instance_id,
@@ -1571,6 +1581,9 @@ class AsyncCampaignResource(AsyncAPIResource):
         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.
 
         Args:
           status: The requested program status. `IN_PROGRESS` publishes or resumes the program;
@@ -1636,6 +1649,7 @@ class AsyncCampaignResource(AsyncAPIResource):
         """
         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.
 
         Args:
           extra_headers: Send extra headers
@@ -1665,6 +1679,7 @@ class AsyncCampaignResource(AsyncAPIResource):
         first_name: str | Omit = omit,
         ip_address: str | Omit = omit,
         is_affiliate: bool | Omit = omit,
+        language: Language | Omit = omit,
         last_name: str | Omit = omit,
         metadata: Dict[str, object] | Omit = omit,
         mobile_instance_id: str | Omit = omit,
@@ -1692,6 +1707,9 @@ class AsyncCampaignResource(AsyncAPIResource):
 
           is_affiliate: Affiliate programs only. Controls affiliate enrollment for a new participant.
 
+          language: The language of the participant's portal and program emails. Must be one of the
+              program's languages. Applied only when this request creates the participant.
+
           referred_by: Referrer participant ID or email address.
 
           extra_headers: Send extra headers
@@ -1713,6 +1731,7 @@ class AsyncCampaignResource(AsyncAPIResource):
                     "first_name": first_name,
                     "ip_address": ip_address,
                     "is_affiliate": is_affiliate,
+                    "language": language,
                     "last_name": last_name,
                     "metadata": metadata,
                     "mobile_instance_id": mobile_instance_id,

{growsurf_python-1.12.0 → growsurf_python-1.13.1}/src/growsurf/resources/campaign/design.py

@@ -101,6 +101,9 @@ class DesignResource(SyncAPIResource):
         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.
 
         Args:
           body: A partial `CampaignDesign` object — only the fields you send are changed.
@@ -206,6 +209,9 @@ class AsyncDesignResource(AsyncAPIResource):
         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.
 
         Args:
           body: A partial `CampaignDesign` object — only the fields you send are changed.

{growsurf_python-1.12.0 → growsurf_python-1.13.1}/src/growsurf/resources/campaign/emails.py

@@ -104,6 +104,9 @@ class EmailsResource(SyncAPIResource):
         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.
 
         Args:
           body: A partial `CampaignEmails` object — only the fields you send are changed.
@@ -210,6 +213,9 @@ class AsyncEmailsResource(AsyncAPIResource):
         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.
 
         Args:
           body: A partial `CampaignEmails` object — only the fields you send are changed.

{growsurf_python-1.12.0 → growsurf_python-1.13.1}/src/growsurf/resources/campaign/installation.py

@@ -99,6 +99,9 @@ class InstallationResource(SyncAPIResource):
         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.
 
         Args:
           body: A partial `CampaignInstallation` object — only the fields you send are changed.
@@ -200,6 +203,9 @@ class AsyncInstallationResource(AsyncAPIResource):
         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.
 
         Args:
           body: A partial `CampaignInstallation` object — only the fields you send are changed.

{growsurf_python-1.12.0 → growsurf_python-1.13.1}/src/growsurf/resources/campaign/options.py

@@ -56,12 +56,11 @@ class OptionsResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> CampaignOptions:
         """
-        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), and
-        notification-email settings, and `attributionModel` (`LAST_CLICK` or
-        `FIRST_CLICK`). `fraud.recaptcha.secretKey` is never returned.
+        Retrieves a program's options — the same surface as the dashboard Program 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.
 
         Args:
           extra_headers: Send extra headers
@@ -101,6 +100,12 @@ class OptionsResource(SyncAPIResource):
         and `payoutThreshold`/`taxDocumentation` are affiliate-only, and affiliate
         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. 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.
 
         Args:
           body: A partial `CampaignOptions` object — only the fields you send are changed.
@@ -159,12 +164,11 @@ class AsyncOptionsResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> CampaignOptions:
         """
-        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), and
-        notification-email settings, and `attributionModel` (`LAST_CLICK` or
-        `FIRST_CLICK`). `fraud.recaptcha.secretKey` is never returned.
+        Retrieves a program's options — the same surface as the dashboard Program 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.
 
         Args:
           extra_headers: Send extra headers
@@ -204,6 +208,12 @@ class AsyncOptionsResource(AsyncAPIResource):
         and `payoutThreshold`/`taxDocumentation` are affiliate-only, and affiliate
         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. 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.
 
         Args:
           body: A partial `CampaignOptions` object — only the fields you send are changed.

{growsurf_python-1.12.0 → growsurf_python-1.13.1}/src/growsurf/resources/campaign/participant.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Any, Dict, Iterable, cast
+from typing import Any, Dict, Iterable, Optional, cast
 from typing_extensions import Literal
 
 import httpx
@@ -37,6 +37,7 @@ from ...types.campaign import (
     participant_request_payout_destination_confirmation_params,
 )
 from ...types.referral_list import ReferralList
+from ...types.campaign.language import Language
 from ...types.campaign.participant import Participant
 from ...types.participant_payout_list import ParticipantPayoutList
 from ...types.campaign.referral_status import ReferralStatus
@@ -129,6 +130,7 @@ class ParticipantResource(SyncAPIResource):
         affiliate_status: Literal["APPROVED", "SUSPENDED", "BANNED"] | Omit = omit,
         email: str | Omit = omit,
         first_name: str | Omit = omit,
+        language: Optional[Language] | Omit = omit,
         last_name: str | Omit = omit,
         metadata: Dict[str, object] | Omit = omit,
         notes: str | Omit = omit,
@@ -155,6 +157,10 @@ class ParticipantResource(SyncAPIResource):
               participant who is not yet an affiliate. `SUSPENDED` and `BANNED` are rejected for
               non-affiliates.
 
+          language: The language of the participant's portal and program emails. Must be one of the
+              program's languages (see `languages` in the program options). Send the base
+              language or `null` to use the program's base language.
+
           metadata: Shallow custom metadata object.
 
           notes: Freeform internal notes about the participant (internal only, never exposed to
@@ -185,6 +191,7 @@ class ParticipantResource(SyncAPIResource):
                     "affiliate_status": affiliate_status,
                     "email": email,
                     "first_name": first_name,
+                    "language": language,
                     "last_name": last_name,
                     "metadata": metadata,
                     "notes": notes,
@@ -298,6 +305,7 @@ class ParticipantResource(SyncAPIResource):
         first_name: str | Omit = omit,
         ip_address: str | Omit = omit,
         is_affiliate: bool | Omit = omit,
+        language: Language | Omit = omit,
         last_name: str | Omit = omit,
         metadata: Dict[str, object] | Omit = omit,
         mobile_instance_id: str | Omit = omit,
@@ -326,6 +334,9 @@ class ParticipantResource(SyncAPIResource):
               non-affiliate without `affiliateStatus`. Existing participants are returned
               unchanged.
 
+          language: The language of the participant's portal and program emails. Must be one of the
+              program's languages. Applied only when this request creates the participant.
+
           metadata: Shallow custom metadata object.
 
           mobile_instance_id: Optional app-install scoped identifier for native mobile anti-fraud. Recommended
@@ -358,6 +369,7 @@ class ParticipantResource(SyncAPIResource):
                     "first_name": first_name,
                     "ip_address": ip_address,
                     "is_affiliate": is_affiliate,
+                    "language": language,
                     "last_name": last_name,
                     "metadata": metadata,
                     "mobile_instance_id": mobile_instance_id,
@@ -1019,7 +1031,7 @@ class ParticipantResource(SyncAPIResource):
         name, postal address, and an unsubscribe link are added automatically, and
         unsubscribed participants are suppressed). Sending requires the team to be
         verified by GrowSurf. Requires a **verified custom email domain** on the program
-        (which can be completed in *Campaign Editor > 3. Emails > Email Settings*).
+        (which can be completed in *Program Editor > 3. Emails > Email Settings*).
         Returns `400` until one is verified. The email is accepted for delivery.
 
         Args:
@@ -1397,6 +1409,7 @@ class AsyncParticipantResource(AsyncAPIResource):
         affiliate_status: Literal["APPROVED", "SUSPENDED", "BANNED"] | Omit = omit,
         email: str | Omit = omit,
         first_name: str | Omit = omit,
+        language: Optional[Language] | Omit = omit,
         last_name: str | Omit = omit,
         metadata: Dict[str, object] | Omit = omit,
         notes: str | Omit = omit,
@@ -1423,6 +1436,10 @@ class AsyncParticipantResource(AsyncAPIResource):
               participant who is not yet an affiliate. `SUSPENDED` and `BANNED` are rejected for
               non-affiliates.
 
+          language: The language of the participant's portal and program emails. Must be one of the
+              program's languages (see `languages` in the program options). Send the base
+              language or `null` to use the program's base language.
+
           metadata: Shallow custom metadata object.
 
           notes: Freeform internal notes about the participant (internal only, never exposed to
@@ -1453,6 +1470,7 @@ class AsyncParticipantResource(AsyncAPIResource):
                     "affiliate_status": affiliate_status,
                     "email": email,
                     "first_name": first_name,
+                    "language": language,
                     "last_name": last_name,
                     "metadata": metadata,
                     "notes": notes,
@@ -1566,6 +1584,7 @@ class AsyncParticipantResource(AsyncAPIResource):
         first_name: str | Omit = omit,
         ip_address: str | Omit = omit,
         is_affiliate: bool | Omit = omit,
+        language: Language | Omit = omit,
         last_name: str | Omit = omit,
         metadata: Dict[str, object] | Omit = omit,
         mobile_instance_id: str | Omit = omit,
@@ -1594,6 +1613,9 @@ class AsyncParticipantResource(AsyncAPIResource):
               non-affiliate without `affiliateStatus`. Existing participants are returned
               unchanged.
 
+          language: The language of the participant's portal and program emails. Must be one of the
+              program's languages. Applied only when this request creates the participant.
+
           metadata: Shallow custom metadata object.
 
           mobile_instance_id: Optional app-install scoped identifier for native mobile anti-fraud. Recommended
@@ -1626,6 +1648,7 @@ class AsyncParticipantResource(AsyncAPIResource):
                     "first_name": first_name,
                     "ip_address": ip_address,
                     "is_affiliate": is_affiliate,
+                    "language": language,
                     "last_name": last_name,
                     "metadata": metadata,
                     "mobile_instance_id": mobile_instance_id,
@@ -2287,7 +2310,7 @@ class AsyncParticipantResource(AsyncAPIResource):
         name, postal address, and an unsubscribe link are added automatically, and
         unsubscribed participants are suppressed). Sending requires the team to be
         verified by GrowSurf. Requires a **verified custom email domain** on the program
-        (which can be completed in *Campaign Editor > 3. Emails > Email Settings*).
+        (which can be completed in *Program Editor > 3. Emails > Email Settings*).
         Returns `400` until one is verified. The email is accepted for delivery.
 
         Args:

{growsurf_python-1.12.0 → growsurf_python-1.13.1}/src/growsurf/resources/campaign/reward.py

@@ -58,8 +58,8 @@ class RewardResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> RewardDeleteResponse:
         """
-        Removes a manually approved participant reward that has not already been
-        approved.
+        Removes a participant reward that requires manual approval and has not yet
+        been approved.
 
         Args:
           extra_headers: Send extra headers
@@ -96,7 +96,7 @@ class RewardResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> RewardApproveResponse:
         """
-        Approves a manually approved reward earned by a participant. This requires
+        Approves a participant reward that requires manual approval. This requires
         `reward:write`. When the request also sets `fulfill` to `true`, it additionally
         requires `reward:fulfill`.
 
@@ -196,8 +196,8 @@ class AsyncRewardResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> RewardDeleteResponse:
         """
-        Removes a manually approved participant reward that has not already been
-        approved.
+        Removes a participant reward that requires manual approval and has not yet
+        been approved.
 
         Args:
           extra_headers: Send extra headers
@@ -234,7 +234,7 @@ class AsyncRewardResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> RewardApproveResponse:
         """
-        Approves a manually approved reward earned by a participant. This requires
+        Approves a participant reward that requires manual approval. This requires
         `reward:write`. When the request also sets `fulfill` to `true`, it additionally
         requires `reward:fulfill`.
 

{growsurf_python-1.12.0 → growsurf_python-1.13.1}/src/growsurf/resources/campaign/rewards.py

@@ -89,6 +89,7 @@ class RewardsResource(SyncAPIResource):
         support only `AFFILIATE` rewards; referral programs support all other types).
         Enabling an active reward of a type automatically enables that reward type on
         the program.
+        A concurrent edit can return `409`; reload the program before retrying.
 
         Args:
           type: The reward type. Immutable after creation.
@@ -221,6 +222,9 @@ class RewardsResource(SyncAPIResource):
         keys automatically rewrite any `{{campaignReward[…]}}` references in campaign
         copy; removing a key that campaign copy still references returns a `409` listing
         the referencing fields.
+        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.
 
         Args:
           commission_structure: The affiliate commission structure (AFFILIATE rewards only).
@@ -455,6 +459,7 @@ class AsyncRewardsResource(AsyncAPIResource):
         support only `AFFILIATE` rewards; referral programs support all other types).
         Enabling an active reward of a type automatically enables that reward type on
         the program.
+        A concurrent edit can return `409`; reload the program before retrying.
 
         Args:
           type: The reward type. Immutable after creation.
@@ -587,6 +592,9 @@ class AsyncRewardsResource(AsyncAPIResource):
         keys automatically rewrite any `{{campaignReward[…]}}` references in campaign
         copy; removing a key that campaign copy still references returns a `409` listing
         the referencing fields.
+        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.
 
         Args:
           commission_structure: The affiliate commission structure (AFFILIATE rewards only).

{growsurf_python-1.12.0 → growsurf_python-1.13.1}/src/growsurf/types/campaign/__init__.py

@@ -5,6 +5,7 @@ from __future__ import annotations
 from .reward import Reward as Reward
 from .webhook import Webhook as Webhook
 from .campaign import Campaign as Campaign
+from .language import Language as Language
 from .integration import Integration as Integration
 from .participant import Participant as Participant
 from .webhook_event import WebhookEvent as WebhookEvent

{growsurf_python-1.12.0 → growsurf_python-1.13.1}/src/growsurf/types/campaign/campaign_options.py

@@ -8,8 +8,9 @@ __all__ = ["CampaignOptions"]
 # A program's options (the dashboard Program Editor's Options tab): reward/fraud
 # approval, anti-fraud lists + toggles, the `LAST_CLICK` or `FIRST_CLICK`
 # attribution model, referral windows, reCAPTCHA, affiliate enrollment +
-# application review, payout + tax settings (affiliate only), and notification-
-# email settings. It is intentionally modeled as a loose object. To see the full
+# application review, payout + tax settings (affiliate only), notification-email
+# settings, and the program's `languages` (`baseLanguage`, `additionalLanguages`,
+# and `showFlags`). It is intentionally modeled as a loose object. To see the full
 # object with every field and its current value, `GET` the resource, then `PATCH`
 # back only the fields you want to change.
 CampaignOptions: TypeAlias = Dict[str, object]

growsurf_python-1.13.1/src/growsurf/types/campaign/language.py

@@ -0,0 +1,9 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing_extensions import Literal, TypeAlias
+
+__all__ = ["Language"]
+
+# A language a program can run in. Participants see the portal and receive program
+# emails in their language.
+Language: TypeAlias = Literal["en", "es", "fr", "de", "it", "pt-BR", "nl", "pl", "sv", "tr", "ja", "ko", "zh-CN", "id"]

{growsurf_python-1.12.0 → growsurf_python-1.13.1}/src/growsurf/types/campaign/participant.py

@@ -5,6 +5,7 @@ from typing_extensions import Literal
 
 from pydantic import Field as FieldInfo
 
+from .language import Language
 from ..._models import BaseModel
 from .referral_source import ReferralSource
 from .referral_status import ReferralStatus
@@ -149,6 +150,13 @@ class Participant(BaseModel):
 
     is_winner: Optional[bool] = FieldInfo(alias="isWinner", default=None)
 
+    language: Optional[Language] = None
+    """The language of the participant's portal and program emails.
+
+    The program's base language unless the participant (or you) picked another of the
+    program's languages.
+    """
+
     last_name: Optional[str] = FieldInfo(alias="lastName", default=None)
 
     lead_count: Optional[int] = FieldInfo(alias="leadCount", default=None)

{growsurf_python-1.12.0 → growsurf_python-1.13.1}/src/growsurf/types/campaign/participant_add_params.py

@@ -6,6 +6,7 @@ from typing import Dict
 from typing_extensions import Literal, Required, Annotated, TypedDict
 
 from ..._utils import PropertyInfo
+from .language import Language
 
 __all__ = ["ParticipantAddParams"]
 
@@ -27,6 +28,13 @@ class ParticipantAddParams(TypedDict, total=False):
     unchanged.
     """
 
+    language: Language
+    """The language of the participant's portal and program emails.
+
+    Must be one of the program's languages. Applied only when this request creates
+    the participant.
+    """
+
     last_name: Annotated[str, PropertyInfo(alias="lastName")]
 
     metadata: Dict[str, object]

{growsurf_python-1.12.0 → growsurf_python-1.13.1}/src/growsurf/types/campaign/participant_update_params.py

@@ -2,11 +2,12 @@
 
 from __future__ import annotations
 
-from typing import Dict
+from typing import Dict, Optional
 from typing_extensions import Literal, Required, Annotated, TypedDict
 
 from ..._types import SequenceNotStr
 from ..._utils import PropertyInfo
+from .language import Language
 
 __all__ = ["ParticipantUpdateParams"]
 
@@ -25,6 +26,13 @@ class ParticipantUpdateParams(TypedDict, total=False):
 
     first_name: Annotated[str, PropertyInfo(alias="firstName")]
 
+    language: Optional[Language]
+    """The language of the participant's portal and program emails.
+
+    Must be one of the program's languages (see `languages` in the program options).
+    Send the base language or `null` to use the program's base language.
+    """
+
     last_name: Annotated[str, PropertyInfo(alias="lastName")]
 
     metadata: Dict[str, object]

{growsurf_python-1.12.0 → growsurf_python-1.13.1}/src/growsurf/types/campaign_create_mobile_participant_token_params.py

@@ -6,6 +6,7 @@ from typing import Dict
 from typing_extensions import Literal, Required, Annotated, TypedDict
 
 from .._utils import PropertyInfo
+from .campaign.language import Language
 
 __all__ = ["CampaignCreateMobileParticipantTokenParams"]
 
@@ -27,6 +28,13 @@ class CampaignCreateMobileParticipantTokenParams(TypedDict, total=False):
     unchanged.
     """
 
+    language: Language
+    """The language of the participant's portal and program emails.
+
+    Must be one of the program's languages. Applied only when this request creates
+    the participant.
+    """
+
     last_name: Annotated[str, PropertyInfo(alias="lastName")]
 
     metadata: Dict[str, object]