linq-python 0.39.0__tar.gz → 0.40.0__tar.gz

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

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

{linq_python-0.39.0 → linq_python-0.40.0}/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.40.0](https://github.com/linq-team/linq-python/compare/v0.39.1...v0.40.0) (2026-09-01)
+
+
+### Features
+
+* add contact card received webhook event ([82481ec](https://github.com/linq-team/linq-python/commit/82481ec3e3e7031e307e6234bc0c2775d0e08c46))
+
+## [0.39.1](https://github.com/linq-team/linq-python/compare/v0.39.0...v0.39.1) (2026-09-01)
+
+
+### Bug Fixes
+
+* update documentation links to include imessage channel path ([ee83a35](https://github.com/linq-team/linq-python/commit/ee83a355f4b017634bb477e794ea3bf5434ff26b))
+
 ## [0.39.0](https://github.com/linq-team/linq-python/compare/v0.38.0...v0.39.0) (2026-09-01)
 
 

{linq_python-0.39.0 → linq_python-0.40.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: linq-python
-Version: 0.39.0
+Version: 0.40.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.39.0 → linq_python-0.40.0}/api.md

@@ -391,6 +391,7 @@ from linq.types import (
     ChatTypingIndicatorStoppedWebhookEvent,
     ChatBackgroundUpdatedWebhookEvent,
     ChatBackgroundUpdateFailedWebhookEvent,
+    ContactCardReceivedWebhookEvent,
     PhoneNumberStatusUpdatedWebhookEvent,
     UnwrapWebhookEvent,
 )

{linq_python-0.39.0 → linq_python-0.40.0}/pyproject.toml

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

{linq_python-0.39.0 → linq_python-0.40.0}/src/linq/_client.py

@@ -622,7 +622,7 @@ class LinqAPIV3(SyncAPIClient):
         `POST /v3/chats/{chatId}/messages` — it renders as a rich card with your
         branding (title, amount, image) instead of a bare URL, which converts far
         better. A `link` part must be the only part in the message. See
-        [Rich Link Previews](/guides/messaging/sending-messages).
+        [Rich Link Previews](/channel/imessage/guides/messaging/sending-messages).
 
         On a supported iPhone the link opens an **Apple Pay App Clip** — a native,
         no-install checkout sheet. Everywhere else (Android, desktop, iPhones
@@ -672,7 +672,7 @@ class LinqAPIV3(SyncAPIClient):
         Subscribe to payment lifecycle events to reconcile server-side rather than
         polling: `payment.succeeded`, `payment.canceled`, and `payment.expired`.
         Each event carries the payment request id, amount, currency, and your
-        `metadata`. See [Webhooks](/guides/webhooks).
+        `metadata`. See [Webhooks](/channel/imessage/guides/webhooks).
         """
         from .resources.payment_requests import PaymentRequestsResource
 
@@ -1738,7 +1738,7 @@ class AsyncLinqAPIV3(AsyncAPIClient):
         `POST /v3/chats/{chatId}/messages` — it renders as a rich card with your
         branding (title, amount, image) instead of a bare URL, which converts far
         better. A `link` part must be the only part in the message. See
-        [Rich Link Previews](/guides/messaging/sending-messages).
+        [Rich Link Previews](/channel/imessage/guides/messaging/sending-messages).
 
         On a supported iPhone the link opens an **Apple Pay App Clip** — a native,
         no-install checkout sheet. Everywhere else (Android, desktop, iPhones
@@ -1788,7 +1788,7 @@ class AsyncLinqAPIV3(AsyncAPIClient):
         Subscribe to payment lifecycle events to reconcile server-side rather than
         polling: `payment.succeeded`, `payment.canceled`, and `payment.expired`.
         Each event carries the payment request id, amount, currency, and your
-        `metadata`. See [Webhooks](/guides/webhooks).
+        `metadata`. See [Webhooks](/channel/imessage/guides/webhooks).
         """
         from .resources.payment_requests import AsyncPaymentRequestsResource
 
@@ -2788,7 +2788,7 @@ class LinqAPIV3WithRawResponse:
         `POST /v3/chats/{chatId}/messages` — it renders as a rich card with your
         branding (title, amount, image) instead of a bare URL, which converts far
         better. A `link` part must be the only part in the message. See
-        [Rich Link Previews](/guides/messaging/sending-messages).
+        [Rich Link Previews](/channel/imessage/guides/messaging/sending-messages).
 
         On a supported iPhone the link opens an **Apple Pay App Clip** — a native,
         no-install checkout sheet. Everywhere else (Android, desktop, iPhones
@@ -2838,7 +2838,7 @@ class LinqAPIV3WithRawResponse:
         Subscribe to payment lifecycle events to reconcile server-side rather than
         polling: `payment.succeeded`, `payment.canceled`, and `payment.expired`.
         Each event carries the payment request id, amount, currency, and your
-        `metadata`. See [Webhooks](/guides/webhooks).
+        `metadata`. See [Webhooks](/channel/imessage/guides/webhooks).
         """
         from .resources.payment_requests import PaymentRequestsResourceWithRawResponse
 
@@ -3710,7 +3710,7 @@ class AsyncLinqAPIV3WithRawResponse:
         `POST /v3/chats/{chatId}/messages` — it renders as a rich card with your
         branding (title, amount, image) instead of a bare URL, which converts far
         better. A `link` part must be the only part in the message. See
-        [Rich Link Previews](/guides/messaging/sending-messages).
+        [Rich Link Previews](/channel/imessage/guides/messaging/sending-messages).
 
         On a supported iPhone the link opens an **Apple Pay App Clip** — a native,
         no-install checkout sheet. Everywhere else (Android, desktop, iPhones
@@ -3760,7 +3760,7 @@ class AsyncLinqAPIV3WithRawResponse:
         Subscribe to payment lifecycle events to reconcile server-side rather than
         polling: `payment.succeeded`, `payment.canceled`, and `payment.expired`.
         Each event carries the payment request id, amount, currency, and your
-        `metadata`. See [Webhooks](/guides/webhooks).
+        `metadata`. See [Webhooks](/channel/imessage/guides/webhooks).
         """
         from .resources.payment_requests import AsyncPaymentRequestsResourceWithRawResponse
 
@@ -4632,7 +4632,7 @@ class LinqAPIV3WithStreamedResponse:
         `POST /v3/chats/{chatId}/messages` — it renders as a rich card with your
         branding (title, amount, image) instead of a bare URL, which converts far
         better. A `link` part must be the only part in the message. See
-        [Rich Link Previews](/guides/messaging/sending-messages).
+        [Rich Link Previews](/channel/imessage/guides/messaging/sending-messages).
 
         On a supported iPhone the link opens an **Apple Pay App Clip** — a native,
         no-install checkout sheet. Everywhere else (Android, desktop, iPhones
@@ -4682,7 +4682,7 @@ class LinqAPIV3WithStreamedResponse:
         Subscribe to payment lifecycle events to reconcile server-side rather than
         polling: `payment.succeeded`, `payment.canceled`, and `payment.expired`.
         Each event carries the payment request id, amount, currency, and your
-        `metadata`. See [Webhooks](/guides/webhooks).
+        `metadata`. See [Webhooks](/channel/imessage/guides/webhooks).
         """
         from .resources.payment_requests import PaymentRequestsResourceWithStreamingResponse
 
@@ -5554,7 +5554,7 @@ class AsyncLinqAPIV3WithStreamedResponse:
         `POST /v3/chats/{chatId}/messages` — it renders as a rich card with your
         branding (title, amount, image) instead of a bare URL, which converts far
         better. A `link` part must be the only part in the message. See
-        [Rich Link Previews](/guides/messaging/sending-messages).
+        [Rich Link Previews](/channel/imessage/guides/messaging/sending-messages).
 
         On a supported iPhone the link opens an **Apple Pay App Clip** — a native,
         no-install checkout sheet. Everywhere else (Android, desktop, iPhones
@@ -5604,7 +5604,7 @@ class AsyncLinqAPIV3WithStreamedResponse:
         Subscribe to payment lifecycle events to reconcile server-side rather than
         polling: `payment.succeeded`, `payment.canceled`, and `payment.expired`.
         Each event carries the payment request id, amount, currency, and your
-        `metadata`. See [Webhooks](/guides/webhooks).
+        `metadata`. See [Webhooks](/channel/imessage/guides/webhooks).
         """
         from .resources.payment_requests import AsyncPaymentRequestsResourceWithStreamingResponse
 

{linq_python-0.39.0 → linq_python-0.40.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.39.0"  # x-release-please-version
+__version__ = "0.40.0"  # x-release-please-version

{linq_python-0.39.0 → linq_python-0.40.0}/src/linq/resources/payment_requests.py

@@ -163,7 +163,7 @@ class PaymentRequestsResource(SyncAPIResource):
     `POST /v3/chats/{chatId}/messages` — it renders as a rich card with your
     branding (title, amount, image) instead of a bare URL, which converts far
     better. A `link` part must be the only part in the message. See
-    [Rich Link Previews](/guides/messaging/sending-messages).
+    [Rich Link Previews](/channel/imessage/guides/messaging/sending-messages).
 
     On a supported iPhone the link opens an **Apple Pay App Clip** — a native,
     no-install checkout sheet. Everywhere else (Android, desktop, iPhones
@@ -213,7 +213,7 @@ class PaymentRequestsResource(SyncAPIResource):
     Subscribe to payment lifecycle events to reconcile server-side rather than
     polling: `payment.succeeded`, `payment.canceled`, and `payment.expired`.
     Each event carries the payment request id, amount, currency, and your
-    `metadata`. See [Webhooks](/guides/webhooks).
+    `metadata`. See [Webhooks](/channel/imessage/guides/webhooks).
     """
 
     @cached_property
@@ -628,7 +628,7 @@ class AsyncPaymentRequestsResource(AsyncAPIResource):
     `POST /v3/chats/{chatId}/messages` — it renders as a rich card with your
     branding (title, amount, image) instead of a bare URL, which converts far
     better. A `link` part must be the only part in the message. See
-    [Rich Link Previews](/guides/messaging/sending-messages).
+    [Rich Link Previews](/channel/imessage/guides/messaging/sending-messages).
 
     On a supported iPhone the link opens an **Apple Pay App Clip** — a native,
     no-install checkout sheet. Everywhere else (Android, desktop, iPhones
@@ -678,7 +678,7 @@ class AsyncPaymentRequestsResource(AsyncAPIResource):
     Subscribe to payment lifecycle events to reconcile server-side rather than
     polling: `payment.succeeded`, `payment.canceled`, and `payment.expired`.
     Each event carries the payment request id, amount, currency, and your
-    `metadata`. See [Webhooks](/guides/webhooks).
+    `metadata`. See [Webhooks](/channel/imessage/guides/webhooks).
     """
 
     @cached_property

{linq_python-0.39.0 → linq_python-0.40.0}/src/linq/resources/webhook_subscriptions.py

@@ -213,7 +213,7 @@ class WebhookSubscriptionsResource(SyncAPIResource):
         - Legacy `X-Webhook-*` headers are also sent for backwards compatibility
           (deprecated)
         - See
-          [Verifying Webhook Signatures](https://docs.linqapp.com/guides/webhooks#verifying-webhook-signatures)
+          [Verifying Webhook Signatures](https://docs.linqapp.com/channel/imessage/guides/webhooks#verifying-webhook-signatures)
           for verification details
         - Failed deliveries (5xx, 429, network errors) are retried up to 10 times over
           ~25 minutes with exponential backoff
@@ -593,7 +593,7 @@ class AsyncWebhookSubscriptionsResource(AsyncAPIResource):
         - Legacy `X-Webhook-*` headers are also sent for backwards compatibility
           (deprecated)
         - See
-          [Verifying Webhook Signatures](https://docs.linqapp.com/guides/webhooks#verifying-webhook-signatures)
+          [Verifying Webhook Signatures](https://docs.linqapp.com/channel/imessage/guides/webhooks#verifying-webhook-signatures)
           for verification details
         - Failed deliveries (5xx, 429, network errors) are retried up to 10 times over
           ~25 minutes with exponential backoff

{linq_python-0.39.0 → linq_python-0.40.0}/src/linq/types/__init__.py

@@ -115,6 +115,7 @@ from .available_number_retrieve_response import AvailableNumberRetrieveResponse
 from .webhook_subscription_create_params import WebhookSubscriptionCreateParams as WebhookSubscriptionCreateParams
 from .webhook_subscription_list_response import WebhookSubscriptionListResponse as WebhookSubscriptionListResponse
 from .webhook_subscription_update_params import WebhookSubscriptionUpdateParams as WebhookSubscriptionUpdateParams
+from .contact_card_received_webhook_event import ContactCardReceivedWebhookEvent as ContactCardReceivedWebhookEvent
 from .message_list_messages_thread_params import MessageListMessagesThreadParams as MessageListMessagesThreadParams
 from .webhook_subscription_create_response import WebhookSubscriptionCreateResponse as WebhookSubscriptionCreateResponse
 from .chat_background_updated_webhook_event import (

{linq_python-0.39.0 → linq_python-0.40.0}/src/linq/types/chat.py

@@ -18,7 +18,7 @@ class HealthStatus(BaseModel):
 
     Switch on `status` to surface chat and line health in your UI — the enum is the long-term contract. Each status carries a `doc_url` that deep-links to the relevant section of the Chat Health guide. To gate a send, act on the response rather than the status: a `403` is the authoritative answer.
 
-    See the [Chat Health guide](/guides/chats/chat-health) for what each status means and how to react.
+    See the [Chat Health guide](/channel/imessage/guides/chats/chat-health) for what each status means and how to react.
     """
 
     doc_url: str
@@ -27,8 +27,8 @@ class HealthStatus(BaseModel):
     status: Literal["HEALTHY", "AT_RISK", "CRITICAL", "OPTED_OUT"]
     """Current health bucket for the chat.
 
-    See the [Chat Health guide](/guides/chats/chat-health) for what each value means
-    and how to react. `doc_url` deep-links to the relevant section.
+    See the [Chat Health guide](/channel/imessage/guides/chats/chat-health) for what
+    each value means and how to react. `doc_url` deep-links to the relevant section.
 
     `OPTED_OUT` — the recipient sent `STOP`, `UNSUBSCRIBE`, `OPTOUT`, `CANCEL`,
     `END`, or `QUIT`. The keyword must be the whole trimmed message, never part of a
@@ -88,8 +88,8 @@ class Chat(BaseModel):
     relevant section of the Chat Health guide. To gate a send, act on the response
     rather than the status: a `403` is the authoritative answer.
 
-    See the [Chat Health guide](/guides/chats/chat-health) for what each status
-    means and how to react.
+    See the [Chat Health guide](/channel/imessage/guides/chats/chat-health) for what
+    each status means and how to react.
     """
 
     is_archived: bool

{linq_python-0.39.0 → linq_python-0.40.0}/src/linq/types/chat_create_response.py

@@ -19,7 +19,7 @@ class ChatHealthStatus(BaseModel):
 
     Switch on `status` to surface chat and line health in your UI — the enum is the long-term contract. Each status carries a `doc_url` that deep-links to the relevant section of the Chat Health guide. To gate a send, act on the response rather than the status: a `403` is the authoritative answer.
 
-    See the [Chat Health guide](/guides/chats/chat-health) for what each status means and how to react.
+    See the [Chat Health guide](/channel/imessage/guides/chats/chat-health) for what each status means and how to react.
     """
 
     doc_url: str
@@ -28,8 +28,8 @@ class ChatHealthStatus(BaseModel):
     status: Literal["HEALTHY", "AT_RISK", "CRITICAL", "OPTED_OUT"]
     """Current health bucket for the chat.
 
-    See the [Chat Health guide](/guides/chats/chat-health) for what each value means
-    and how to react. `doc_url` deep-links to the relevant section.
+    See the [Chat Health guide](/channel/imessage/guides/chats/chat-health) for what
+    each value means and how to react. `doc_url` deep-links to the relevant section.
 
     `OPTED_OUT` — the recipient sent `STOP`, `UNSUBSCRIBE`, `OPTOUT`, `CANCEL`,
     `END`, or `QUIT`. The keyword must be the whole trimmed message, never part of a
@@ -86,8 +86,8 @@ class Chat(BaseModel):
     relevant section of the Chat Health guide. To gate a send, act on the response
     rather than the status: a `403` is the authoritative answer.
 
-    See the [Chat Health guide](/guides/chats/chat-health) for what each status
-    means and how to react.
+    See the [Chat Health guide](/channel/imessage/guides/chats/chat-health) for what
+    each status means and how to react.
     """
 
     is_group: bool

{linq_python-0.39.0 → linq_python-0.40.0}/src/linq/types/chat_created_webhook_event.py

@@ -19,7 +19,7 @@ class DataHealthStatus(BaseModel):
 
     Switch on `status` to surface chat and line health in your UI — the enum is the long-term contract. Each status carries a `doc_url` that deep-links to the relevant section of the Chat Health guide. To gate a send, act on the response rather than the status: a `403` is the authoritative answer.
 
-    See the [Chat Health guide](/guides/chats/chat-health) for what each status means and how to react.
+    See the [Chat Health guide](/channel/imessage/guides/chats/chat-health) for what each status means and how to react.
     """
 
     doc_url: str
@@ -28,8 +28,8 @@ class DataHealthStatus(BaseModel):
     status: Literal["HEALTHY", "AT_RISK", "CRITICAL", "OPTED_OUT"]
     """Current health bucket for the chat.
 
-    See the [Chat Health guide](/guides/chats/chat-health) for what each value means
-    and how to react. `doc_url` deep-links to the relevant section.
+    See the [Chat Health guide](/channel/imessage/guides/chats/chat-health) for what
+    each value means and how to react. `doc_url` deep-links to the relevant section.
 
     `OPTED_OUT` — the recipient sent `STOP`, `UNSUBSCRIBE`, `OPTOUT`, `CANCEL`,
     `END`, or `QUIT`. The keyword must be the whole trimmed message, never part of a
@@ -94,8 +94,8 @@ class Data(BaseModel):
     relevant section of the Chat Health guide. To gate a send, act on the response
     rather than the status: a `403` is the authoritative answer.
 
-    See the [Chat Health guide](/guides/chats/chat-health) for what each status
-    means and how to react.
+    See the [Chat Health guide](/channel/imessage/guides/chats/chat-health) for what
+    each status means and how to react.
     """
 
     is_group: bool

linq_python-0.40.0/src/linq/types/contact_card_received_webhook_event.py

@@ -0,0 +1,86 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from datetime import datetime
+
+from .._models import BaseModel
+from .webhook_event_type import WebhookEventType
+
+__all__ = ["ContactCardReceivedWebhookEvent", "Data"]
+
+
+class Data(BaseModel):
+    """Payload for contact_card.received webhook events.
+
+    A contact belongs to a line, not to an individual chat. You receive one event per person who
+    shares their contact, regardless of how many chats they have in common with your line.
+
+    The event fires again whenever the shared contact's name or media changes.
+    """
+
+    first_name: str
+    """First name from the shared contact card"""
+
+    last_name: str
+    """Last name from the shared contact card (may be empty)"""
+
+    owner_handle: str
+    """Which of your lines they shared it with."""
+
+    sender_handle: str
+    """The person who shared their card — a phone number or email address."""
+
+    media_url: Optional[str] = None
+    """URL of the contact's media, served from `cdn.linqapp.com`.
+
+    `null` when the contact shared no media, and also when media was shared but
+    could not be retrieved — this field does not distinguish the two.
+
+    Download the media and store it yourself. The URL may be signed and expire, in
+    as little as 45 minutes, and altering its query string invalidates it
+    immediately.
+    """
+
+
+class ContactCardReceivedWebhookEvent(BaseModel):
+    """Complete webhook payload for contact_card.received events"""
+
+    api_version: str
+    """API version for the webhook payload format"""
+
+    created_at: datetime
+    """When the event was created"""
+
+    data: Data
+    """Payload for contact_card.received webhook events.
+
+    A contact belongs to a line, not to an individual chat. You receive one event
+    per person who shares their contact, regardless of how many chats they have in
+    common with your line.
+
+    The event fires again whenever the shared contact's name or media changes.
+    """
+
+    event_id: str
+    """Unique identifier for this event (for deduplication)"""
+
+    event_type: WebhookEventType
+    """Valid webhook event types that can be subscribed to.
+
+    **Note:** `message.edited` is only delivered to subscriptions using
+    `webhook_version: "2026-02-03"`. Subscribing to this event on a v2025
+    subscription will not produce any deliveries.
+    """
+
+    partner_id: str
+    """Partner identifier. Present on all webhooks for cross-referencing."""
+
+    trace_id: str
+    """Trace ID for debugging and correlation across systems."""
+
+    webhook_version: str
+    """
+    Date-based webhook payload version. Determined by the `?version=` query
+    parameter in your webhook subscription URL. If no version parameter is
+    specified, defaults based on subscription creation date.
+    """

{linq_python-0.39.0 → linq_python-0.40.0}/src/linq/types/message_edited_webhook_event.py

@@ -17,7 +17,7 @@ class DataChatHealthStatus(BaseModel):
 
     Switch on `status` to surface chat and line health in your UI — the enum is the long-term contract. Each status carries a `doc_url` that deep-links to the relevant section of the Chat Health guide. To gate a send, act on the response rather than the status: a `403` is the authoritative answer.
 
-    See the [Chat Health guide](/guides/chats/chat-health) for what each status means and how to react.
+    See the [Chat Health guide](/channel/imessage/guides/chats/chat-health) for what each status means and how to react.
     """
 
     doc_url: str
@@ -26,8 +26,8 @@ class DataChatHealthStatus(BaseModel):
     status: Literal["HEALTHY", "AT_RISK", "CRITICAL", "OPTED_OUT"]
     """Current health bucket for the chat.
 
-    See the [Chat Health guide](/guides/chats/chat-health) for what each value means
-    and how to react. `doc_url` deep-links to the relevant section.
+    See the [Chat Health guide](/channel/imessage/guides/chats/chat-health) for what
+    each value means and how to react. `doc_url` deep-links to the relevant section.
 
     `OPTED_OUT` — the recipient sent `STOP`, `UNSUBSCRIBE`, `OPTOUT`, `CANCEL`,
     `END`, or `QUIT`. The keyword must be the whole trimmed message, never part of a
@@ -72,8 +72,8 @@ class DataChat(BaseModel):
     relevant section of the Chat Health guide. To gate a send, act on the response
     rather than the status: a `403` is the authoritative answer.
 
-    See the [Chat Health guide](/guides/chats/chat-health) for what each status
-    means and how to react.
+    See the [Chat Health guide](/channel/imessage/guides/chats/chat-health) for what
+    each status means and how to react.
     """
 
     is_group: bool

{linq_python-0.39.0 → linq_python-0.40.0}/src/linq/types/message_event_v2.py

@@ -33,7 +33,7 @@ class ChatHealthStatus(BaseModel):
 
     Switch on `status` to surface chat and line health in your UI — the enum is the long-term contract. Each status carries a `doc_url` that deep-links to the relevant section of the Chat Health guide. To gate a send, act on the response rather than the status: a `403` is the authoritative answer.
 
-    See the [Chat Health guide](/guides/chats/chat-health) for what each status means and how to react.
+    See the [Chat Health guide](/channel/imessage/guides/chats/chat-health) for what each status means and how to react.
     """
 
     doc_url: str
@@ -42,8 +42,8 @@ class ChatHealthStatus(BaseModel):
     status: Literal["HEALTHY", "AT_RISK", "CRITICAL", "OPTED_OUT"]
     """Current health bucket for the chat.
 
-    See the [Chat Health guide](/guides/chats/chat-health) for what each value means
-    and how to react. `doc_url` deep-links to the relevant section.
+    See the [Chat Health guide](/channel/imessage/guides/chats/chat-health) for what
+    each value means and how to react. `doc_url` deep-links to the relevant section.
 
     `OPTED_OUT` — the recipient sent `STOP`, `UNSUBSCRIBE`, `OPTOUT`, `CANCEL`,
     `END`, or `QUIT`. The keyword must be the whole trimmed message, never part of a
@@ -88,8 +88,8 @@ class Chat(BaseModel):
     relevant section of the Chat Health guide. To gate a send, act on the response
     rather than the status: a `403` is the authoritative answer.
 
-    See the [Chat Health guide](/guides/chats/chat-health) for what each status
-    means and how to react.
+    See the [Chat Health guide](/channel/imessage/guides/chats/chat-health) for what
+    each status means and how to react.
     """
 
     is_group: Optional[bool] = None

{linq_python-0.39.0 → linq_python-0.40.0}/src/linq/types/phone_number_list_response.py

@@ -15,7 +15,7 @@ class PhoneNumberReputation(BaseModel):
 
     Unlike chat health, line reputation does not include `opted_out` — opt-out applies to individual recipients, not the whole line.
 
-    See the [Phone Reputation guide](/guides/phone-numbers/phone-reputation) for what each status means and how to react.
+    See the [Phone Reputation guide](/channel/imessage/guides/phone-numbers/phone-reputation) for what each status means and how to react.
     """
 
     doc_url: str
@@ -55,8 +55,9 @@ class PhoneNumber(BaseModel):
     Unlike chat health, line reputation does not include `opted_out` — opt-out
     applies to individual recipients, not the whole line.
 
-    See the [Phone Reputation guide](/guides/phone-numbers/phone-reputation) for
-    what each status means and how to react.
+    See the
+    [Phone Reputation guide](/channel/imessage/guides/phone-numbers/phone-reputation)
+    for what each status means and how to react.
     """
 
     forwarding_number: Optional[str] = None

{linq_python-0.39.0 → linq_python-0.40.0}/src/linq/types/unwrap_webhook_event.py

@@ -24,6 +24,7 @@ from .participant_added_webhook_event import ParticipantAddedWebhookEvent
 from .poll_vote_removed_webhook_event import PollVoteRemovedWebhookEvent
 from .participant_removed_webhook_event import ParticipantRemovedWebhookEvent
 from .poll_reaction_added_webhook_event import PollReactionAddedWebhookEvent
+from .contact_card_received_webhook_event import ContactCardReceivedWebhookEvent
 from .chat_background_updated_webhook_event import ChatBackgroundUpdatedWebhookEvent
 from .chat_group_icon_updated_webhook_event import ChatGroupIconUpdatedWebhookEvent
 from .chat_group_name_updated_webhook_event import ChatGroupNameUpdatedWebhookEvent
@@ -66,6 +67,7 @@ UnwrapWebhookEvent: TypeAlias = Annotated[
         ChatTypingIndicatorStoppedWebhookEvent,
         ChatBackgroundUpdatedWebhookEvent,
         ChatBackgroundUpdateFailedWebhookEvent,
+        ContactCardReceivedWebhookEvent,
         PhoneNumberStatusUpdatedWebhookEvent,
     ],
     PropertyInfo(discriminator="event_type"),

{linq_python-0.39.0 → linq_python-0.40.0}/src/linq/types/webhook_event_list_response.py

@@ -10,7 +10,7 @@ __all__ = ["WebhookEventListResponse"]
 
 
 class WebhookEventListResponse(BaseModel):
-    doc_url: Literal["https://docs.linqapp.com/guides/webhooks/events"]
+    doc_url: Literal["https://docs.linqapp.com/channel/imessage/guides/webhooks/events"]
     """URL to the webhook events documentation"""
 
     events: List[WebhookEventType]

{linq_python-0.39.0 → linq_python-0.40.0}/tests/api_resources/test_webhooks.py

@@ -31,7 +31,7 @@ class TestWebhooks:
 
         client = client.with_options(webhook_secret=client_opt)
 
-        data = """{"api_version":"v3","created_at":"2025-11-23T17:30:00Z","data":{"id":"550e8400-e29b-41d4-a716-446655440001","chat":{"id":"550e8400-e29b-41d4-a716-446655440000","health_status":{"doc_url":"https://docs.linqapp.com/guides/chats/chat-health#at-risk","status":"AT_RISK","updated_at":"2026-05-01T18:28:25Z"},"is_group":true,"owner_handle":{"id":"550e8400-e29b-41d4-a716-446655440000","handle":"+15551234567","joined_at":"2025-05-21T15:30:00.000-05:00","service":"iMessage","is_me":false,"left_at":"2019-12-27T18:11:19.117Z","status":"active"}},"direction":"outbound","parts":[{"type":"text","value":"Hello!","mention":"+14155551234","mention_range":[4,9],"mentions":[{"handle":"+14155550123","is_me":true,"range":[4,9]}],"text_decorations":[{"range":[0,5],"animation":"shake","style":"bold"}]}],"sender_handle":{"id":"550e8400-e29b-41d4-a716-446655440000","handle":"+15551234567","joined_at":"2025-05-21T15:30:00.000-05:00","service":"iMessage","is_me":false,"left_at":"2019-12-27T18:11:19.117Z","status":"active"},"service":"iMessage","delivered_at":"2026-01-30T20:49:20.352Z","effect":{"name":"gentle","type":"bubble"},"idempotency_key":"unique-key","preferred_service":"iMessage","read_at":null,"reconciled_at":"2026-01-30T22:05:00.000Z","reply_to":{"message_id":"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e","part_index":0},"sent_at":"2026-01-30T20:49:19.704Z"},"event_id":"550e8400-e29b-41d4-a716-446655440000","event_type":"message.sent","partner_id":"partner_abc123","trace_id":"abc123def456","webhook_version":"2025-01-01"}"""
+        data = """{"api_version":"v3","created_at":"2025-11-23T17:30:00Z","data":{"id":"550e8400-e29b-41d4-a716-446655440001","chat":{"id":"550e8400-e29b-41d4-a716-446655440000","health_status":{"doc_url":"https://docs.linqapp.com/channel/imessage/guides/chats/chat-health#at-risk","status":"AT_RISK","updated_at":"2026-05-01T18:28:25Z"},"is_group":true,"owner_handle":{"id":"550e8400-e29b-41d4-a716-446655440000","handle":"+15551234567","joined_at":"2025-05-21T15:30:00.000-05:00","service":"iMessage","is_me":false,"left_at":"2019-12-27T18:11:19.117Z","status":"active"}},"direction":"outbound","parts":[{"type":"text","value":"Hello!","mention":"+14155551234","mention_range":[4,9],"mentions":[{"handle":"+14155550123","is_me":true,"range":[4,9]}],"text_decorations":[{"range":[0,5],"animation":"shake","style":"bold"}]}],"sender_handle":{"id":"550e8400-e29b-41d4-a716-446655440000","handle":"+15551234567","joined_at":"2025-05-21T15:30:00.000-05:00","service":"iMessage","is_me":false,"left_at":"2019-12-27T18:11:19.117Z","status":"active"},"service":"iMessage","delivered_at":"2026-01-30T20:49:20.352Z","effect":{"name":"gentle","type":"bubble"},"idempotency_key":"unique-key","preferred_service":"iMessage","read_at":null,"reconciled_at":"2026-01-30T22:05:00.000Z","reply_to":{"message_id":"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e","part_index":0},"sent_at":"2026-01-30T20:49:19.704Z"},"event_id":"550e8400-e29b-41d4-a716-446655440000","event_type":"message.sent","partner_id":"partner_abc123","trace_id":"abc123def456","webhook_version":"2025-01-01"}"""
         msg_id = "1"
         timestamp = datetime.now(tz=timezone.utc)
         sig = hook.sign(msg_id=msg_id, timestamp=timestamp, data=data)
@@ -78,7 +78,7 @@ class TestAsyncWebhooks:
 
         async_client = async_client.with_options(webhook_secret=client_opt)
 
-        data = """{"api_version":"v3","created_at":"2025-11-23T17:30:00Z","data":{"id":"550e8400-e29b-41d4-a716-446655440001","chat":{"id":"550e8400-e29b-41d4-a716-446655440000","health_status":{"doc_url":"https://docs.linqapp.com/guides/chats/chat-health#at-risk","status":"AT_RISK","updated_at":"2026-05-01T18:28:25Z"},"is_group":true,"owner_handle":{"id":"550e8400-e29b-41d4-a716-446655440000","handle":"+15551234567","joined_at":"2025-05-21T15:30:00.000-05:00","service":"iMessage","is_me":false,"left_at":"2019-12-27T18:11:19.117Z","status":"active"}},"direction":"outbound","parts":[{"type":"text","value":"Hello!","mention":"+14155551234","mention_range":[4,9],"mentions":[{"handle":"+14155550123","is_me":true,"range":[4,9]}],"text_decorations":[{"range":[0,5],"animation":"shake","style":"bold"}]}],"sender_handle":{"id":"550e8400-e29b-41d4-a716-446655440000","handle":"+15551234567","joined_at":"2025-05-21T15:30:00.000-05:00","service":"iMessage","is_me":false,"left_at":"2019-12-27T18:11:19.117Z","status":"active"},"service":"iMessage","delivered_at":"2026-01-30T20:49:20.352Z","effect":{"name":"gentle","type":"bubble"},"idempotency_key":"unique-key","preferred_service":"iMessage","read_at":null,"reconciled_at":"2026-01-30T22:05:00.000Z","reply_to":{"message_id":"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e","part_index":0},"sent_at":"2026-01-30T20:49:19.704Z"},"event_id":"550e8400-e29b-41d4-a716-446655440000","event_type":"message.sent","partner_id":"partner_abc123","trace_id":"abc123def456","webhook_version":"2025-01-01"}"""
+        data = """{"api_version":"v3","created_at":"2025-11-23T17:30:00Z","data":{"id":"550e8400-e29b-41d4-a716-446655440001","chat":{"id":"550e8400-e29b-41d4-a716-446655440000","health_status":{"doc_url":"https://docs.linqapp.com/channel/imessage/guides/chats/chat-health#at-risk","status":"AT_RISK","updated_at":"2026-05-01T18:28:25Z"},"is_group":true,"owner_handle":{"id":"550e8400-e29b-41d4-a716-446655440000","handle":"+15551234567","joined_at":"2025-05-21T15:30:00.000-05:00","service":"iMessage","is_me":false,"left_at":"2019-12-27T18:11:19.117Z","status":"active"}},"direction":"outbound","parts":[{"type":"text","value":"Hello!","mention":"+14155551234","mention_range":[4,9],"mentions":[{"handle":"+14155550123","is_me":true,"range":[4,9]}],"text_decorations":[{"range":[0,5],"animation":"shake","style":"bold"}]}],"sender_handle":{"id":"550e8400-e29b-41d4-a716-446655440000","handle":"+15551234567","joined_at":"2025-05-21T15:30:00.000-05:00","service":"iMessage","is_me":false,"left_at":"2019-12-27T18:11:19.117Z","status":"active"},"service":"iMessage","delivered_at":"2026-01-30T20:49:20.352Z","effect":{"name":"gentle","type":"bubble"},"idempotency_key":"unique-key","preferred_service":"iMessage","read_at":null,"reconciled_at":"2026-01-30T22:05:00.000Z","reply_to":{"message_id":"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e","part_index":0},"sent_at":"2026-01-30T20:49:19.704Z"},"event_id":"550e8400-e29b-41d4-a716-446655440000","event_type":"message.sent","partner_id":"partner_abc123","trace_id":"abc123def456","webhook_version":"2025-01-01"}"""
         msg_id = "1"
         timestamp = datetime.now(tz=timezone.utc)
         sig = hook.sign(msg_id=msg_id, timestamp=timestamp, data=data)

{linq_python-0.39.0 → linq_python-0.40.0}/uv.lock

@@ -530,7 +530,7 @@ wheels = [
 
 [[package]]
 name = "linq-python"
-version = "0.38.0"
+version = "0.39.1"
 source = { editable = "." }
 dependencies = [
     { name = "anyio" },

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

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