growsurf-python 1.5.0__tar.gz → 1.6.0__tar.gz

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

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

{growsurf_python-1.5.0 → growsurf_python-1.6.0}/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## [1.6.0](https://github.com/growsurf/growsurf-python/compare/v1.5.1...v1.6.0) (2026-09-14)
+
+
+### Features
+
+* **api:** add pending analyticsErasure to participant delete responses ([5c6b28b](https://github.com/growsurf/growsurf-python/commit/5c6b28b0adcbc0a69629e176d54b3cf3ab83bc33))
+
+
+### Chores
+
+* merge dev into main ([f1092ac](https://github.com/growsurf/growsurf-python/commit/f1092ac6e7fc2c16c79c482bed009ee398c3307c))
+
+## [1.5.1](https://github.com/growsurf/growsurf-python/compare/v1.5.0...v1.5.1) (2026-09-10)
+
+
+### Chores
+
+* merge main (release 1.5.0) into dev ([1bc5ac8](https://github.com/growsurf/growsurf-python/commit/1bc5ac8dd57d1f6ab8ab168eb313365ab7e9d785))
+
+
+### Documentation
+
+* **api:** warn that a new account API key cannot be recovered ([f068cb8](https://github.com/growsurf/growsurf-python/commit/f068cb81afffb6b99451a9f416eb743c2eba3a8f))
+
 ## [1.5.0](https://github.com/growsurf/growsurf-python/compare/v1.4.0...v1.5.0) (2026-09-10)
 
 

{growsurf_python-1.5.0 → growsurf_python-1.6.0}/PKG-INFO

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

{growsurf_python-1.5.0 → growsurf_python-1.6.0}/pyproject.toml

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

{growsurf_python-1.5.0 → growsurf_python-1.6.0}/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.5.0"  # x-release-please-version
+__version__ = "1.6.0"  # x-release-please-version

{growsurf_python-1.5.0 → growsurf_python-1.6.0}/src/growsurf/resources/account.py

@@ -47,26 +47,27 @@ class AccountResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> CreateAccountResponse:
         """
-        Creates a new GrowSurf account. This is the only endpoint that does not require
-        an API key. Before calling it, an authorized account owner must review and
-        approve GrowSurf's [Terms of Service](https://growsurf.com/terms) and [Privacy
-        Policy](https://growsurf.com/privacy). The account starts a 14-day Business
-        trial without a credit card. The response includes an API key for the new
-        account, shown once in the response. The key is a secret: store it in a secret
-        manager and do not put it in logs, screenshots, URLs, model context, analytics,
-        or generated output. The key is locked until the team owner's email address is
-        verified: authenticated program and resource endpoints return a `403` with error
-        code `EMAIL_NOT_VERIFIED_ERROR` until then (resend the email via `POST
-        /team/owner/verification-email`, then retry). Verification unlocks this same key
-        - keep it and retry rather than requesting a replacement. A welcome email is
-        sent to the address with the verification link and a set-password link for
-        dashboard access. Accounts whose email is never verified are deleted
-        automatically after 7 days. Separately, for security, the API key is replaced
-        the first time the account owner signs in to the GrowSurf dashboard; email
-        verification does not trigger that, and the previous key then returns a `403`
-        with error code `NOT_AUTHORIZED_ERROR`. Some actions (such as emailing participants)
-        additionally require GrowSurf to verify the team first. Calling this endpoint
-        accepts those policies on the account holder's behalf.
+        Creates a new GrowSurf account. This is the only endpoint that does not require an API key.
+        Before calling it, an authorized account owner must review and approve GrowSurf's [Terms of
+        Service](https://growsurf.com/terms) and [Privacy Policy](https://growsurf.com/privacy). The
+        account starts a 14-day Business trial without a credit card. The response includes an API
+        key for the new account, shown once in the response. The key is a secret: store it in a
+        secret manager and do not put it in logs, screenshots, URLs, model context, analytics, or
+        generated output. A lost key cannot be recovered through this API, so do not create an
+        account here unless you can store the key somewhere that outlives the current conversation.
+        If you cannot, ask the account owner to connect GrowSurf's hosted MCP server at
+        `https://mcp.growsurf.com` instead, which keeps the credential with your tool rather than in
+        chat. The key is locked until the team owner's email address is verified: authenticated
+        program and resource endpoints return a `403` with error code `EMAIL_NOT_VERIFIED_ERROR`
+        until then (resend the email via `POST /team/owner/verification-email`, then retry).
+        Verification unlocks this same key - keep it and retry rather than requesting a replacement.
+        A welcome email is sent to the address with the verification link and a set-password link
+        for dashboard access. Accounts whose email is never verified are deleted automatically after
+        7 days. Separately, for security, the API key is replaced the first time the account owner
+        signs in to the GrowSurf dashboard; email verification does not trigger that, and the
+        previous key then returns a `403` with error code `NOT_AUTHORIZED_ERROR`. Some actions (such
+        as emailing participants) additionally require GrowSurf to verify the team first. Calling
+        this endpoint accepts those policies on the account holder's behalf.
 
         Args:
           email: The email address for the new GrowSurf account. Personal emails and disposable email addresses are not accepted.
@@ -133,26 +134,27 @@ class AsyncAccountResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> CreateAccountResponse:
         """
-        Creates a new GrowSurf account. This is the only endpoint that does not require
-        an API key. Before calling it, an authorized account owner must review and
-        approve GrowSurf's [Terms of Service](https://growsurf.com/terms) and [Privacy
-        Policy](https://growsurf.com/privacy). The account starts a 14-day Business
-        trial without a credit card. The response includes an API key for the new
-        account, shown once in the response. The key is a secret: store it in a secret
-        manager and do not put it in logs, screenshots, URLs, model context, analytics,
-        or generated output. The key is locked until the team owner's email address is
-        verified: authenticated program and resource endpoints return a `403` with error
-        code `EMAIL_NOT_VERIFIED_ERROR` until then (resend the email via `POST
-        /team/owner/verification-email`, then retry). Verification unlocks this same key
-        - keep it and retry rather than requesting a replacement. A welcome email is
-        sent to the address with the verification link and a set-password link for
-        dashboard access. Accounts whose email is never verified are deleted
-        automatically after 7 days. Separately, for security, the API key is replaced
-        the first time the account owner signs in to the GrowSurf dashboard; email
-        verification does not trigger that, and the previous key then returns a `403`
-        with error code `NOT_AUTHORIZED_ERROR`. Some actions (such as emailing participants)
-        additionally require GrowSurf to verify the team first. Calling this endpoint
-        accepts those policies on the account holder's behalf.
+        Creates a new GrowSurf account. This is the only endpoint that does not require an API key.
+        Before calling it, an authorized account owner must review and approve GrowSurf's [Terms of
+        Service](https://growsurf.com/terms) and [Privacy Policy](https://growsurf.com/privacy). The
+        account starts a 14-day Business trial without a credit card. The response includes an API
+        key for the new account, shown once in the response. The key is a secret: store it in a
+        secret manager and do not put it in logs, screenshots, URLs, model context, analytics, or
+        generated output. A lost key cannot be recovered through this API, so do not create an
+        account here unless you can store the key somewhere that outlives the current conversation.
+        If you cannot, ask the account owner to connect GrowSurf's hosted MCP server at
+        `https://mcp.growsurf.com` instead, which keeps the credential with your tool rather than in
+        chat. The key is locked until the team owner's email address is verified: authenticated
+        program and resource endpoints return a `403` with error code `EMAIL_NOT_VERIFIED_ERROR`
+        until then (resend the email via `POST /team/owner/verification-email`, then retry).
+        Verification unlocks this same key - keep it and retry rather than requesting a replacement.
+        A welcome email is sent to the address with the verification link and a set-password link
+        for dashboard access. Accounts whose email is never verified are deleted automatically after
+        7 days. Separately, for security, the API key is replaced the first time the account owner
+        signs in to the GrowSurf dashboard; email verification does not trigger that, and the
+        previous key then returns a `403` with error code `NOT_AUTHORIZED_ERROR`. Some actions (such
+        as emailing participants) additionally require GrowSurf to verify the team first. Calling
+        this endpoint accepts those policies on the account holder's behalf.
 
         Args:
           email: The email address for the new GrowSurf account. Personal emails and disposable email addresses are not accepted.

{growsurf_python-1.5.0 → growsurf_python-1.6.0}/src/growsurf/types/campaign/__init__.py

@@ -39,6 +39,7 @@ from .reward_fulfill_response import RewardFulfillResponse as RewardFulfillRespo
 from .participant_email_params import ParticipantEmailParams as ParticipantEmailParams
 from .integration_list_response import IntegrationListResponse as IntegrationListResponse
 from .participant_update_params import ParticipantUpdateParams as ParticipantUpdateParams
+from .pending_analytics_erasure import PendingAnalyticsErasure as PendingAnalyticsErasure
 from .commission_delete_response import CommissionDeleteResponse as CommissionDeleteResponse
 from .email_participant_response import EmailParticipantResponse as EmailParticipantResponse
 from .commission_approve_response import CommissionApproveResponse as CommissionApproveResponse

{growsurf_python-1.5.0 → growsurf_python-1.6.0}/src/growsurf/types/campaign/participant_bulk_delete_response.py

@@ -6,6 +6,7 @@ from typing_extensions import Literal
 from pydantic import Field as FieldInfo
 
 from ..._models import BaseModel
+from .pending_analytics_erasure import PendingAnalyticsErasure
 
 __all__ = ["ParticipantBulkDeleteResponse", "Result", "Summary"]
 
@@ -57,6 +58,9 @@ class Summary(BaseModel):
 
 
 class ParticipantBulkDeleteResponse(BaseModel):
+    analytics_erasure: Optional[PendingAnalyticsErasure] = FieldInfo(alias="analyticsErasure", default=None)
+    """Analytics erasure is pending. Reports can retain removed participants until erasure completes. Do not repeat successful deletions."""
+
     results: List[Result]
     """One entry per submitted identifier, in the same order as the request."""
 

growsurf_python-1.6.0/src/growsurf/types/campaign/participant_delete_response.py

@@ -0,0 +1,17 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from pydantic import Field as FieldInfo
+
+from ..._models import BaseModel
+from .pending_analytics_erasure import PendingAnalyticsErasure
+
+__all__ = ["ParticipantDeleteResponse"]
+
+
+class ParticipantDeleteResponse(BaseModel):
+    analytics_erasure: Optional[PendingAnalyticsErasure] = FieldInfo(alias="analyticsErasure", default=None)
+    """Analytics erasure is pending. Reports can retain removed participants until erasure completes. Do not repeat successful deletions."""
+
+    success: bool

growsurf_python-1.6.0/src/growsurf/types/campaign/pending_analytics_erasure.py

@@ -0,0 +1,15 @@
+from typing_extensions import Literal
+
+from pydantic import Field as FieldInfo
+
+from ..._models import BaseModel
+
+__all__ = ["PendingAnalyticsErasure"]
+
+
+class PendingAnalyticsErasure(BaseModel):
+    status: Literal["pending"]
+    """Analytics erasure has been accepted but is not confirmed complete."""
+
+    operation_id: str = FieldInfo(alias="operationId")
+    """Opaque reference for support inquiries about this analytics erasure."""

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

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

growsurf_python-1.5.0/src/growsurf/types/campaign/participant_delete_response.py

@@ -1,9 +0,0 @@
-# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-from ..._models import BaseModel
-
-__all__ = ["ParticipantDeleteResponse"]
-
-
-class ParticipantDeleteResponse(BaseModel):
-    success: bool