linq-python 0.41.1__tar.gz → 0.42.0__tar.gz

linq_python-0.42.0/.release-please-manifest.json

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

{linq_python-0.41.1 → linq_python-0.42.0}/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.42.0](https://github.com/linq-team/linq-python/compare/v0.41.2...v0.42.0) (2026-09-02)
+
+
+### Features
+
+* add webhook events for connections, location sharing, and payments ([1ebce1a](https://github.com/linq-team/linq-python/commit/1ebce1a87a0bf9f93559fcfbc250694753bfa01b))
+
+## [0.41.2](https://github.com/linq-team/linq-python/compare/v0.41.1...v0.41.2) (2026-09-02)
+
+
+### Bug Fixes
+
+* clarify ephemeral message retention behavior and metadata handling ([e3c6d03](https://github.com/linq-team/linq-python/commit/e3c6d038c92e3e00ac0b5b20dfae917164e9f89b))
+
 ## [0.41.1](https://github.com/linq-team/linq-python/compare/v0.41.0...v0.41.1) (2026-09-01)
 
 

{linq_python-0.41.1 → linq_python-0.42.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: linq-python
-Version: 0.41.1
+Version: 0.42.0
 Summary: The official Python library for the linq-api-v3 API
 Project-URL: Homepage, https://github.com/linq-team/linq-python
 Project-URL: Repository, https://github.com/linq-team/linq-python

{linq_python-0.41.1 → linq_python-0.42.0}/api.md

@@ -338,19 +338,6 @@ Methods:
 - <code title="get /v3/webhook-subscriptions">client.webhook_subscriptions.<a href="./src/linq/resources/webhook_subscriptions.py">list</a>() -> <a href="./src/linq/types/webhook_subscription_list_response.py">WebhookSubscriptionListResponse</a></code>
 - <code title="delete /v3/webhook-subscriptions/{subscriptionId}">client.webhook_subscriptions.<a href="./src/linq/resources/webhook_subscriptions.py">delete</a>(subscription_id) -> None</code>
 
-# Capability
-
-Types:
-
-```python
-from linq.types import HandleCheck, HandleCheckResponse
-```
-
-Methods:
-
-- <code title="post /v3/capability/check_imessage">client.capability.<a href="./src/linq/resources/capability.py">check_i_message</a>(\*\*<a href="src/linq/types/capability_check_i_message_params.py">params</a>) -> <a href="./src/linq/types/handle_check_response.py">HandleCheckResponse</a></code>
-- <code title="post /v3/capability/check_rcs">client.capability.<a href="./src/linq/resources/capability.py">check_RCS</a>(\*\*<a href="src/linq/types/capability_check_RCS_params.py">params</a>) -> <a href="./src/linq/types/handle_check_response.py">HandleCheckResponse</a></code>
-
 # Webhooks
 
 Types:
@@ -393,10 +380,32 @@ from linq.types import (
     ChatBackgroundUpdateFailedWebhookEvent,
     ContactCardReceivedWebhookEvent,
     PhoneNumberStatusUpdatedWebhookEvent,
+    ConnectionCreatedWebhookEvent,
+    ConnectionRevokedWebhookEvent,
+    LocationSharingStartedWebhookEvent,
+    LocationSharingStoppedWebhookEvent,
+    PaymentAuthorizedWebhookEvent,
+    PaymentCanceledWebhookEvent,
+    PaymentDeclinedWebhookEvent,
+    PaymentExpiredWebhookEvent,
+    PaymentSucceededWebhookEvent,
     UnwrapWebhookEvent,
 )
 ```
 
+# Capability
+
+Types:
+
+```python
+from linq.types import HandleCheck, HandleCheckResponse
+```
+
+Methods:
+
+- <code title="post /v3/capability/check_imessage">client.capability.<a href="./src/linq/resources/capability.py">check_i_message</a>(\*\*<a href="src/linq/types/capability_check_i_message_params.py">params</a>) -> <a href="./src/linq/types/handle_check_response.py">HandleCheckResponse</a></code>
+- <code title="post /v3/capability/check_rcs">client.capability.<a href="./src/linq/resources/capability.py">check_RCS</a>(\*\*<a href="src/linq/types/capability_check_RCS_params.py">params</a>) -> <a href="./src/linq/types/handle_check_response.py">HandleCheckResponse</a></code>
+
 # ContactCard
 
 Types:

{linq_python-0.41.1 → linq_python-0.42.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "linq-python"
-version = "0.41.1"
+version = "0.42.0"
 description = "The official Python library for the linq-api-v3 API"
 dynamic = ["readme"]
 license = "Apache-2.0"

{linq_python-0.41.1 → linq_python-0.42.0}/src/linq/_client.py

@@ -186,7 +186,7 @@ class LinqAPIV3(SyncAPIClient):
 
         ## Ephemeral Messages (Privacy Tier)
 
-        For regulated or sensitive conversations, opt in to the **ephemeral messages** tier by contacting your Linq support contact. When enabled, every message on the covered phone numbers is given a **retention window configured for your account** — after that window the platform permanently deletes the message from Linq storage. There is no per-message flag; ephemerality is applied automatically based on your configuration.
+        For regulated or sensitive conversations, opt in to the **ephemeral messages** tier by contacting your Linq support contact. When enabled, every message on the covered phone numbers is given a **retention window configured for your account**. After that window, the message's text, formatting, and attachment references are no longer retrievable through the API — see the Attachments row below for how the attachment media itself is handled. Metadata about the message is retained: message identifiers, timestamps, phone numbers, and delivery state. Metadata retention is not bounded by this window. Bounded operational copies, such as backups and delivery queues, expire on their own separate schedules. There is no per-message flag; ephemerality is applied automatically based on your configuration.
 
         The window can be set anywhere from **60 minutes to 24 hours**, and defaults to **24 hours**. Ask your Linq support contact to configure a shorter window; it cannot be changed through the API.
 
@@ -194,16 +194,16 @@ class LinqAPIV3(SyncAPIClient):
 
         | Scope | Effect |
         |---|---|
-        | **Partner-wide** | Every outbound and inbound message on every phone number under your account is retained for your configured window, then deleted. |
-        | **Per phone number** | Only the specified phone numbers have their messages auto-deleted. The rest follow the standard message-retention policy. |
+        | **Partner-wide** | Every outbound and inbound message on every phone number under your account has its content removed from the API surface after your configured window. Metadata is retained. |
+        | **Per phone number** | Only the specified phone numbers have message content removed from the API surface this way. The rest follow the standard message-retention policy. |
 
         **Behavioral differences vs the standard default:**
 
         | Aspect | Standard | Ephemeral |
         |---|---|---|
         | Retention | Retained per the standard message-retention policy | **Hard backstop: your configured window** (60 minutes – 24 hours, default 24 hours) from when the message is created |
-        | After expiry | Message stays retrievable | Message is permanently deleted — `GET /v3/messages/{messageId}` returns `404` and it no longer appears in `GET /v3/chats/{chatId}/messages` |
-        | Content on expiry | N/A | Text, formatting, and attachment references are scrubbed; the message is gone, not blanked out |
+        | After expiry | Message stays retrievable | Message content is no longer retrievable — `GET /v3/messages/{messageId}` returns `404` and it no longer appears in `GET /v3/chats/{chatId}/messages` |
+        | Content on expiry | N/A | Text, formatting, and attachment references are removed from the API surface, not blanked out in place. Metadata (identifiers, timestamps, phone numbers, delivery state) is retained; its retention is not bounded by this window |
         | Attachments | Retained | Media sent on the **ephemeral attachments tier** is removed on its own storage backstop — within roughly 24–48 hours of upload — independently of the message window, so it can outlast a window shorter than a day. Attachments on the persistent tier (including pre-uploads via `POST /v3/attachments`) are kept until you `DELETE` them |
         | Cross-partner isolation | Enforced | Enforced |
 
@@ -218,7 +218,7 @@ class LinqAPIV3(SyncAPIClient):
 
         - **No expiry timestamp is exposed.** API responses and webhook payloads do not include the deletion time, and they do not report your configured window either — so if you are on a window shorter than 24 hours you cannot derive a message's expiry from the API today. Track the window you agreed with your Linq support contact and compute `created_at + window` yourself.
         - **No deletion webhook is sent.** There is no `message.deleted` event — a message simply stops being retrievable once its window passes.
-        - **The backstop governs Linq storage.** API retrievability (the `404` behavior above) ends at your configured window. Ephemeral-tier media objects are removed on their own storage backstop — within roughly 24–48 hours of upload — which is independent of the message window and can outlast a window shorter than a day. Removal of the corresponding entries from the sending device happens asynchronously and can complete after the backstop.
+        - **The attachment backstop is separate from the message window.** API retrievability (the `404` behavior above) ends at your configured window. Ephemeral-tier media objects are removed on their own storage backstop — within roughly 24–48 hours of upload — which is independent of the message window and can outlast a window shorter than a day. Removal of the corresponding entries from the sending device happens asynchronously and can complete after the backstop.
         - **Delivery is unaffected.** Ephemeral messages send, deliver, and fire the usual `message.sent` / `message.received` and status webhooks exactly like standard messages. Only retention changes.
 
         **When to choose ephemeral:**
@@ -414,7 +414,7 @@ class LinqAPIV3(SyncAPIClient):
         |---|---|---|
         | Attachment bytes | Retained until you `DELETE` | **Auto-removed within roughly 24–48 hours** of upload, independently of any message window. Also removable via `DELETE` |
         | Attachment metadata (id, filename, mime type, size) | Retained until you `DELETE` | Removed alongside the bytes |
-        | Message body & parts | Retained per message-retention policy | Retained per message-retention policy — unless the line also has **ephemeral messages** enabled (see the Messages page), in which case the message and its parts are deleted after that account's configured retention window (60 minutes – 24 hours, default 24 hours) from creation |
+        | Message body & parts | Retained per message-retention policy | Retained per message-retention policy — unless the line also has **ephemeral messages** enabled (see the Messages page), in which case the message's text, formatting, and attachment references are no longer retrievable through the API after that account's configured retention window (60 minutes – 24 hours, default 24 hours) from creation. Metadata is retained; see the Messages page for details |
         | Audit log of deletions | Retained per platform retention policy | Retained per platform retention policy |
 
         **In transit:** TLS 1.2+ everywhere. **At rest:** AES-256 (server-side encryption).
@@ -1067,6 +1067,12 @@ class LinqAPIV3(SyncAPIClient):
 
         return WebhookSubscriptionsResource(self)
 
+    @cached_property
+    def webhooks(self) -> WebhooksResource:
+        from .resources.webhooks import WebhooksResource
+
+        return WebhooksResource(self)
+
     @cached_property
     def capability(self) -> CapabilityResource:
         """
@@ -1076,12 +1082,6 @@ class LinqAPIV3(SyncAPIClient):
 
         return CapabilityResource(self)
 
-    @cached_property
-    def webhooks(self) -> WebhooksResource:
-        from .resources.webhooks import WebhooksResource
-
-        return WebhooksResource(self)
-
     @cached_property
     def contact_card(self) -> ContactCardResource:
         """
@@ -1321,7 +1321,7 @@ class AsyncLinqAPIV3(AsyncAPIClient):
 
         ## Ephemeral Messages (Privacy Tier)
 
-        For regulated or sensitive conversations, opt in to the **ephemeral messages** tier by contacting your Linq support contact. When enabled, every message on the covered phone numbers is given a **retention window configured for your account** — after that window the platform permanently deletes the message from Linq storage. There is no per-message flag; ephemerality is applied automatically based on your configuration.
+        For regulated or sensitive conversations, opt in to the **ephemeral messages** tier by contacting your Linq support contact. When enabled, every message on the covered phone numbers is given a **retention window configured for your account**. After that window, the message's text, formatting, and attachment references are no longer retrievable through the API — see the Attachments row below for how the attachment media itself is handled. Metadata about the message is retained: message identifiers, timestamps, phone numbers, and delivery state. Metadata retention is not bounded by this window. Bounded operational copies, such as backups and delivery queues, expire on their own separate schedules. There is no per-message flag; ephemerality is applied automatically based on your configuration.
 
         The window can be set anywhere from **60 minutes to 24 hours**, and defaults to **24 hours**. Ask your Linq support contact to configure a shorter window; it cannot be changed through the API.
 
@@ -1329,16 +1329,16 @@ class AsyncLinqAPIV3(AsyncAPIClient):
 
         | Scope | Effect |
         |---|---|
-        | **Partner-wide** | Every outbound and inbound message on every phone number under your account is retained for your configured window, then deleted. |
-        | **Per phone number** | Only the specified phone numbers have their messages auto-deleted. The rest follow the standard message-retention policy. |
+        | **Partner-wide** | Every outbound and inbound message on every phone number under your account has its content removed from the API surface after your configured window. Metadata is retained. |
+        | **Per phone number** | Only the specified phone numbers have message content removed from the API surface this way. The rest follow the standard message-retention policy. |
 
         **Behavioral differences vs the standard default:**
 
         | Aspect | Standard | Ephemeral |
         |---|---|---|
         | Retention | Retained per the standard message-retention policy | **Hard backstop: your configured window** (60 minutes – 24 hours, default 24 hours) from when the message is created |
-        | After expiry | Message stays retrievable | Message is permanently deleted — `GET /v3/messages/{messageId}` returns `404` and it no longer appears in `GET /v3/chats/{chatId}/messages` |
-        | Content on expiry | N/A | Text, formatting, and attachment references are scrubbed; the message is gone, not blanked out |
+        | After expiry | Message stays retrievable | Message content is no longer retrievable — `GET /v3/messages/{messageId}` returns `404` and it no longer appears in `GET /v3/chats/{chatId}/messages` |
+        | Content on expiry | N/A | Text, formatting, and attachment references are removed from the API surface, not blanked out in place. Metadata (identifiers, timestamps, phone numbers, delivery state) is retained; its retention is not bounded by this window |
         | Attachments | Retained | Media sent on the **ephemeral attachments tier** is removed on its own storage backstop — within roughly 24–48 hours of upload — independently of the message window, so it can outlast a window shorter than a day. Attachments on the persistent tier (including pre-uploads via `POST /v3/attachments`) are kept until you `DELETE` them |
         | Cross-partner isolation | Enforced | Enforced |
 
@@ -1353,7 +1353,7 @@ class AsyncLinqAPIV3(AsyncAPIClient):
 
         - **No expiry timestamp is exposed.** API responses and webhook payloads do not include the deletion time, and they do not report your configured window either — so if you are on a window shorter than 24 hours you cannot derive a message's expiry from the API today. Track the window you agreed with your Linq support contact and compute `created_at + window` yourself.
         - **No deletion webhook is sent.** There is no `message.deleted` event — a message simply stops being retrievable once its window passes.
-        - **The backstop governs Linq storage.** API retrievability (the `404` behavior above) ends at your configured window. Ephemeral-tier media objects are removed on their own storage backstop — within roughly 24–48 hours of upload — which is independent of the message window and can outlast a window shorter than a day. Removal of the corresponding entries from the sending device happens asynchronously and can complete after the backstop.
+        - **The attachment backstop is separate from the message window.** API retrievability (the `404` behavior above) ends at your configured window. Ephemeral-tier media objects are removed on their own storage backstop — within roughly 24–48 hours of upload — which is independent of the message window and can outlast a window shorter than a day. Removal of the corresponding entries from the sending device happens asynchronously and can complete after the backstop.
         - **Delivery is unaffected.** Ephemeral messages send, deliver, and fire the usual `message.sent` / `message.received` and status webhooks exactly like standard messages. Only retention changes.
 
         **When to choose ephemeral:**
@@ -1549,7 +1549,7 @@ class AsyncLinqAPIV3(AsyncAPIClient):
         |---|---|---|
         | Attachment bytes | Retained until you `DELETE` | **Auto-removed within roughly 24–48 hours** of upload, independently of any message window. Also removable via `DELETE` |
         | Attachment metadata (id, filename, mime type, size) | Retained until you `DELETE` | Removed alongside the bytes |
-        | Message body & parts | Retained per message-retention policy | Retained per message-retention policy — unless the line also has **ephemeral messages** enabled (see the Messages page), in which case the message and its parts are deleted after that account's configured retention window (60 minutes – 24 hours, default 24 hours) from creation |
+        | Message body & parts | Retained per message-retention policy | Retained per message-retention policy — unless the line also has **ephemeral messages** enabled (see the Messages page), in which case the message's text, formatting, and attachment references are no longer retrievable through the API after that account's configured retention window (60 minutes – 24 hours, default 24 hours) from creation. Metadata is retained; see the Messages page for details |
         | Audit log of deletions | Retained per platform retention policy | Retained per platform retention policy |
 
         **In transit:** TLS 1.2+ everywhere. **At rest:** AES-256 (server-side encryption).
@@ -2202,6 +2202,12 @@ class AsyncLinqAPIV3(AsyncAPIClient):
 
         return AsyncWebhookSubscriptionsResource(self)
 
+    @cached_property
+    def webhooks(self) -> AsyncWebhooksResource:
+        from .resources.webhooks import AsyncWebhooksResource
+
+        return AsyncWebhooksResource(self)
+
     @cached_property
     def capability(self) -> AsyncCapabilityResource:
         """
@@ -2211,12 +2217,6 @@ class AsyncLinqAPIV3(AsyncAPIClient):
 
         return AsyncCapabilityResource(self)
 
-    @cached_property
-    def webhooks(self) -> AsyncWebhooksResource:
-        from .resources.webhooks import AsyncWebhooksResource
-
-        return AsyncWebhooksResource(self)
-
     @cached_property
     def contact_card(self) -> AsyncContactCardResource:
         """
@@ -2390,7 +2390,7 @@ class LinqAPIV3WithRawResponse:
 
         ## Ephemeral Messages (Privacy Tier)
 
-        For regulated or sensitive conversations, opt in to the **ephemeral messages** tier by contacting your Linq support contact. When enabled, every message on the covered phone numbers is given a **retention window configured for your account** — after that window the platform permanently deletes the message from Linq storage. There is no per-message flag; ephemerality is applied automatically based on your configuration.
+        For regulated or sensitive conversations, opt in to the **ephemeral messages** tier by contacting your Linq support contact. When enabled, every message on the covered phone numbers is given a **retention window configured for your account**. After that window, the message's text, formatting, and attachment references are no longer retrievable through the API — see the Attachments row below for how the attachment media itself is handled. Metadata about the message is retained: message identifiers, timestamps, phone numbers, and delivery state. Metadata retention is not bounded by this window. Bounded operational copies, such as backups and delivery queues, expire on their own separate schedules. There is no per-message flag; ephemerality is applied automatically based on your configuration.
 
         The window can be set anywhere from **60 minutes to 24 hours**, and defaults to **24 hours**. Ask your Linq support contact to configure a shorter window; it cannot be changed through the API.
 
@@ -2398,16 +2398,16 @@ class LinqAPIV3WithRawResponse:
 
         | Scope | Effect |
         |---|---|
-        | **Partner-wide** | Every outbound and inbound message on every phone number under your account is retained for your configured window, then deleted. |
-        | **Per phone number** | Only the specified phone numbers have their messages auto-deleted. The rest follow the standard message-retention policy. |
+        | **Partner-wide** | Every outbound and inbound message on every phone number under your account has its content removed from the API surface after your configured window. Metadata is retained. |
+        | **Per phone number** | Only the specified phone numbers have message content removed from the API surface this way. The rest follow the standard message-retention policy. |
 
         **Behavioral differences vs the standard default:**
 
         | Aspect | Standard | Ephemeral |
         |---|---|---|
         | Retention | Retained per the standard message-retention policy | **Hard backstop: your configured window** (60 minutes – 24 hours, default 24 hours) from when the message is created |
-        | After expiry | Message stays retrievable | Message is permanently deleted — `GET /v3/messages/{messageId}` returns `404` and it no longer appears in `GET /v3/chats/{chatId}/messages` |
-        | Content on expiry | N/A | Text, formatting, and attachment references are scrubbed; the message is gone, not blanked out |
+        | After expiry | Message stays retrievable | Message content is no longer retrievable — `GET /v3/messages/{messageId}` returns `404` and it no longer appears in `GET /v3/chats/{chatId}/messages` |
+        | Content on expiry | N/A | Text, formatting, and attachment references are removed from the API surface, not blanked out in place. Metadata (identifiers, timestamps, phone numbers, delivery state) is retained; its retention is not bounded by this window |
         | Attachments | Retained | Media sent on the **ephemeral attachments tier** is removed on its own storage backstop — within roughly 24–48 hours of upload — independently of the message window, so it can outlast a window shorter than a day. Attachments on the persistent tier (including pre-uploads via `POST /v3/attachments`) are kept until you `DELETE` them |
         | Cross-partner isolation | Enforced | Enforced |
 
@@ -2422,7 +2422,7 @@ class LinqAPIV3WithRawResponse:
 
         - **No expiry timestamp is exposed.** API responses and webhook payloads do not include the deletion time, and they do not report your configured window either — so if you are on a window shorter than 24 hours you cannot derive a message's expiry from the API today. Track the window you agreed with your Linq support contact and compute `created_at + window` yourself.
         - **No deletion webhook is sent.** There is no `message.deleted` event — a message simply stops being retrievable once its window passes.
-        - **The backstop governs Linq storage.** API retrievability (the `404` behavior above) ends at your configured window. Ephemeral-tier media objects are removed on their own storage backstop — within roughly 24–48 hours of upload — which is independent of the message window and can outlast a window shorter than a day. Removal of the corresponding entries from the sending device happens asynchronously and can complete after the backstop.
+        - **The attachment backstop is separate from the message window.** API retrievability (the `404` behavior above) ends at your configured window. Ephemeral-tier media objects are removed on their own storage backstop — within roughly 24–48 hours of upload — which is independent of the message window and can outlast a window shorter than a day. Removal of the corresponding entries from the sending device happens asynchronously and can complete after the backstop.
         - **Delivery is unaffected.** Ephemeral messages send, deliver, and fire the usual `message.sent` / `message.received` and status webhooks exactly like standard messages. Only retention changes.
 
         **When to choose ephemeral:**
@@ -2618,7 +2618,7 @@ class LinqAPIV3WithRawResponse:
         |---|---|---|
         | Attachment bytes | Retained until you `DELETE` | **Auto-removed within roughly 24–48 hours** of upload, independently of any message window. Also removable via `DELETE` |
         | Attachment metadata (id, filename, mime type, size) | Retained until you `DELETE` | Removed alongside the bytes |
-        | Message body & parts | Retained per message-retention policy | Retained per message-retention policy — unless the line also has **ephemeral messages** enabled (see the Messages page), in which case the message and its parts are deleted after that account's configured retention window (60 minutes – 24 hours, default 24 hours) from creation |
+        | Message body & parts | Retained per message-retention policy | Retained per message-retention policy — unless the line also has **ephemeral messages** enabled (see the Messages page), in which case the message's text, formatting, and attachment references are no longer retrievable through the API after that account's configured retention window (60 minutes – 24 hours, default 24 hours) from creation. Metadata is retained; see the Messages page for details |
         | Audit log of deletions | Retained per platform retention policy | Retained per platform retention policy |
 
         **In transit:** TLS 1.2+ everywhere. **At rest:** AES-256 (server-side encryption).
@@ -3331,7 +3331,7 @@ class AsyncLinqAPIV3WithRawResponse:
 
         ## Ephemeral Messages (Privacy Tier)
 
-        For regulated or sensitive conversations, opt in to the **ephemeral messages** tier by contacting your Linq support contact. When enabled, every message on the covered phone numbers is given a **retention window configured for your account** — after that window the platform permanently deletes the message from Linq storage. There is no per-message flag; ephemerality is applied automatically based on your configuration.
+        For regulated or sensitive conversations, opt in to the **ephemeral messages** tier by contacting your Linq support contact. When enabled, every message on the covered phone numbers is given a **retention window configured for your account**. After that window, the message's text, formatting, and attachment references are no longer retrievable through the API — see the Attachments row below for how the attachment media itself is handled. Metadata about the message is retained: message identifiers, timestamps, phone numbers, and delivery state. Metadata retention is not bounded by this window. Bounded operational copies, such as backups and delivery queues, expire on their own separate schedules. There is no per-message flag; ephemerality is applied automatically based on your configuration.
 
         The window can be set anywhere from **60 minutes to 24 hours**, and defaults to **24 hours**. Ask your Linq support contact to configure a shorter window; it cannot be changed through the API.
 
@@ -3339,16 +3339,16 @@ class AsyncLinqAPIV3WithRawResponse:
 
         | Scope | Effect |
         |---|---|
-        | **Partner-wide** | Every outbound and inbound message on every phone number under your account is retained for your configured window, then deleted. |
-        | **Per phone number** | Only the specified phone numbers have their messages auto-deleted. The rest follow the standard message-retention policy. |
+        | **Partner-wide** | Every outbound and inbound message on every phone number under your account has its content removed from the API surface after your configured window. Metadata is retained. |
+        | **Per phone number** | Only the specified phone numbers have message content removed from the API surface this way. The rest follow the standard message-retention policy. |
 
         **Behavioral differences vs the standard default:**
 
         | Aspect | Standard | Ephemeral |
         |---|---|---|
         | Retention | Retained per the standard message-retention policy | **Hard backstop: your configured window** (60 minutes – 24 hours, default 24 hours) from when the message is created |
-        | After expiry | Message stays retrievable | Message is permanently deleted — `GET /v3/messages/{messageId}` returns `404` and it no longer appears in `GET /v3/chats/{chatId}/messages` |
-        | Content on expiry | N/A | Text, formatting, and attachment references are scrubbed; the message is gone, not blanked out |
+        | After expiry | Message stays retrievable | Message content is no longer retrievable — `GET /v3/messages/{messageId}` returns `404` and it no longer appears in `GET /v3/chats/{chatId}/messages` |
+        | Content on expiry | N/A | Text, formatting, and attachment references are removed from the API surface, not blanked out in place. Metadata (identifiers, timestamps, phone numbers, delivery state) is retained; its retention is not bounded by this window |
         | Attachments | Retained | Media sent on the **ephemeral attachments tier** is removed on its own storage backstop — within roughly 24–48 hours of upload — independently of the message window, so it can outlast a window shorter than a day. Attachments on the persistent tier (including pre-uploads via `POST /v3/attachments`) are kept until you `DELETE` them |
         | Cross-partner isolation | Enforced | Enforced |
 
@@ -3363,7 +3363,7 @@ class AsyncLinqAPIV3WithRawResponse:
 
         - **No expiry timestamp is exposed.** API responses and webhook payloads do not include the deletion time, and they do not report your configured window either — so if you are on a window shorter than 24 hours you cannot derive a message's expiry from the API today. Track the window you agreed with your Linq support contact and compute `created_at + window` yourself.
         - **No deletion webhook is sent.** There is no `message.deleted` event — a message simply stops being retrievable once its window passes.
-        - **The backstop governs Linq storage.** API retrievability (the `404` behavior above) ends at your configured window. Ephemeral-tier media objects are removed on their own storage backstop — within roughly 24–48 hours of upload — which is independent of the message window and can outlast a window shorter than a day. Removal of the corresponding entries from the sending device happens asynchronously and can complete after the backstop.
+        - **The attachment backstop is separate from the message window.** API retrievability (the `404` behavior above) ends at your configured window. Ephemeral-tier media objects are removed on their own storage backstop — within roughly 24–48 hours of upload — which is independent of the message window and can outlast a window shorter than a day. Removal of the corresponding entries from the sending device happens asynchronously and can complete after the backstop.
         - **Delivery is unaffected.** Ephemeral messages send, deliver, and fire the usual `message.sent` / `message.received` and status webhooks exactly like standard messages. Only retention changes.
 
         **When to choose ephemeral:**
@@ -3559,7 +3559,7 @@ class AsyncLinqAPIV3WithRawResponse:
         |---|---|---|
         | Attachment bytes | Retained until you `DELETE` | **Auto-removed within roughly 24–48 hours** of upload, independently of any message window. Also removable via `DELETE` |
         | Attachment metadata (id, filename, mime type, size) | Retained until you `DELETE` | Removed alongside the bytes |
-        | Message body & parts | Retained per message-retention policy | Retained per message-retention policy — unless the line also has **ephemeral messages** enabled (see the Messages page), in which case the message and its parts are deleted after that account's configured retention window (60 minutes – 24 hours, default 24 hours) from creation |
+        | Message body & parts | Retained per message-retention policy | Retained per message-retention policy — unless the line also has **ephemeral messages** enabled (see the Messages page), in which case the message's text, formatting, and attachment references are no longer retrievable through the API after that account's configured retention window (60 minutes – 24 hours, default 24 hours) from creation. Metadata is retained; see the Messages page for details |
         | Audit log of deletions | Retained per platform retention policy | Retained per platform retention policy |
 
         **In transit:** TLS 1.2+ everywhere. **At rest:** AES-256 (server-side encryption).
@@ -4272,7 +4272,7 @@ class LinqAPIV3WithStreamedResponse:
 
         ## Ephemeral Messages (Privacy Tier)
 
-        For regulated or sensitive conversations, opt in to the **ephemeral messages** tier by contacting your Linq support contact. When enabled, every message on the covered phone numbers is given a **retention window configured for your account** — after that window the platform permanently deletes the message from Linq storage. There is no per-message flag; ephemerality is applied automatically based on your configuration.
+        For regulated or sensitive conversations, opt in to the **ephemeral messages** tier by contacting your Linq support contact. When enabled, every message on the covered phone numbers is given a **retention window configured for your account**. After that window, the message's text, formatting, and attachment references are no longer retrievable through the API — see the Attachments row below for how the attachment media itself is handled. Metadata about the message is retained: message identifiers, timestamps, phone numbers, and delivery state. Metadata retention is not bounded by this window. Bounded operational copies, such as backups and delivery queues, expire on their own separate schedules. There is no per-message flag; ephemerality is applied automatically based on your configuration.
 
         The window can be set anywhere from **60 minutes to 24 hours**, and defaults to **24 hours**. Ask your Linq support contact to configure a shorter window; it cannot be changed through the API.
 
@@ -4280,16 +4280,16 @@ class LinqAPIV3WithStreamedResponse:
 
         | Scope | Effect |
         |---|---|
-        | **Partner-wide** | Every outbound and inbound message on every phone number under your account is retained for your configured window, then deleted. |
-        | **Per phone number** | Only the specified phone numbers have their messages auto-deleted. The rest follow the standard message-retention policy. |
+        | **Partner-wide** | Every outbound and inbound message on every phone number under your account has its content removed from the API surface after your configured window. Metadata is retained. |
+        | **Per phone number** | Only the specified phone numbers have message content removed from the API surface this way. The rest follow the standard message-retention policy. |
 
         **Behavioral differences vs the standard default:**
 
         | Aspect | Standard | Ephemeral |
         |---|---|---|
         | Retention | Retained per the standard message-retention policy | **Hard backstop: your configured window** (60 minutes – 24 hours, default 24 hours) from when the message is created |
-        | After expiry | Message stays retrievable | Message is permanently deleted — `GET /v3/messages/{messageId}` returns `404` and it no longer appears in `GET /v3/chats/{chatId}/messages` |
-        | Content on expiry | N/A | Text, formatting, and attachment references are scrubbed; the message is gone, not blanked out |
+        | After expiry | Message stays retrievable | Message content is no longer retrievable — `GET /v3/messages/{messageId}` returns `404` and it no longer appears in `GET /v3/chats/{chatId}/messages` |
+        | Content on expiry | N/A | Text, formatting, and attachment references are removed from the API surface, not blanked out in place. Metadata (identifiers, timestamps, phone numbers, delivery state) is retained; its retention is not bounded by this window |
         | Attachments | Retained | Media sent on the **ephemeral attachments tier** is removed on its own storage backstop — within roughly 24–48 hours of upload — independently of the message window, so it can outlast a window shorter than a day. Attachments on the persistent tier (including pre-uploads via `POST /v3/attachments`) are kept until you `DELETE` them |
         | Cross-partner isolation | Enforced | Enforced |
 
@@ -4304,7 +4304,7 @@ class LinqAPIV3WithStreamedResponse:
 
         - **No expiry timestamp is exposed.** API responses and webhook payloads do not include the deletion time, and they do not report your configured window either — so if you are on a window shorter than 24 hours you cannot derive a message's expiry from the API today. Track the window you agreed with your Linq support contact and compute `created_at + window` yourself.
         - **No deletion webhook is sent.** There is no `message.deleted` event — a message simply stops being retrievable once its window passes.
-        - **The backstop governs Linq storage.** API retrievability (the `404` behavior above) ends at your configured window. Ephemeral-tier media objects are removed on their own storage backstop — within roughly 24–48 hours of upload — which is independent of the message window and can outlast a window shorter than a day. Removal of the corresponding entries from the sending device happens asynchronously and can complete after the backstop.
+        - **The attachment backstop is separate from the message window.** API retrievability (the `404` behavior above) ends at your configured window. Ephemeral-tier media objects are removed on their own storage backstop — within roughly 24–48 hours of upload — which is independent of the message window and can outlast a window shorter than a day. Removal of the corresponding entries from the sending device happens asynchronously and can complete after the backstop.
         - **Delivery is unaffected.** Ephemeral messages send, deliver, and fire the usual `message.sent` / `message.received` and status webhooks exactly like standard messages. Only retention changes.
 
         **When to choose ephemeral:**
@@ -4500,7 +4500,7 @@ class LinqAPIV3WithStreamedResponse:
         |---|---|---|
         | Attachment bytes | Retained until you `DELETE` | **Auto-removed within roughly 24–48 hours** of upload, independently of any message window. Also removable via `DELETE` |
         | Attachment metadata (id, filename, mime type, size) | Retained until you `DELETE` | Removed alongside the bytes |
-        | Message body & parts | Retained per message-retention policy | Retained per message-retention policy — unless the line also has **ephemeral messages** enabled (see the Messages page), in which case the message and its parts are deleted after that account's configured retention window (60 minutes – 24 hours, default 24 hours) from creation |
+        | Message body & parts | Retained per message-retention policy | Retained per message-retention policy — unless the line also has **ephemeral messages** enabled (see the Messages page), in which case the message's text, formatting, and attachment references are no longer retrievable through the API after that account's configured retention window (60 minutes – 24 hours, default 24 hours) from creation. Metadata is retained; see the Messages page for details |
         | Audit log of deletions | Retained per platform retention policy | Retained per platform retention policy |
 
         **In transit:** TLS 1.2+ everywhere. **At rest:** AES-256 (server-side encryption).
@@ -5213,7 +5213,7 @@ class AsyncLinqAPIV3WithStreamedResponse:
 
         ## Ephemeral Messages (Privacy Tier)
 
-        For regulated or sensitive conversations, opt in to the **ephemeral messages** tier by contacting your Linq support contact. When enabled, every message on the covered phone numbers is given a **retention window configured for your account** — after that window the platform permanently deletes the message from Linq storage. There is no per-message flag; ephemerality is applied automatically based on your configuration.
+        For regulated or sensitive conversations, opt in to the **ephemeral messages** tier by contacting your Linq support contact. When enabled, every message on the covered phone numbers is given a **retention window configured for your account**. After that window, the message's text, formatting, and attachment references are no longer retrievable through the API — see the Attachments row below for how the attachment media itself is handled. Metadata about the message is retained: message identifiers, timestamps, phone numbers, and delivery state. Metadata retention is not bounded by this window. Bounded operational copies, such as backups and delivery queues, expire on their own separate schedules. There is no per-message flag; ephemerality is applied automatically based on your configuration.
 
         The window can be set anywhere from **60 minutes to 24 hours**, and defaults to **24 hours**. Ask your Linq support contact to configure a shorter window; it cannot be changed through the API.
 
@@ -5221,16 +5221,16 @@ class AsyncLinqAPIV3WithStreamedResponse:
 
         | Scope | Effect |
         |---|---|
-        | **Partner-wide** | Every outbound and inbound message on every phone number under your account is retained for your configured window, then deleted. |
-        | **Per phone number** | Only the specified phone numbers have their messages auto-deleted. The rest follow the standard message-retention policy. |
+        | **Partner-wide** | Every outbound and inbound message on every phone number under your account has its content removed from the API surface after your configured window. Metadata is retained. |
+        | **Per phone number** | Only the specified phone numbers have message content removed from the API surface this way. The rest follow the standard message-retention policy. |
 
         **Behavioral differences vs the standard default:**
 
         | Aspect | Standard | Ephemeral |
         |---|---|---|
         | Retention | Retained per the standard message-retention policy | **Hard backstop: your configured window** (60 minutes – 24 hours, default 24 hours) from when the message is created |
-        | After expiry | Message stays retrievable | Message is permanently deleted — `GET /v3/messages/{messageId}` returns `404` and it no longer appears in `GET /v3/chats/{chatId}/messages` |
-        | Content on expiry | N/A | Text, formatting, and attachment references are scrubbed; the message is gone, not blanked out |
+        | After expiry | Message stays retrievable | Message content is no longer retrievable — `GET /v3/messages/{messageId}` returns `404` and it no longer appears in `GET /v3/chats/{chatId}/messages` |
+        | Content on expiry | N/A | Text, formatting, and attachment references are removed from the API surface, not blanked out in place. Metadata (identifiers, timestamps, phone numbers, delivery state) is retained; its retention is not bounded by this window |
         | Attachments | Retained | Media sent on the **ephemeral attachments tier** is removed on its own storage backstop — within roughly 24–48 hours of upload — independently of the message window, so it can outlast a window shorter than a day. Attachments on the persistent tier (including pre-uploads via `POST /v3/attachments`) are kept until you `DELETE` them |
         | Cross-partner isolation | Enforced | Enforced |
 
@@ -5245,7 +5245,7 @@ class AsyncLinqAPIV3WithStreamedResponse:
 
         - **No expiry timestamp is exposed.** API responses and webhook payloads do not include the deletion time, and they do not report your configured window either — so if you are on a window shorter than 24 hours you cannot derive a message's expiry from the API today. Track the window you agreed with your Linq support contact and compute `created_at + window` yourself.
         - **No deletion webhook is sent.** There is no `message.deleted` event — a message simply stops being retrievable once its window passes.
-        - **The backstop governs Linq storage.** API retrievability (the `404` behavior above) ends at your configured window. Ephemeral-tier media objects are removed on their own storage backstop — within roughly 24–48 hours of upload — which is independent of the message window and can outlast a window shorter than a day. Removal of the corresponding entries from the sending device happens asynchronously and can complete after the backstop.
+        - **The attachment backstop is separate from the message window.** API retrievability (the `404` behavior above) ends at your configured window. Ephemeral-tier media objects are removed on their own storage backstop — within roughly 24–48 hours of upload — which is independent of the message window and can outlast a window shorter than a day. Removal of the corresponding entries from the sending device happens asynchronously and can complete after the backstop.
         - **Delivery is unaffected.** Ephemeral messages send, deliver, and fire the usual `message.sent` / `message.received` and status webhooks exactly like standard messages. Only retention changes.
 
         **When to choose ephemeral:**
@@ -5441,7 +5441,7 @@ class AsyncLinqAPIV3WithStreamedResponse:
         |---|---|---|
         | Attachment bytes | Retained until you `DELETE` | **Auto-removed within roughly 24–48 hours** of upload, independently of any message window. Also removable via `DELETE` |
         | Attachment metadata (id, filename, mime type, size) | Retained until you `DELETE` | Removed alongside the bytes |
-        | Message body & parts | Retained per message-retention policy | Retained per message-retention policy — unless the line also has **ephemeral messages** enabled (see the Messages page), in which case the message and its parts are deleted after that account's configured retention window (60 minutes – 24 hours, default 24 hours) from creation |
+        | Message body & parts | Retained per message-retention policy | Retained per message-retention policy — unless the line also has **ephemeral messages** enabled (see the Messages page), in which case the message's text, formatting, and attachment references are no longer retrievable through the API after that account's configured retention window (60 minutes – 24 hours, default 24 hours) from creation. Metadata is retained; see the Messages page for details |
         | Audit log of deletions | Retained per platform retention policy | Retained per platform retention policy |
 
         **In transit:** TLS 1.2+ everywhere. **At rest:** AES-256 (server-side encryption).

{linq_python-0.41.1 → linq_python-0.42.0}/src/linq/_version.py

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

{linq_python-0.41.1 → linq_python-0.42.0}/src/linq/resources/attachments.py

@@ -203,7 +203,7 @@ class AttachmentsResource(SyncAPIResource):
     |---|---|---|
     | Attachment bytes | Retained until you `DELETE` | **Auto-removed within roughly 24–48 hours** of upload, independently of any message window. Also removable via `DELETE` |
     | Attachment metadata (id, filename, mime type, size) | Retained until you `DELETE` | Removed alongside the bytes |
-    | Message body & parts | Retained per message-retention policy | Retained per message-retention policy — unless the line also has **ephemeral messages** enabled (see the Messages page), in which case the message and its parts are deleted after that account's configured retention window (60 minutes – 24 hours, default 24 hours) from creation |
+    | Message body & parts | Retained per message-retention policy | Retained per message-retention policy — unless the line also has **ephemeral messages** enabled (see the Messages page), in which case the message's text, formatting, and attachment references are no longer retrievable through the API after that account's configured retention window (60 minutes – 24 hours, default 24 hours) from creation. Metadata is retained; see the Messages page for details |
     | Audit log of deletions | Retained per platform retention policy | Retained per platform retention policy |
 
     **In transit:** TLS 1.2+ everywhere. **At rest:** AES-256 (server-side encryption).
@@ -650,7 +650,7 @@ class AsyncAttachmentsResource(AsyncAPIResource):
     |---|---|---|
     | Attachment bytes | Retained until you `DELETE` | **Auto-removed within roughly 24–48 hours** of upload, independently of any message window. Also removable via `DELETE` |
     | Attachment metadata (id, filename, mime type, size) | Retained until you `DELETE` | Removed alongside the bytes |
-    | Message body & parts | Retained per message-retention policy | Retained per message-retention policy — unless the line also has **ephemeral messages** enabled (see the Messages page), in which case the message and its parts are deleted after that account's configured retention window (60 minutes – 24 hours, default 24 hours) from creation |
+    | Message body & parts | Retained per message-retention policy | Retained per message-retention policy — unless the line also has **ephemeral messages** enabled (see the Messages page), in which case the message's text, formatting, and attachment references are no longer retrievable through the API after that account's configured retention window (60 minutes – 24 hours, default 24 hours) from creation. Metadata is retained; see the Messages page for details |
     | Audit log of deletions | Retained per platform retention policy | Retained per platform retention policy |
 
     **In transit:** TLS 1.2+ everywhere. **At rest:** AES-256 (server-side encryption).