linq-python 0.56.1__tar.gz → 0.57.0__tar.gz

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

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

{linq_python-0.56.1 → linq_python-0.57.0}/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.57.0](https://github.com/linq-team/linq-python/compare/v0.56.2...v0.57.0) (2026-09-19)
+
+
+### Features
+
+* add delivery affinity routing headers to webhook subscriptions ([74295f8](https://github.com/linq-team/linq-python/commit/74295f85328cf5f56380ba5fcc4dd11b8ab718b3))
+
+## [0.56.2](https://github.com/linq-team/linq-python/compare/v0.56.1...v0.56.2) (2026-09-18)
+
+
+### Documentation
+
+* clarify message transport behavior for newly created chats ([55c1d50](https://github.com/linq-team/linq-python/commit/55c1d50fd9a6abb5dffbb03cf200d6428c577b4a))
+
 ## [0.56.1](https://github.com/linq-team/linq-python/compare/v0.56.0...v0.56.1) (2026-09-16)
 
 

{linq_python-0.56.1 → linq_python-0.57.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: linq-python
-Version: 0.56.1
+Version: 0.57.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.56.1 → linq_python-0.57.0}/pyproject.toml

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

{linq_python-0.56.1 → linq_python-0.57.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.56.1"  # x-release-please-version
+__version__ = "0.57.0"  # x-release-please-version

{linq_python-0.56.1 → linq_python-0.57.0}/src/linq/resources/webhook_subscriptions.py

@@ -180,6 +180,8 @@ class WebhookSubscriptionsResource(SyncAPIResource):
         subscribed_events: List[WebhookEventType],
         target_url: str,
         phone_numbers: SequenceNotStr[str] | Omit = omit,
+        routing_id_header: str | Omit = omit,
+        routing_key_header: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -229,6 +231,14 @@ class WebhookSubscriptionsResource(SyncAPIResource):
               empty, events from all phone numbers are delivered. Phone numbers must be in
               E.164 format.
 
+          routing_id_header: Name of the header carrying the chat id, used to hash-route before a token is
+              learned. Defaults to `Linq-Chat-Id`. Ignored without `routing_key_header`.
+
+          routing_key_header:
+              Enables delivery affinity. Name of the header carrying an opaque routing token:
+              we send it on each webhook for a chat and read it back from your 2xx response,
+              so your edge can route to the cluster holding that chat. Omit to disable.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -244,6 +254,8 @@ class WebhookSubscriptionsResource(SyncAPIResource):
                     "subscribed_events": subscribed_events,
                     "target_url": target_url,
                     "phone_numbers": phone_numbers,
+                    "routing_id_header": routing_id_header,
+                    "routing_key_header": routing_key_header,
                 },
                 webhook_subscription_create_params.WebhookSubscriptionCreateParams,
             ),
@@ -293,6 +305,8 @@ class WebhookSubscriptionsResource(SyncAPIResource):
         *,
         is_active: bool | Omit = omit,
         phone_numbers: Optional[SequenceNotStr[str]] | Omit = omit,
+        routing_id_header: Optional[str] | Omit = omit,
+        routing_key_header: Optional[str] | Omit = omit,
         subscribed_events: List[WebhookEventType] | Omit = omit,
         target_url: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -317,6 +331,12 @@ class WebhookSubscriptionsResource(SyncAPIResource):
               the filter and receive events from all phone numbers. Phone numbers must be in
               E.164 format.
 
+          routing_id_header: Updated header name for the chat id. Set to null or an empty string to fall back
+              to `Linq-Chat-Id`.
+
+          routing_key_header: Updated header name for the routing token. Set to null or an empty string to
+              disable delivery affinity and drop the stored tokens.
+
           subscribed_events: Updated list of event types to subscribe to
 
           target_url: New target URL for webhook events
@@ -337,6 +357,8 @@ class WebhookSubscriptionsResource(SyncAPIResource):
                 {
                     "is_active": is_active,
                     "phone_numbers": phone_numbers,
+                    "routing_id_header": routing_id_header,
+                    "routing_key_header": routing_key_header,
                     "subscribed_events": subscribed_events,
                     "target_url": target_url,
                 },
@@ -560,6 +582,8 @@ class AsyncWebhookSubscriptionsResource(AsyncAPIResource):
         subscribed_events: List[WebhookEventType],
         target_url: str,
         phone_numbers: SequenceNotStr[str] | Omit = omit,
+        routing_id_header: str | Omit = omit,
+        routing_key_header: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -609,6 +633,14 @@ class AsyncWebhookSubscriptionsResource(AsyncAPIResource):
               empty, events from all phone numbers are delivered. Phone numbers must be in
               E.164 format.
 
+          routing_id_header: Name of the header carrying the chat id, used to hash-route before a token is
+              learned. Defaults to `Linq-Chat-Id`. Ignored without `routing_key_header`.
+
+          routing_key_header:
+              Enables delivery affinity. Name of the header carrying an opaque routing token:
+              we send it on each webhook for a chat and read it back from your 2xx response,
+              so your edge can route to the cluster holding that chat. Omit to disable.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -624,6 +656,8 @@ class AsyncWebhookSubscriptionsResource(AsyncAPIResource):
                     "subscribed_events": subscribed_events,
                     "target_url": target_url,
                     "phone_numbers": phone_numbers,
+                    "routing_id_header": routing_id_header,
+                    "routing_key_header": routing_key_header,
                 },
                 webhook_subscription_create_params.WebhookSubscriptionCreateParams,
             ),
@@ -673,6 +707,8 @@ class AsyncWebhookSubscriptionsResource(AsyncAPIResource):
         *,
         is_active: bool | Omit = omit,
         phone_numbers: Optional[SequenceNotStr[str]] | Omit = omit,
+        routing_id_header: Optional[str] | Omit = omit,
+        routing_key_header: Optional[str] | Omit = omit,
         subscribed_events: List[WebhookEventType] | Omit = omit,
         target_url: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -697,6 +733,12 @@ class AsyncWebhookSubscriptionsResource(AsyncAPIResource):
               the filter and receive events from all phone numbers. Phone numbers must be in
               E.164 format.
 
+          routing_id_header: Updated header name for the chat id. Set to null or an empty string to fall back
+              to `Linq-Chat-Id`.
+
+          routing_key_header: Updated header name for the routing token. Set to null or an empty string to
+              disable delivery affinity and drop the stored tokens.
+
           subscribed_events: Updated list of event types to subscribe to
 
           target_url: New target URL for webhook events
@@ -717,6 +759,8 @@ class AsyncWebhookSubscriptionsResource(AsyncAPIResource):
                 {
                     "is_active": is_active,
                     "phone_numbers": phone_numbers,
+                    "routing_id_header": routing_id_header,
+                    "routing_key_header": routing_key_header,
                     "subscribed_events": subscribed_events,
                     "target_url": target_url,
                 },

{linq_python-0.56.1 → linq_python-0.57.0}/src/linq/types/webhook_subscription.py

@@ -33,3 +33,9 @@ class WebhookSubscription(BaseModel):
 
     If null or empty, events from all phone numbers are delivered.
     """
+
+    routing_id_header: Optional[str] = None
+    """Header carrying the chat id. Defaults to `Linq-Chat-Id` when affinity is on."""
+
+    routing_key_header: Optional[str] = None
+    """Header carrying the routing token. Null disables delivery affinity."""

{linq_python-0.56.1 → linq_python-0.57.0}/src/linq/types/webhook_subscription_create_params.py

@@ -25,3 +25,17 @@ class WebhookSubscriptionCreateParams(TypedDict, total=False):
     subscription. If omitted or empty, events from all phone numbers are delivered.
     Phone numbers must be in E.164 format.
     """
+
+    routing_id_header: str
+    """
+    Name of the header carrying the chat id, used to hash-route before a token is
+    learned. Defaults to `Linq-Chat-Id`. Ignored without `routing_key_header`.
+    """
+
+    routing_key_header: str
+    """Enables delivery affinity.
+
+    Name of the header carrying an opaque routing token: we send it on each webhook
+    for a chat and read it back from your 2xx response, so your edge can route to
+    the cluster holding that chat. Omit to disable.
+    """

{linq_python-0.56.1 → linq_python-0.57.0}/src/linq/types/webhook_subscription_create_response.py

@@ -44,3 +44,9 @@ class WebhookSubscriptionCreateResponse(BaseModel):
 
     If null or empty, events from all phone numbers are delivered.
     """
+
+    routing_id_header: Optional[str] = None
+    """Header carrying the chat id. Defaults to `Linq-Chat-Id` when affinity is on."""
+
+    routing_key_header: Optional[str] = None
+    """Header carrying the routing token. Null disables delivery affinity."""

{linq_python-0.56.1 → linq_python-0.57.0}/src/linq/types/webhook_subscription_update_params.py

@@ -23,6 +23,19 @@ class WebhookSubscriptionUpdateParams(TypedDict, total=False):
     numbers. Phone numbers must be in E.164 format.
     """
 
+    routing_id_header: Optional[str]
+    """Updated header name for the chat id.
+
+    Set to null or an empty string to fall back to `Linq-Chat-Id`.
+    """
+
+    routing_key_header: Optional[str]
+    """Updated header name for the routing token.
+
+    Set to null or an empty string to disable delivery affinity and drop the stored
+    tokens.
+    """
+
     subscribed_events: List[WebhookEventType]
     """Updated list of event types to subscribe to"""
 

{linq_python-0.56.1 → linq_python-0.57.0}/tests/api_resources/test_webhook_subscriptions.py

@@ -37,6 +37,8 @@ class TestWebhookSubscriptions:
             subscribed_events=["message.sent", "message.delivered", "message.read"],
             target_url="https://webhooks.example.com/linq/events",
             phone_numbers=["+12025551234", "+12025559876"],
+            routing_id_header="x-openai-chat-id",
+            routing_key_header="x-openai-thread-route",
         )
         assert_matches_type(WebhookSubscriptionCreateResponse, webhook_subscription, path=["response"])
 
@@ -125,6 +127,8 @@ class TestWebhookSubscriptions:
             subscription_id="b2c3d4e5-f6a7-8901-bcde-f23456789012",
             is_active=True,
             phone_numbers=["+12025551234"],
+            routing_id_header="x-openai-chat-id",
+            routing_key_header="x-openai-thread-route",
             subscribed_events=["message.sent", "message.delivered"],
             target_url="https://webhooks.example.com/linq/events",
         )
@@ -256,6 +260,8 @@ class TestAsyncWebhookSubscriptions:
             subscribed_events=["message.sent", "message.delivered", "message.read"],
             target_url="https://webhooks.example.com/linq/events",
             phone_numbers=["+12025551234", "+12025559876"],
+            routing_id_header="x-openai-chat-id",
+            routing_key_header="x-openai-thread-route",
         )
         assert_matches_type(WebhookSubscriptionCreateResponse, webhook_subscription, path=["response"])
 
@@ -344,6 +350,8 @@ class TestAsyncWebhookSubscriptions:
             subscription_id="b2c3d4e5-f6a7-8901-bcde-f23456789012",
             is_active=True,
             phone_numbers=["+12025551234"],
+            routing_id_header="x-openai-chat-id",
+            routing_key_header="x-openai-thread-route",
             subscribed_events=["message.sent", "message.delivered"],
             target_url="https://webhooks.example.com/linq/events",
         )

{linq_python-0.56.1 → linq_python-0.57.0}/uv.lock

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

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

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