release: 0.26.0

.github/workflows/ci.yml

@@ -21,10 +21,10 @@ jobs:
     runs-on: ${{ github.repository == 'stainless-sdks/sent-dm-python' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     if: (github.event_name == 'push' || github.event.pull_request.head.repo.fork) && (github.event_name != 'push' || github.event.head_commit.message != 'codegen metadata')
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v5
+        uses: astral-sh/setup-uv@d4b2f3b6ecc6e67c4457f6d3e41ec42d3d0fcb86 # v5.4.2
         with:
           version: '0.10.2'
 
@@ -43,10 +43,10 @@ jobs:
       id-token: write
     runs-on: ${{ github.repository == 'stainless-sdks/sent-dm-python' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v5
+        uses: astral-sh/setup-uv@d4b2f3b6ecc6e67c4457f6d3e41ec42d3d0fcb86 # v5.4.2
         with:
           version: '0.10.2'
 
@@ -61,7 +61,7 @@ jobs:
           github.repository == 'stainless-sdks/sent-dm-python' &&
           !startsWith(github.ref, 'refs/heads/stl/')
         id: github-oidc
-        uses: actions/github-script@v8
+        uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8.0.0
         with:
           script: core.setOutput('github_token', await core.getIDToken());
 
@@ -81,10 +81,10 @@ jobs:
     runs-on: ${{ github.repository == 'stainless-sdks/sent-dm-python' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v5
+        uses: astral-sh/setup-uv@d4b2f3b6ecc6e67c4457f6d3e41ec42d3d0fcb86 # v5.4.2
         with:
           version: '0.10.2'
 

.github/workflows/publish-pypi.yml

@@ -17,10 +17,10 @@ jobs:
       id-token: write
 
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v5
+        uses: astral-sh/setup-uv@d4b2f3b6ecc6e67c4457f6d3e41ec42d3d0fcb86 # v5.4.2
         with:
           version: '0.9.13'
 

.github/workflows/release-doctor.yml

@@ -12,7 +12,7 @@ jobs:
     if: github.repository == 'sentdm/sent-dm-python' && (github.event_name == 'push' || github.event_name == 'workflow_dispatch' || startsWith(github.head_ref, 'release-please') || github.head_ref == 'next')
 
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Check release environment
         run: |

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.25.0"
+  ".": "0.26.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 40
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/sent/sent-dm-cd3602173bd6a0a9492974a8541e246b36758015cb5f3e214b4abec90f3f9306.yml
-openapi_spec_hash: 4d6829284030da47b715b4f5557167db
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/sent/sent-dm-f11b6b07e154570d2c9298e1a196f6a17d1459b87c1c9f836d476e1876e8bbe5.yml
+openapi_spec_hash: 969f82ebb2d5e6be2af05c56c4dea585
 config_hash: 7fe4b7f38470a511342b783de698aa99

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.26.0 (2026-05-14)
+
+Full Changelog: [v0.25.0...v0.26.0](https://github.com/sentdm/sent-dm-python/compare/v0.25.0...v0.26.0)
+
+### Features
+
+* **api:** api update ([7d5b0b4](https://github.com/sentdm/sent-dm-python/commit/7d5b0b48d8bc5743269603ffa0bddec5aa8a8814))
+
 ## 0.25.0 (2026-05-12)
 
 Full Changelog: [v0.24.1...v0.25.0](https://github.com/sentdm/sent-dm-python/compare/v0.24.1...v0.25.0)

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "sentdm"
-version = "0.25.0"
+version = "0.26.0"
 description = "The official Python library for the Sent API"
 dynamic = ["readme"]
 license = "Apache-2.0"

src/sent_dm/_version.py

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

src/sent_dm/resources/contacts.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Dict, Optional
+from typing import Optional
 
 import httpx
 
@@ -19,7 +19,9 @@
 )
 from .._base_client import make_request_options
 from ..types.contact_list_response import ContactListResponse
-from ..types.api_response_of_contact import APIResponseOfContact
+from ..types.contact_create_response import ContactCreateResponse
+from ..types.contact_update_response import ContactUpdateResponse
+from ..types.contact_retrieve_response import ContactRetrieveResponse
 
 __all__ = ["ContactsResource", "AsyncContactsResource"]
 
@@ -59,7 +61,7 @@ def create(
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> APIResponseOfContact:
+    ) -> ContactCreateResponse:
         """
         Creates a new contact by phone number and associates it with the authenticated
         customer.
@@ -99,7 +101,7 @@ def create(
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=APIResponseOfContact,
+            cast_to=ContactCreateResponse,
         )
 
     def retrieve(
@@ -113,7 +115,7 @@ def retrieve(
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> APIResponseOfContact:
+    ) -> ContactRetrieveResponse:
         """Retrieves a specific contact by their unique identifier.
 
         Returns detailed
@@ -137,14 +139,13 @@ def retrieve(
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=APIResponseOfContact,
+            cast_to=ContactRetrieveResponse,
         )
 
     def update(
         self,
         id: str,
         *,
-        channel_consent: Optional[Dict[str, str]] | Omit = omit,
         default_channel: Optional[str] | Omit = omit,
         opt_out: Optional[bool] | Omit = omit,
         sandbox: bool | Omit = omit,
@@ -156,23 +157,17 @@ def update(
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> APIResponseOfContact:
+    ) -> ContactUpdateResponse:
         """Updates a contact's default channel and/or opt-out status.
 
         Inherited contacts
         cannot be updated.
 
         Args:
-          channel_consent: Consent status by channel. Keys: "sms", "whatsapp". Values: "opted_in",
-              "opted_out". All entries must have the same status — mixed values (e.g., sms:
-              opted_out + whatsapp: opted_in) are rejected with 400. The provided status is
-              applied to ALL channels regardless of which keys are specified, because consent
-              is global across channels. When provided, takes precedence over the opt_out
-              field.
-
           default_channel: Default messaging channel: "sms" or "whatsapp"
 
-          opt_out: Whether the contact has opted out of messaging
+          opt_out: Whether the contact has opted out of messaging. Single source of truth — opt-out
+              is per-contact, not per-channel.
 
           sandbox: Sandbox flag - when true, the operation is simulated without side effects Useful
               for testing integrations without actual execution
@@ -200,7 +195,6 @@ def update(
             path_template("/v3/contacts/{id}", id=id),
             body=maybe_transform(
                 {
-                    "channel_consent": channel_consent,
                     "default_channel": default_channel,
                     "opt_out": opt_out,
                     "sandbox": sandbox,
@@ -210,7 +204,7 @@ def update(
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=APIResponseOfContact,
+            cast_to=ContactUpdateResponse,
         )
 
     def list(
@@ -354,7 +348,7 @@ async def create(
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> APIResponseOfContact:
+    ) -> ContactCreateResponse:
         """
         Creates a new contact by phone number and associates it with the authenticated
         customer.
@@ -394,7 +388,7 @@ async def create(
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=APIResponseOfContact,
+            cast_to=ContactCreateResponse,
         )
 
     async def retrieve(
@@ -408,7 +402,7 @@ async def retrieve(
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> APIResponseOfContact:
+    ) -> ContactRetrieveResponse:
         """Retrieves a specific contact by their unique identifier.
 
         Returns detailed
@@ -432,14 +426,13 @@ async def retrieve(
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=APIResponseOfContact,
+            cast_to=ContactRetrieveResponse,
         )
 
     async def update(
         self,
         id: str,
         *,
-        channel_consent: Optional[Dict[str, str]] | Omit = omit,
         default_channel: Optional[str] | Omit = omit,
         opt_out: Optional[bool] | Omit = omit,
         sandbox: bool | Omit = omit,
@@ -451,23 +444,17 @@ async def update(
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> APIResponseOfContact:
+    ) -> ContactUpdateResponse:
         """Updates a contact's default channel and/or opt-out status.
 
         Inherited contacts
         cannot be updated.
 
         Args:
-          channel_consent: Consent status by channel. Keys: "sms", "whatsapp". Values: "opted_in",
-              "opted_out". All entries must have the same status — mixed values (e.g., sms:
-              opted_out + whatsapp: opted_in) are rejected with 400. The provided status is
-              applied to ALL channels regardless of which keys are specified, because consent
-              is global across channels. When provided, takes precedence over the opt_out
-              field.
-
           default_channel: Default messaging channel: "sms" or "whatsapp"
 
-          opt_out: Whether the contact has opted out of messaging
+          opt_out: Whether the contact has opted out of messaging. Single source of truth — opt-out
+              is per-contact, not per-channel.
 
           sandbox: Sandbox flag - when true, the operation is simulated without side effects Useful
               for testing integrations without actual execution
@@ -495,7 +482,6 @@ async def update(
             path_template("/v3/contacts/{id}", id=id),
             body=await async_maybe_transform(
                 {
-                    "channel_consent": channel_consent,
                     "default_channel": default_channel,
                     "opt_out": opt_out,
                     "sandbox": sandbox,
@@ -505,7 +491,7 @@ async def update(
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=APIResponseOfContact,
+            cast_to=ContactUpdateResponse,
         )
 
     async def list(

src/sent_dm/resources/messages.py

@@ -147,8 +147,8 @@ def send(
 
         Args:
           channel: Channels to broadcast on, e.g. ["whatsapp", "sms"]. Each channel produces a
-              separate message per recipient. "sent" = auto-detect, "rcs" = reserved
-              (skipped). Defaults to ["sent"] (auto-detect) if omitted.
+              separate message per recipient. "sent" = auto-detect. Defaults to ["sent"]
+              (auto-detect) if omitted.
 
           sandbox: Sandbox flag - when true, the operation is simulated without side effects Useful
               for testing integrations without actual execution
@@ -315,8 +315,8 @@ async def send(
 
         Args:
           channel: Channels to broadcast on, e.g. ["whatsapp", "sms"]. Each channel produces a
-              separate message per recipient. "sent" = auto-detect, "rcs" = reserved
-              (skipped). Defaults to ["sent"] (auto-detect) if omitted.
+              separate message per recipient. "sent" = auto-detect. Defaults to ["sent"]
+              (auto-detect) if omitted.
 
           sandbox: Sandbox flag - when true, the operation is simulated without side effects Useful
               for testing integrations without actual execution