linq-python 0.24.0__tar.gz → 0.25.0__tar.gz

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

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

{linq_python-0.24.0 → linq_python-0.25.0}/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.25.0](https://github.com/linq-team/linq-python/compare/v0.24.1...v0.25.0) (2026-08-14)
+
+
+### Features
+
+* add chat background and poll features ([44aa466](https://github.com/linq-team/linq-python/commit/44aa466ba2f216267d9fc00d5172790f84bd3c9e))
+
+## [0.24.1](https://github.com/linq-team/linq-python/compare/v0.24.0...v0.24.1) (2026-08-14)
+
+
+### Bug Fixes
+
+* clarify chat health status guidance and opt-out behavior ([17f6c3e](https://github.com/linq-team/linq-python/commit/17f6c3e46e71a0a325dcb3639444dc7423640127))
+
 ## [0.24.0](https://github.com/linq-team/linq-python/compare/v0.23.1...v0.24.0) (2026-08-14)
 
 

{linq_python-0.24.0 → linq_python-0.25.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: linq-python
-Version: 0.24.0
+Version: 0.25.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.24.0 → linq_python-0.25.0}/api.md

@@ -100,6 +100,13 @@ Methods:
 
 - <code title="post /v3/chats/{chatId}/polls">client.chats.polls.<a href="./src/linq/resources/chats/polls.py">create</a>(chat_id, \*\*<a href="src/linq/types/chats/poll_create_params.py">params</a>) -> <a href="./src/linq/types/chats/poll_envelope.py">PollEnvelope</a></code>
 
+## Background
+
+Methods:
+
+- <code title="delete /v3/chats/{chatId}/background">client.chats.background.<a href="./src/linq/resources/chats/background.py">remove</a>(chat_id) -> None</code>
+- <code title="post /v3/chats/{chatId}/background">client.chats.background.<a href="./src/linq/resources/chats/background.py">set</a>(chat_id, \*\*<a href="src/linq/types/chats/background_set_params.py">params</a>) -> None</code>
+
 # Messages
 
 Types:
@@ -348,6 +355,15 @@ from linq.types import (
     MessageEditedWebhookEvent,
     ReactionAddedWebhookEvent,
     ReactionRemovedWebhookEvent,
+    PollReceivedWebhookEvent,
+    PollSentWebhookEvent,
+    PollDeliveredWebhookEvent,
+    PollReadWebhookEvent,
+    PollUpdatedWebhookEvent,
+    PollFailedWebhookEvent,
+    PollVoteAddedWebhookEvent,
+    PollVoteRemovedWebhookEvent,
+    PollReactionAddedWebhookEvent,
     ParticipantAddedWebhookEvent,
     ParticipantRemovedWebhookEvent,
     ChatCreatedWebhookEvent,
@@ -357,6 +373,7 @@ from linq.types import (
     ChatGroupIconUpdateFailedWebhookEvent,
     ChatTypingIndicatorStartedWebhookEvent,
     ChatTypingIndicatorStoppedWebhookEvent,
+    ChatBackgroundUpdatedWebhookEvent,
     PhoneNumberStatusUpdatedWebhookEvent,
     UnwrapWebhookEvent,
 )

{linq_python-0.24.0 → linq_python-0.25.0}/pyproject.toml

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

{linq_python-0.24.0 → linq_python-0.25.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.24.0"  # x-release-please-version
+__version__ = "0.25.0"  # x-release-please-version

{linq_python-0.24.0 → linq_python-0.25.0}/src/linq/resources/chats/__init__.py

@@ -40,6 +40,14 @@ from .messages import (
     MessagesResourceWithStreamingResponse,
     AsyncMessagesResourceWithStreamingResponse,
 )
+from .background import (
+    BackgroundResource,
+    AsyncBackgroundResource,
+    BackgroundResourceWithRawResponse,
+    AsyncBackgroundResourceWithRawResponse,
+    BackgroundResourceWithStreamingResponse,
+    AsyncBackgroundResourceWithStreamingResponse,
+)
 from .participants import (
     ParticipantsResource,
     AsyncParticipantsResource,
@@ -80,6 +88,12 @@ __all__ = [
     "AsyncPollsResourceWithRawResponse",
     "PollsResourceWithStreamingResponse",
     "AsyncPollsResourceWithStreamingResponse",
+    "BackgroundResource",
+    "AsyncBackgroundResource",
+    "BackgroundResourceWithRawResponse",
+    "AsyncBackgroundResourceWithRawResponse",
+    "BackgroundResourceWithStreamingResponse",
+    "AsyncBackgroundResourceWithStreamingResponse",
     "ChatsResource",
     "AsyncChatsResource",
     "ChatsResourceWithRawResponse",

linq_python-0.25.0/src/linq/resources/chats/background.py

@@ -0,0 +1,366 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Literal
+
+import httpx
+
+from ..._types import Body, Omit, Query, Headers, NoneType, NotGiven, SequenceNotStr, omit, not_given
+from ..._utils import path_template, maybe_transform, async_maybe_transform
+from ..._compat import cached_property
+from ..._resource import SyncAPIResource, AsyncAPIResource
+from ..._response import (
+    to_raw_response_wrapper,
+    to_streamed_response_wrapper,
+    async_to_raw_response_wrapper,
+    async_to_streamed_response_wrapper,
+)
+from ...types.chats import background_set_params
+from ..._base_client import make_request_options
+
+__all__ = ["BackgroundResource", "AsyncBackgroundResource"]
+
+
+class BackgroundResource(SyncAPIResource):
+    """A Chat is a conversation thread with one or more participants.
+
+    To begin a chat, you must create a Chat with at least one recipient handle.
+    Including multiple handles creates a group chat.
+
+    When creating a chat, the `from` field specifies which of your
+    authorized phone numbers the message originates from. Your authentication token grants
+    access to one or more phone numbers, but the `from` field determines the actual sender.
+
+    **Handle Format:**
+    - Handles can be phone numbers or email addresses
+    - Phone numbers MUST be in E.164 format (starting with +)
+    - Phone format: `+[country code][subscriber number]`
+    - Example phone: `+12223334444` (US), `+442071234567` (UK), `+81312345678` (Japan)
+    - Example email: `user@example.com`
+    - No spaces, dashes, or parentheses in phone numbers
+    """
+
+    @cached_property
+    def with_raw_response(self) -> BackgroundResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/linq-team/linq-python#accessing-raw-response-data-eg-headers
+        """
+        return BackgroundResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> BackgroundResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/linq-team/linq-python#with_streaming_response
+        """
+        return BackgroundResourceWithStreamingResponse(self)
+
+    def remove(
+        self,
+        chat_id: str,
+        *,
+        # 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> None:
+        """
+        Remove the transcript background from a chat, resetting it to the default.
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not chat_id:
+            raise ValueError(f"Expected a non-empty value for `chat_id` but received {chat_id!r}")
+        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+        return self._delete(
+            path_template("/v3/chats/{chat_id}/background", chat_id=chat_id),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=NoneType,
+        )
+
+    def set(
+        self,
+        chat_id: str,
+        *,
+        type: Literal["color", "dynamic", "photo"],
+        image_url: str | Omit = omit,
+        shades: SequenceNotStr[str] | Omit = omit,
+        style: Literal["sky", "water", "aurora", "glitter"] | Omit = omit,
+        variant: 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> None:
+        """
+        Set the transcript background for a chat.
+
+        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.
+
+        **Group chats are supported.** Requests for RCS or SMS chats are accepted
+        (`202`) but no background is applied and no `chat.background_updated` webhook
+        fires.
+
+        Args:
+          type: The background family.
+
+          image_url: Photo: the image URL to embed in the background.
+
+          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).
+
+          style: Dynamic: the animated style.
+
+          variant: Color: a named swatch — `mango`, `ice`, `plum`, `deep_sea`, `green_apple`,
+              `cherry`, `bubblegum`, `tangerine`, `magenta`, `lime`, `silver`, `carbon`,
+              `stone` — or `custom` (supply `shades`). Dynamic: the variant within the `style`
+              (e.g. `sunrise`).
+
+              An unrecognized value still returns `202`, but no background is applied and no
+              `chat.background_updated` webhook fires. Send one of the values above.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not chat_id:
+            raise ValueError(f"Expected a non-empty value for `chat_id` but received {chat_id!r}")
+        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+        return self._post(
+            path_template("/v3/chats/{chat_id}/background", chat_id=chat_id),
+            body=maybe_transform(
+                {
+                    "type": type,
+                    "image_url": image_url,
+                    "shades": shades,
+                    "style": style,
+                    "variant": variant,
+                },
+                background_set_params.BackgroundSetParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=NoneType,
+        )
+
+
+class AsyncBackgroundResource(AsyncAPIResource):
+    """A Chat is a conversation thread with one or more participants.
+
+    To begin a chat, you must create a Chat with at least one recipient handle.
+    Including multiple handles creates a group chat.
+
+    When creating a chat, the `from` field specifies which of your
+    authorized phone numbers the message originates from. Your authentication token grants
+    access to one or more phone numbers, but the `from` field determines the actual sender.
+
+    **Handle Format:**
+    - Handles can be phone numbers or email addresses
+    - Phone numbers MUST be in E.164 format (starting with +)
+    - Phone format: `+[country code][subscriber number]`
+    - Example phone: `+12223334444` (US), `+442071234567` (UK), `+81312345678` (Japan)
+    - Example email: `user@example.com`
+    - No spaces, dashes, or parentheses in phone numbers
+    """
+
+    @cached_property
+    def with_raw_response(self) -> AsyncBackgroundResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/linq-team/linq-python#accessing-raw-response-data-eg-headers
+        """
+        return AsyncBackgroundResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AsyncBackgroundResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/linq-team/linq-python#with_streaming_response
+        """
+        return AsyncBackgroundResourceWithStreamingResponse(self)
+
+    async def remove(
+        self,
+        chat_id: str,
+        *,
+        # 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> None:
+        """
+        Remove the transcript background from a chat, resetting it to the default.
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not chat_id:
+            raise ValueError(f"Expected a non-empty value for `chat_id` but received {chat_id!r}")
+        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+        return await self._delete(
+            path_template("/v3/chats/{chat_id}/background", chat_id=chat_id),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=NoneType,
+        )
+
+    async def set(
+        self,
+        chat_id: str,
+        *,
+        type: Literal["color", "dynamic", "photo"],
+        image_url: str | Omit = omit,
+        shades: SequenceNotStr[str] | Omit = omit,
+        style: Literal["sky", "water", "aurora", "glitter"] | Omit = omit,
+        variant: 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> None:
+        """
+        Set the transcript background for a chat.
+
+        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.
+
+        **Group chats are supported.** Requests for RCS or SMS chats are accepted
+        (`202`) but no background is applied and no `chat.background_updated` webhook
+        fires.
+
+        Args:
+          type: The background family.
+
+          image_url: Photo: the image URL to embed in the background.
+
+          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).
+
+          style: Dynamic: the animated style.
+
+          variant: Color: a named swatch — `mango`, `ice`, `plum`, `deep_sea`, `green_apple`,
+              `cherry`, `bubblegum`, `tangerine`, `magenta`, `lime`, `silver`, `carbon`,
+              `stone` — or `custom` (supply `shades`). Dynamic: the variant within the `style`
+              (e.g. `sunrise`).
+
+              An unrecognized value still returns `202`, but no background is applied and no
+              `chat.background_updated` webhook fires. Send one of the values above.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not chat_id:
+            raise ValueError(f"Expected a non-empty value for `chat_id` but received {chat_id!r}")
+        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+        return await self._post(
+            path_template("/v3/chats/{chat_id}/background", chat_id=chat_id),
+            body=await async_maybe_transform(
+                {
+                    "type": type,
+                    "image_url": image_url,
+                    "shades": shades,
+                    "style": style,
+                    "variant": variant,
+                },
+                background_set_params.BackgroundSetParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=NoneType,
+        )
+
+
+class BackgroundResourceWithRawResponse:
+    def __init__(self, background: BackgroundResource) -> None:
+        self._background = background
+
+        self.remove = to_raw_response_wrapper(
+            background.remove,
+        )
+        self.set = to_raw_response_wrapper(
+            background.set,
+        )
+
+
+class AsyncBackgroundResourceWithRawResponse:
+    def __init__(self, background: AsyncBackgroundResource) -> None:
+        self._background = background
+
+        self.remove = async_to_raw_response_wrapper(
+            background.remove,
+        )
+        self.set = async_to_raw_response_wrapper(
+            background.set,
+        )
+
+
+class BackgroundResourceWithStreamingResponse:
+    def __init__(self, background: BackgroundResource) -> None:
+        self._background = background
+
+        self.remove = to_streamed_response_wrapper(
+            background.remove,
+        )
+        self.set = to_streamed_response_wrapper(
+            background.set,
+        )
+
+
+class AsyncBackgroundResourceWithStreamingResponse:
+    def __init__(self, background: AsyncBackgroundResource) -> None:
+        self._background = background
+
+        self.remove = async_to_streamed_response_wrapper(
+            background.remove,
+        )
+        self.set = async_to_streamed_response_wrapper(
+            background.set,
+        )

{linq_python-0.24.0 → linq_python-0.25.0}/src/linq/resources/chats/chats.py

@@ -45,6 +45,14 @@ from .messages import (
     AsyncMessagesResourceWithStreamingResponse,
 )
 from ..._compat import cached_property
+from .background import (
+    BackgroundResource,
+    AsyncBackgroundResource,
+    BackgroundResourceWithRawResponse,
+    AsyncBackgroundResourceWithRawResponse,
+    BackgroundResourceWithStreamingResponse,
+    AsyncBackgroundResourceWithStreamingResponse,
+)
 from ..._resource import SyncAPIResource, AsyncAPIResource
 from ..._response import (
     to_raw_response_wrapper,
@@ -283,6 +291,27 @@ class ChatsResource(SyncAPIResource):
         """
         return PollsResource(self._client)
 
+    @cached_property
+    def background(self) -> BackgroundResource:
+        """A Chat is a conversation thread with one or more participants.
+
+        To begin a chat, you must create a Chat with at least one recipient handle.
+        Including multiple handles creates a group chat.
+
+        When creating a chat, the `from` field specifies which of your
+        authorized phone numbers the message originates from. Your authentication token grants
+        access to one or more phone numbers, but the `from` field determines the actual sender.
+
+        **Handle Format:**
+        - Handles can be phone numbers or email addresses
+        - Phone numbers MUST be in E.164 format (starting with +)
+        - Phone format: `+[country code][subscriber number]`
+        - Example phone: `+12223334444` (US), `+442071234567` (UK), `+81312345678` (Japan)
+        - Example email: `user@example.com`
+        - No spaces, dashes, or parentheses in phone numbers
+        """
+        return BackgroundResource(self._client)
+
     @cached_property
     def with_raw_response(self) -> ChatsResourceWithRawResponse:
         """
@@ -1005,6 +1034,27 @@ class AsyncChatsResource(AsyncAPIResource):
         """
         return AsyncPollsResource(self._client)
 
+    @cached_property
+    def background(self) -> AsyncBackgroundResource:
+        """A Chat is a conversation thread with one or more participants.
+
+        To begin a chat, you must create a Chat with at least one recipient handle.
+        Including multiple handles creates a group chat.
+
+        When creating a chat, the `from` field specifies which of your
+        authorized phone numbers the message originates from. Your authentication token grants
+        access to one or more phone numbers, but the `from` field determines the actual sender.
+
+        **Handle Format:**
+        - Handles can be phone numbers or email addresses
+        - Phone numbers MUST be in E.164 format (starting with +)
+        - Phone format: `+[country code][subscriber number]`
+        - Example phone: `+12223334444` (US), `+442071234567` (UK), `+81312345678` (Japan)
+        - Example email: `user@example.com`
+        - No spaces, dashes, or parentheses in phone numbers
+        """
+        return AsyncBackgroundResource(self._client)
+
     @cached_property
     def with_raw_response(self) -> AsyncChatsResourceWithRawResponse:
         """
@@ -1755,6 +1805,27 @@ class ChatsResourceWithRawResponse:
         """
         return PollsResourceWithRawResponse(self._chats.polls)
 
+    @cached_property
+    def background(self) -> BackgroundResourceWithRawResponse:
+        """A Chat is a conversation thread with one or more participants.
+
+        To begin a chat, you must create a Chat with at least one recipient handle.
+        Including multiple handles creates a group chat.
+
+        When creating a chat, the `from` field specifies which of your
+        authorized phone numbers the message originates from. Your authentication token grants
+        access to one or more phone numbers, but the `from` field determines the actual sender.
+
+        **Handle Format:**
+        - Handles can be phone numbers or email addresses
+        - Phone numbers MUST be in E.164 format (starting with +)
+        - Phone format: `+[country code][subscriber number]`
+        - Example phone: `+12223334444` (US), `+442071234567` (UK), `+81312345678` (Japan)
+        - Example email: `user@example.com`
+        - No spaces, dashes, or parentheses in phone numbers
+        """
+        return BackgroundResourceWithRawResponse(self._chats.background)
+
 
 class AsyncChatsResourceWithRawResponse:
     def __init__(self, chats: AsyncChatsResource) -> None:
@@ -1995,6 +2066,27 @@ class AsyncChatsResourceWithRawResponse:
         """
         return AsyncPollsResourceWithRawResponse(self._chats.polls)
 
+    @cached_property
+    def background(self) -> AsyncBackgroundResourceWithRawResponse:
+        """A Chat is a conversation thread with one or more participants.
+
+        To begin a chat, you must create a Chat with at least one recipient handle.
+        Including multiple handles creates a group chat.
+
+        When creating a chat, the `from` field specifies which of your
+        authorized phone numbers the message originates from. Your authentication token grants
+        access to one or more phone numbers, but the `from` field determines the actual sender.
+
+        **Handle Format:**
+        - Handles can be phone numbers or email addresses
+        - Phone numbers MUST be in E.164 format (starting with +)
+        - Phone format: `+[country code][subscriber number]`
+        - Example phone: `+12223334444` (US), `+442071234567` (UK), `+81312345678` (Japan)
+        - Example email: `user@example.com`
+        - No spaces, dashes, or parentheses in phone numbers
+        """
+        return AsyncBackgroundResourceWithRawResponse(self._chats.background)
+
 
 class ChatsResourceWithStreamingResponse:
     def __init__(self, chats: ChatsResource) -> None:
@@ -2235,6 +2327,27 @@ class ChatsResourceWithStreamingResponse:
         """
         return PollsResourceWithStreamingResponse(self._chats.polls)
 
+    @cached_property
+    def background(self) -> BackgroundResourceWithStreamingResponse:
+        """A Chat is a conversation thread with one or more participants.
+
+        To begin a chat, you must create a Chat with at least one recipient handle.
+        Including multiple handles creates a group chat.
+
+        When creating a chat, the `from` field specifies which of your
+        authorized phone numbers the message originates from. Your authentication token grants
+        access to one or more phone numbers, but the `from` field determines the actual sender.
+
+        **Handle Format:**
+        - Handles can be phone numbers or email addresses
+        - Phone numbers MUST be in E.164 format (starting with +)
+        - Phone format: `+[country code][subscriber number]`
+        - Example phone: `+12223334444` (US), `+442071234567` (UK), `+81312345678` (Japan)
+        - Example email: `user@example.com`
+        - No spaces, dashes, or parentheses in phone numbers
+        """
+        return BackgroundResourceWithStreamingResponse(self._chats.background)
+
 
 class AsyncChatsResourceWithStreamingResponse:
     def __init__(self, chats: AsyncChatsResource) -> None:
@@ -2474,3 +2587,24 @@ class AsyncChatsResourceWithStreamingResponse:
         **Important:** ephemeral applies in *both directions* — messages you send **and** messages received by the phone numbers in that scope. Because Linq can no longer return the message after 24 hours, persist anything you need to keep from the webhook payload at the time it is delivered.
         """
         return AsyncPollsResourceWithStreamingResponse(self._chats.polls)
+
+    @cached_property
+    def background(self) -> AsyncBackgroundResourceWithStreamingResponse:
+        """A Chat is a conversation thread with one or more participants.
+
+        To begin a chat, you must create a Chat with at least one recipient handle.
+        Including multiple handles creates a group chat.
+
+        When creating a chat, the `from` field specifies which of your
+        authorized phone numbers the message originates from. Your authentication token grants
+        access to one or more phone numbers, but the `from` field determines the actual sender.
+
+        **Handle Format:**
+        - Handles can be phone numbers or email addresses
+        - Phone numbers MUST be in E.164 format (starting with +)
+        - Phone format: `+[country code][subscriber number]`
+        - Example phone: `+12223334444` (US), `+442071234567` (UK), `+81312345678` (Japan)
+        - Example email: `user@example.com`
+        - No spaces, dashes, or parentheses in phone numbers
+        """
+        return AsyncBackgroundResourceWithStreamingResponse(self._chats.background)