linq-python 0.26.0__tar.gz → 0.27.0__tar.gz

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

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

{linq_python-0.26.0 → linq_python-0.27.0}/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.27.0](https://github.com/linq-team/linq-python/compare/v0.26.0...v0.27.0) (2026-08-18)
+
+
+### Features
+
+* add chat.background_update_failed webhook event ([c6d4e0e](https://github.com/linq-team/linq-python/commit/c6d4e0e87e85ecffaf135ad9a6944de3bd528ed1))
+
 ## [0.26.0](https://github.com/linq-team/linq-python/compare/v0.25.2...v0.26.0) (2026-08-17)
 
 

{linq_python-0.26.0 → linq_python-0.27.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: linq-python
-Version: 0.26.0
+Version: 0.27.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
@@ -31,8 +31,6 @@ Requires-Dist: typing-extensions<5,>=4.14
 Provides-Extra: aiohttp
 Requires-Dist: aiohttp; extra == 'aiohttp'
 Requires-Dist: httpx-aiohttp>=0.1.9; extra == 'aiohttp'
-Provides-Extra: webhooks
-Requires-Dist: standardwebhooks<2,>=1.0.1; extra == 'webhooks'
 Description-Content-Type: text/markdown
 
 # Linq API V3 Python API library

{linq_python-0.26.0 → linq_python-0.27.0}/api.md

@@ -347,35 +347,6 @@ from linq.types import (
     SchemasMediaPartResponse,
     SchemasMessageEffect,
     SchemasTextPartResponse,
-    MessageSentWebhookEvent,
-    MessageReceivedWebhookEvent,
-    MessageReadWebhookEvent,
-    MessageDeliveredWebhookEvent,
-    MessageFailedWebhookEvent,
-    MessageEditedWebhookEvent,
-    ReactionAddedWebhookEvent,
-    ReactionRemovedWebhookEvent,
-    PollReceivedWebhookEvent,
-    PollSentWebhookEvent,
-    PollDeliveredWebhookEvent,
-    PollReadWebhookEvent,
-    PollUpdatedWebhookEvent,
-    PollFailedWebhookEvent,
-    PollVoteAddedWebhookEvent,
-    PollVoteRemovedWebhookEvent,
-    PollReactionAddedWebhookEvent,
-    ParticipantAddedWebhookEvent,
-    ParticipantRemovedWebhookEvent,
-    ChatCreatedWebhookEvent,
-    ChatGroupNameUpdatedWebhookEvent,
-    ChatGroupIconUpdatedWebhookEvent,
-    ChatGroupNameUpdateFailedWebhookEvent,
-    ChatGroupIconUpdateFailedWebhookEvent,
-    ChatTypingIndicatorStartedWebhookEvent,
-    ChatTypingIndicatorStoppedWebhookEvent,
-    ChatBackgroundUpdatedWebhookEvent,
-    PhoneNumberStatusUpdatedWebhookEvent,
-    UnwrapWebhookEvent,
 )
 ```
 

{linq_python-0.26.0 → linq_python-0.27.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "linq-python"
-version = "0.26.0"
+version = "0.27.0"
 description = "The official Python library for the linq-api-v3 API"
 dynamic = ["readme"]
 license = "Apache-2.0"
@@ -42,7 +42,6 @@ Repository = "https://github.com/linq-team/linq-python"
 
 [project.optional-dependencies]
 aiohttp = ["aiohttp", "httpx_aiohttp>=0.1.9"]
-webhooks = ["standardwebhooks >= 1.0.1, < 2"]
 
 [tool.uv]
 managed = true

{linq_python-0.26.0 → linq_python-0.27.0}/src/linq/__init__.py

@@ -34,7 +34,6 @@ from ._exceptions import (
     InternalServerError,
     PermissionDeniedError,
     UnprocessableEntityError,
-    APIWebhookValidationError,
     APIResponseValidationError,
 )
 from ._base_client import DefaultHttpxClient, DefaultAioHttpClient, DefaultAsyncHttpxClient
@@ -58,7 +57,6 @@ __all__ = [
     "APITimeoutError",
     "APIConnectionError",
     "APIResponseValidationError",
-    "APIWebhookValidationError",
     "BadRequestError",
     "AuthenticationError",
     "PermissionDeniedError",

{linq_python-0.26.0 → linq_python-0.27.0}/src/linq/_client.py

@@ -56,7 +56,6 @@ if TYPE_CHECKING:
         webhook_subscriptions,
     )
     from .resources.payments import PaymentsResource, AsyncPaymentsResource
-    from .resources.webhooks import WebhooksResource, AsyncWebhooksResource
     from .resources.capability import CapabilityResource, AsyncCapabilityResource
     from .resources.attachments import AttachmentsResource, AsyncAttachmentsResource
     from .resources.chats.chats import ChatsResource, AsyncChatsResource
@@ -1017,12 +1016,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:
         """
@@ -2093,12 +2086,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:
         """

{linq_python-0.26.0 → linq_python-0.27.0}/src/linq/_exceptions.py

@@ -77,10 +77,6 @@ class APIResponseValidationError(APIError):
         self.status_code = response.status_code
 
 
-class APIWebhookValidationError(APIError):
-    pass
-
-
 class APIStatusError(APIError):
     """Raised when an API response has a status code of 4xx or 5xx."""
 

{linq_python-0.26.0 → linq_python-0.27.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.26.0"  # x-release-please-version
+__version__ = "0.27.0"  # x-release-please-version

{linq_python-0.26.0 → linq_python-0.27.0}/src/linq/resources/__init__.py

@@ -24,7 +24,6 @@ from .payments import (
     PaymentsResourceWithStreamingResponse,
     AsyncPaymentsResourceWithStreamingResponse,
 )
-from .webhooks import WebhooksResource, AsyncWebhooksResource
 from .capability import (
     CapabilityResource,
     AsyncCapabilityResource,
@@ -221,8 +220,6 @@ __all__ = [
     "AsyncCapabilityResourceWithRawResponse",
     "CapabilityResourceWithStreamingResponse",
     "AsyncCapabilityResourceWithStreamingResponse",
-    "WebhooksResource",
-    "AsyncWebhooksResource",
     "ContactCardResource",
     "AsyncContactCardResource",
     "ContactCardResourceWithRawResponse",

{linq_python-0.26.0 → linq_python-0.27.0}/src/linq/resources/chats/background.py

@@ -116,7 +116,7 @@ class BackgroundResource(SyncAPIResource):
         Provide one of: a **color** (a named preset or a custom 2-stop gradient), a
         **dynamic** animated style, or a **photo** (by URL). The request is accepted
         asynchronously; the terminal result arrives via the `chat.background_updated`
-        webhook.
+        webhook on success, or `chat.background_update_failed` on failure.
 
         **Group chats are supported.** Requests for RCS or SMS chats are accepted
         (`202`) but no background is applied and no `chat.background_updated` webhook
@@ -125,7 +125,11 @@ class BackgroundResource(SyncAPIResource):
         Args:
           type: The background family.
 
-          image_url: Photo: the image URL to embed in the background.
+          image_url: Photo: the image URL to embed in the background. Must be an absolute `https` URL
+              pointing at an image (`.jpg`, `.png`, `.heic`, `.webp`), and the image is
+              fetched and re-hosted on our CDN before the request is accepted — the same way
+              `group_chat_icon` works. A URL we cannot fetch, or one that isn't an image, is
+              rejected with a `400` (`5007`/`5006`) rather than failing later on the device.
 
           shades: Color with `variant: custom`: the two gradient stops as hex, top then bottom.
               Ignored for named color variants (they carry their own two colors).
@@ -264,7 +268,7 @@ class AsyncBackgroundResource(AsyncAPIResource):
         Provide one of: a **color** (a named preset or a custom 2-stop gradient), a
         **dynamic** animated style, or a **photo** (by URL). The request is accepted
         asynchronously; the terminal result arrives via the `chat.background_updated`
-        webhook.
+        webhook on success, or `chat.background_update_failed` on failure.
 
         **Group chats are supported.** Requests for RCS or SMS chats are accepted
         (`202`) but no background is applied and no `chat.background_updated` webhook
@@ -273,7 +277,11 @@ class AsyncBackgroundResource(AsyncAPIResource):
         Args:
           type: The background family.
 
-          image_url: Photo: the image URL to embed in the background.
+          image_url: Photo: the image URL to embed in the background. Must be an absolute `https` URL
+              pointing at an image (`.jpg`, `.png`, `.heic`, `.webp`), and the image is
+              fetched and re-hosted on our CDN before the request is accepted — the same way
+              `group_chat_icon` works. A URL we cannot fetch, or one that isn't an image, is
+              rejected with a `400` (`5007`/`5006`) rather than failing later on the device.
 
           shades: Color with `variant: custom`: the two gradient stops as hex, top then bottom.
               Ignored for named color variants (they carry their own two colors).

{linq_python-0.26.0 → linq_python-0.27.0}/src/linq/types/__init__.py

@@ -22,7 +22,6 @@ from .link_part_param import LinkPartParam as LinkPartParam
 from .payment_request import PaymentRequest as PaymentRequest
 from .text_part_param import TextPartParam as TextPartParam
 from .media_part_param import MediaPartParam as MediaPartParam
-from .message_event_v2 import MessageEventV2 as MessageEventV2
 from .payment_provider import PaymentProvider as PaymentProvider
 from .reputation_audit import ReputationAudit as ReputationAudit
 from .set_contact_card import SetContactCard as SetContactCard
@@ -31,13 +30,11 @@ from .reputation_report import ReputationReport as ReputationReport
 from .chat_create_params import ChatCreateParams as ChatCreateParams
 from .chat_update_params import ChatUpdateParams as ChatUpdateParams
 from .webhook_event_type import WebhookEventType as WebhookEventType
-from .reaction_event_base import ReactionEventBase as ReactionEventBase
 from .reputation_evidence import ReputationEvidence as ReputationEvidence
 from .blocked_handle_entry import BlockedHandleEntry as BlockedHandleEntry
 from .chat_create_response import ChatCreateResponse as ChatCreateResponse
 from .chat_update_response import ChatUpdateResponse as ChatUpdateResponse
 from .message_effect_param import MessageEffectParam as MessageEffectParam
-from .unwrap_webhook_event import UnwrapWebhookEvent as UnwrapWebhookEvent
 from .webhook_subscription import WebhookSubscription as WebhookSubscription
 from .handle_check_response import HandleCheckResponse as HandleCheckResponse
 from .message_content_param import MessageContentParam as MessageContentParam
@@ -47,11 +44,8 @@ from .payment_create_params import PaymentCreateParams as PaymentCreateParams
 from .reputation_driver_key import ReputationDriverKey as ReputationDriverKey
 from .chat_list_chats_params import ChatListChatsParams as ChatListChatsParams
 from .reputation_action_item import ReputationActionItem as ReputationActionItem
-from .schemas_message_effect import SchemasMessageEffect as SchemasMessageEffect
 from .supported_content_type import SupportedContentType as SupportedContentType
 from .message_create_response import MessageCreateResponse as MessageCreateResponse
-from .poll_read_webhook_event import PollReadWebhookEvent as PollReadWebhookEvent
-from .poll_sent_webhook_event import PollSentWebhookEvent as PollSentWebhookEvent
 from .reputation_opt_out_chat import ReputationOptOutChat as ReputationOptOutChat
 from .attachment_create_params import AttachmentCreateParams as AttachmentCreateParams
 from .chat_leave_chat_response import ChatLeaveChatResponse as ChatLeaveChatResponse
@@ -59,81 +53,41 @@ from .experience_list_response import ExperienceListResponse as ExperienceListRe
 from .reputation_audit_started import ReputationAuditStarted as ReputationAuditStarted
 from .payment_handle_connection import PaymentHandleConnection as PaymentHandleConnection
 from .phonenumber_list_response import PhonenumberListResponse as PhonenumberListResponse
-from .poll_failed_webhook_event import PollFailedWebhookEvent as PollFailedWebhookEvent
 from .reputation_unhealthy_chat import ReputationUnhealthyChat as ReputationUnhealthyChat
 from .attachment_create_response import AttachmentCreateResponse as AttachmentCreateResponse
-from .chat_created_webhook_event import ChatCreatedWebhookEvent as ChatCreatedWebhookEvent
 from .chat_send_voicememo_params import ChatSendVoicememoParams as ChatSendVoicememoParams
 from .contact_card_create_params import ContactCardCreateParams as ContactCardCreateParams
 from .contact_card_update_params import ContactCardUpdateParams as ContactCardUpdateParams
-from .message_read_webhook_event import MessageReadWebhookEvent as MessageReadWebhookEvent
-from .message_sent_webhook_event import MessageSentWebhookEvent as MessageSentWebhookEvent
 from .phone_number_list_response import PhoneNumberListResponse as PhoneNumberListResponse
 from .phone_number_update_params import PhoneNumberUpdateParams as PhoneNumberUpdateParams
-from .poll_updated_webhook_event import PollUpdatedWebhookEvent as PollUpdatedWebhookEvent
-from .schemas_text_part_response import SchemasTextPartResponse as SchemasTextPartResponse
 from .blocked_handle_block_params import BlockedHandleBlockParams as BlockedHandleBlockParams
 from .capability_check_RCS_params import CapabilityCheckRCSParams as CapabilityCheckRCSParams
 from .message_add_reaction_params import MessageAddReactionParams as MessageAddReactionParams
 from .payment_request_list_params import PaymentRequestListParams as PaymentRequestListParams
-from .poll_received_webhook_event import PollReceivedWebhookEvent as PollReceivedWebhookEvent
-from .schemas_media_part_response import SchemasMediaPartResponse as SchemasMediaPartResponse
 from .webhook_event_list_response import WebhookEventListResponse as WebhookEventListResponse
 from .attachment_retrieve_response import AttachmentRetrieveResponse as AttachmentRetrieveResponse
 from .blocked_handle_list_response import BlockedHandleListResponse as BlockedHandleListResponse
 from .chat_send_voicememo_response import ChatSendVoicememoResponse as ChatSendVoicememoResponse
 from .contact_card_retrieve_params import ContactCardRetrieveParams as ContactCardRetrieveParams
 from .experience_retrieve_response import ExperienceRetrieveResponse as ExperienceRetrieveResponse
-from .message_edited_webhook_event import MessageEditedWebhookEvent as MessageEditedWebhookEvent
-from .message_failed_webhook_event import MessageFailedWebhookEvent as MessageFailedWebhookEvent
 from .payment_credentials_response import PaymentCredentialsResponse as PaymentCredentialsResponse
 from .payment_handle_verify_params import PaymentHandleVerifyParams as PaymentHandleVerifyParams
 from .phone_number_update_response import PhoneNumberUpdateResponse as PhoneNumberUpdateResponse
-from .poll_delivered_webhook_event import PollDeliveredWebhookEvent as PollDeliveredWebhookEvent
-from .reaction_added_webhook_event import ReactionAddedWebhookEvent as ReactionAddedWebhookEvent
 from .blocked_handle_block_response import BlockedHandleBlockResponse as BlockedHandleBlockResponse
 from .blocked_handle_unblock_params import BlockedHandleUnblockParams as BlockedHandleUnblockParams
 from .message_add_reaction_response import MessageAddReactionResponse as MessageAddReactionResponse
 from .payment_request_create_params import PaymentRequestCreateParams as PaymentRequestCreateParams
 from .payment_request_list_response import PaymentRequestListResponse as PaymentRequestListResponse
-from .poll_vote_added_webhook_event import PollVoteAddedWebhookEvent as PollVoteAddedWebhookEvent
 from .contact_card_retrieve_response import ContactCardRetrieveResponse as ContactCardRetrieveResponse
-from .message_received_webhook_event import MessageReceivedWebhookEvent as MessageReceivedWebhookEvent
 from .message_update_app_card_params import MessageUpdateAppCardParams as MessageUpdateAppCardParams
-from .reaction_removed_webhook_event import ReactionRemovedWebhookEvent as ReactionRemovedWebhookEvent
-from .message_delivered_webhook_event import MessageDeliveredWebhookEvent as MessageDeliveredWebhookEvent
-from .participant_added_webhook_event import ParticipantAddedWebhookEvent as ParticipantAddedWebhookEvent
 from .payment_provider_connect_params import PaymentProviderConnectParams as PaymentProviderConnectParams
-from .poll_vote_removed_webhook_event import PollVoteRemovedWebhookEvent as PollVoteRemovedWebhookEvent
 from .available_number_retrieve_params import AvailableNumberRetrieveParams as AvailableNumberRetrieveParams
 from .message_update_app_card_response import MessageUpdateAppCardResponse as MessageUpdateAppCardResponse
 from .capability_check_i_message_params import CapabilityCheckIMessageParams as CapabilityCheckIMessageParams
-from .participant_removed_webhook_event import ParticipantRemovedWebhookEvent as ParticipantRemovedWebhookEvent
 from .payment_provider_connect_response import PaymentProviderConnectResponse as PaymentProviderConnectResponse
-from .poll_reaction_added_webhook_event import PollReactionAddedWebhookEvent as PollReactionAddedWebhookEvent
 from .available_number_retrieve_response import AvailableNumberRetrieveResponse as 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 .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 (
-    ChatBackgroundUpdatedWebhookEvent as ChatBackgroundUpdatedWebhookEvent,
-)
-from .chat_group_icon_updated_webhook_event import ChatGroupIconUpdatedWebhookEvent as ChatGroupIconUpdatedWebhookEvent
-from .chat_group_name_updated_webhook_event import ChatGroupNameUpdatedWebhookEvent as ChatGroupNameUpdatedWebhookEvent
-from .phone_number_status_updated_webhook_event import (
-    PhoneNumberStatusUpdatedWebhookEvent as PhoneNumberStatusUpdatedWebhookEvent,
-)
-from .chat_group_icon_update_failed_webhook_event import (
-    ChatGroupIconUpdateFailedWebhookEvent as ChatGroupIconUpdateFailedWebhookEvent,
-)
-from .chat_group_name_update_failed_webhook_event import (
-    ChatGroupNameUpdateFailedWebhookEvent as ChatGroupNameUpdateFailedWebhookEvent,
-)
-from .chat_typing_indicator_started_webhook_event import (
-    ChatTypingIndicatorStartedWebhookEvent as ChatTypingIndicatorStartedWebhookEvent,
-)
-from .chat_typing_indicator_stopped_webhook_event import (
-    ChatTypingIndicatorStoppedWebhookEvent as ChatTypingIndicatorStoppedWebhookEvent,
-)

{linq_python-0.26.0 → linq_python-0.27.0}/src/linq/types/chats/background_set_params.py

@@ -14,7 +14,14 @@ class BackgroundSetParams(TypedDict, total=False):
     """The background family."""
 
     image_url: str
-    """Photo: the image URL to embed in the background."""
+    """Photo: the image URL to embed in the background.
+
+    Must be an absolute `https` URL pointing at an image (`.jpg`, `.png`, `.heic`,
+    `.webp`), and the image is fetched and re-hosted on our CDN before the request
+    is accepted — the same way `group_chat_icon` works. A URL we cannot fetch, or
+    one that isn't an image, is rejected with a `400` (`5007`/`5006`) rather than
+    failing later on the device.
+    """
 
     shades: SequenceNotStr[str]
     """

{linq_python-0.26.0 → linq_python-0.27.0}/src/linq/types/webhook_event_type.py

@@ -30,6 +30,7 @@ WebhookEventType: TypeAlias = Literal[
     "chat.group_name_update_failed",
     "chat.group_icon_update_failed",
     "chat.background_updated",
+    "chat.background_update_failed",
     "chat.typing_indicator.started",
     "chat.typing_indicator.stopped",
     "phone_number.status_updated",