linq-python 0.32.0__tar.gz → 0.33.1__tar.gz

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

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

{linq_python-0.32.0 → linq_python-0.33.1}/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.33.1](https://github.com/linq-team/linq-python/compare/v0.33.0...v0.33.1) (2026-08-26)
+
+
+### Bug Fixes
+
+* add 503 response documentation to send message endpoint ([c8b5057](https://github.com/linq-team/linq-python/commit/c8b50579223cbd9eaafbe1ff7fffb2053b54e8fb))
+
+## [0.33.0](https://github.com/linq-team/linq-python/compare/v0.32.0...v0.33.0) (2026-08-26)
+
+
+### Features
+
+* add chat.background_update_failed webhook event ([5573fbf](https://github.com/linq-team/linq-python/commit/5573fbf66565dfee1337eeaec67a3bca672fbda1))
+
 ## [0.32.0](https://github.com/linq-team/linq-python/compare/v0.31.0...v0.32.0) (2026-08-25)
 
 

{linq_python-0.32.0 → linq_python-0.33.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: linq-python
-Version: 0.32.0
+Version: 0.33.1
 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,6 +31,8 @@ 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.32.0 → linq_python-0.33.1}/api.md

@@ -347,6 +347,36 @@ 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,
+    ChatBackgroundUpdateFailedWebhookEvent,
+    PhoneNumberStatusUpdatedWebhookEvent,
+    UnwrapWebhookEvent,
 )
 ```
 

{linq_python-0.32.0 → linq_python-0.33.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "linq-python"
-version = "0.32.0"
+version = "0.33.1"
 description = "The official Python library for the linq-api-v3 API"
 dynamic = ["readme"]
 license = "Apache-2.0"
@@ -42,6 +42,7 @@ 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.32.0 → linq_python-0.33.1}/src/linq/__init__.py

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

{linq_python-0.32.0 → linq_python-0.33.1}/src/linq/_client.py

@@ -56,6 +56,7 @@ 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
@@ -1016,6 +1017,12 @@ 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:
         """
@@ -2086,6 +2093,12 @@ 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.32.0 → linq_python-0.33.1}/src/linq/_exceptions.py

@@ -77,6 +77,10 @@ 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.32.0 → linq_python-0.33.1}/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.32.0"  # x-release-please-version
+__version__ = "0.33.1"  # x-release-please-version

{linq_python-0.32.0 → linq_python-0.33.1}/src/linq/resources/__init__.py

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

linq_python-0.33.1/src/linq/resources/webhooks.py

@@ -0,0 +1,69 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+import json
+from typing import Mapping, cast
+
+from .._models import construct_type
+from .._resource import SyncAPIResource, AsyncAPIResource
+from .._exceptions import LinqApiv3Error
+from ..types.unwrap_webhook_event import UnwrapWebhookEvent
+
+__all__ = ["WebhooksResource", "AsyncWebhooksResource"]
+
+
+class WebhooksResource(SyncAPIResource):
+    def unwrap(self, payload: str, *, headers: Mapping[str, str], key: str | bytes | None = None) -> UnwrapWebhookEvent:
+        try:
+            from standardwebhooks import Webhook
+        except ImportError as exc:
+            raise LinqApiv3Error("You need to install `linq-python[webhooks]` to use this method") from exc
+
+        if key is None:
+            key = self._client.webhook_secret
+            if key is None:
+                raise ValueError(
+                    "Cannot verify a webhook without a key on either the client's webhook_secret or passed in as an argument"
+                )
+
+        if not isinstance(headers, dict):
+            headers = dict(headers)
+
+        Webhook(key).verify(payload, headers)
+
+        return cast(
+            UnwrapWebhookEvent,
+            construct_type(
+                type_=UnwrapWebhookEvent,
+                value=json.loads(payload),
+            ),
+        )
+
+
+class AsyncWebhooksResource(AsyncAPIResource):
+    def unwrap(self, payload: str, *, headers: Mapping[str, str], key: str | bytes | None = None) -> UnwrapWebhookEvent:
+        try:
+            from standardwebhooks import Webhook
+        except ImportError as exc:
+            raise LinqApiv3Error("You need to install `linq-python[webhooks]` to use this method") from exc
+
+        if key is None:
+            key = self._client.webhook_secret
+            if key is None:
+                raise ValueError(
+                    "Cannot verify a webhook without a key on either the client's webhook_secret or passed in as an argument"
+                )
+
+        if not isinstance(headers, dict):
+            headers = dict(headers)
+
+        Webhook(key).verify(payload, headers)
+
+        return cast(
+            UnwrapWebhookEvent,
+            construct_type(
+                type_=UnwrapWebhookEvent,
+                value=json.loads(payload),
+            ),
+        )

{linq_python-0.32.0 → linq_python-0.33.1}/src/linq/types/__init__.py

@@ -22,6 +22,7 @@ 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
@@ -30,11 +31,13 @@ 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
@@ -44,8 +47,11 @@ 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
@@ -53,41 +59,84 @@ 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_background_update_failed_webhook_event import (
+    ChatBackgroundUpdateFailedWebhookEvent as ChatBackgroundUpdateFailedWebhookEvent,
+)
+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.33.1/src/linq/types/chat_background_update_failed_webhook_event.py

@@ -0,0 +1,71 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from datetime import datetime
+
+from .._models import BaseModel
+from .webhook_event_type import WebhookEventType
+
+__all__ = ["ChatBackgroundUpdateFailedWebhookEvent", "Data"]
+
+
+class Data(BaseModel):
+    """
+    Error details for chat.background_update_failed webhook events.
+    See [WebhookErrorCode](#/components/schemas/WebhookErrorCode) for the full error code reference.
+    """
+
+    chat_id: str
+    """Chat identifier (UUID) whose background update failed"""
+
+    error_code: int
+    """Error codes in webhook failure events.
+
+    The possible set varies by event: message.failed and poll.failed can carry 3007,
+    4001, 4002, 4005, 4006, 4007, or 4008; the group update failure events
+    (chat.group_name_update_failed, chat.group_icon_update_failed) carry 3007 or
+    4001; chat.background_update_failed carries 1005, 2011, 4001, or 5002.
+    """
+
+    failed_at: datetime
+    """When the failure was detected"""
+
+
+class ChatBackgroundUpdateFailedWebhookEvent(BaseModel):
+    """Complete webhook payload for chat.background_update_failed events"""
+
+    api_version: str
+    """API version for the webhook payload format"""
+
+    created_at: datetime
+    """When the event was created"""
+
+    data: Data
+    """
+    Error details for chat.background_update_failed webhook events. See
+    [WebhookErrorCode](#/components/schemas/WebhookErrorCode) for the full error
+    code reference.
+    """
+
+    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.33.1/src/linq/types/chat_background_updated_webhook_event.py

@@ -0,0 +1,101 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+from datetime import datetime
+from typing_extensions import Literal
+
+from .._models import BaseModel
+from .shared.chat_handle import ChatHandle
+from .webhook_event_type import WebhookEventType
+
+__all__ = ["ChatBackgroundUpdatedWebhookEvent", "Data", "DataChat", "DataBackground"]
+
+
+class DataChat(BaseModel):
+    """Chat information"""
+
+    id: str
+    """Chat identifier"""
+
+    is_group: Optional[bool] = None
+    """Whether this is a group chat"""
+
+    owner_handle: Optional[ChatHandle] = None
+    """Your phone number's handle. Always has is_me=true."""
+
+
+class DataBackground(BaseModel):
+    """A chat transcript background. Fields are populated per `type`."""
+
+    type: Literal["color", "dynamic", "photo"]
+    """The background family."""
+
+    image_url: Optional[str] = None
+    """
+    Photo: a hosted URL for the background image, whether you set it or a
+    participant did. Apple stores the image, not the URL it came from, so the image
+    is re-hosted and this is our URL rather than the one you supplied. `null` only
+    if the image could not be hosted.
+    """
+
+    shades: Optional[List[str]] = None
+    """Color: the two gradient stops as hex, top then bottom."""
+
+    style: Optional[Literal["sky", "water", "aurora", "glitter"]] = None
+    """Dynamic: the animated style."""
+
+    variant: Optional[str] = None
+    """Color: `custom` (the stored two colors) or a named swatch.
+
+    Dynamic: the variant within the `style` (e.g. `sunrise`).
+    """
+
+
+class Data(BaseModel):
+    """Payload for chat.background_updated webhook events."""
+
+    chat: DataChat
+    """Chat information"""
+
+    actor_handle: Optional[ChatHandle] = None
+    """Who changed it. `is_me` is true when your own number set it."""
+
+    background: Optional[DataBackground] = None
+    """A chat transcript background. Fields are populated per `type`."""
+
+
+class ChatBackgroundUpdatedWebhookEvent(BaseModel):
+    """Complete webhook payload for chat.background_updated events"""
+
+    api_version: str
+    """API version for the webhook payload format"""
+
+    created_at: datetime
+    """When the event was created"""
+
+    data: Data
+    """Payload for chat.background_updated webhook events."""
+
+    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.
+    """