linq-python 0.43.0__tar.gz → 0.45.0__tar.gz

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

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

{linq_python-0.43.0 → linq_python-0.45.0}/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.45.0](https://github.com/linq-team/linq-python/compare/v0.44.0...v0.45.0) (2026-09-05)
+
+
+### Features
+
+* add zero_retention field to message responses ([1c47484](https://github.com/linq-team/linq-python/commit/1c474846e44ec3c830bac2acfe97ba8b0fec5650))
+
+## [0.44.0](https://github.com/linq-team/linq-python/compare/v0.43.0...v0.44.0) (2026-09-05)
+
+
+### Features
+
+* add sticker reactions and placement adjustment ([de31a11](https://github.com/linq-team/linq-python/commit/de31a112a43dd89c42116fef0bd01cf8a3811976))
+
 ## [0.43.0](https://github.com/linq-team/linq-python/compare/v0.42.0...v0.43.0) (2026-09-04)
 
 

{linq_python-0.43.0 → linq_python-0.45.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: linq-python
-Version: 0.43.0
+Version: 0.45.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.43.0 → linq_python-0.45.0}/api.md

@@ -119,6 +119,7 @@ from linq.types import (
     MessageCreateResponse,
     MessageAddReactionResponse,
     MessageUpdateAppCardResponse,
+    MessageUpdateStickerPlacementResponse,
 )
 ```
 
@@ -131,6 +132,7 @@ Methods:
 - <code title="post /v3/messages/{messageId}/reactions">client.messages.<a href="./src/linq/resources/messages/messages.py">add_reaction</a>(message_id, \*\*<a href="src/linq/types/message_add_reaction_params.py">params</a>) -> <a href="./src/linq/types/message_add_reaction_response.py">MessageAddReactionResponse</a></code>
 - <code title="get /v3/messages/{messageId}/thread">client.messages.<a href="./src/linq/resources/messages/messages.py">list_messages_thread</a>(message_id, \*\*<a href="src/linq/types/message_list_messages_thread_params.py">params</a>) -> <a href="./src/linq/types/message.py">SyncListMessagesPagination[Message]</a></code>
 - <code title="post /v3/messages/{messageId}/update">client.messages.<a href="./src/linq/resources/messages/messages.py">update_app_card</a>(message_id, \*\*<a href="src/linq/types/message_update_app_card_params.py">params</a>) -> <a href="./src/linq/types/message_update_app_card_response.py">MessageUpdateAppCardResponse</a></code>
+- <code title="patch /v3/messages/{messageId}/reactions/{reactionId}">client.messages.<a href="./src/linq/resources/messages/messages.py">update_sticker_placement</a>(reaction_id, \*, message_id, \*\*<a href="src/linq/types/message_update_sticker_placement_params.py">params</a>) -> <a href="./src/linq/types/message_update_sticker_placement_response.py">MessageUpdateStickerPlacementResponse</a></code>
 
 ## Poll
 

{linq_python-0.43.0 → linq_python-0.45.0}/pyproject.toml

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

{linq_python-0.43.0 → linq_python-0.45.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.43.0"  # x-release-please-version
+__version__ = "0.45.0"  # x-release-please-version

{linq_python-0.43.0 → linq_python-0.45.0}/src/linq/resources/messages/messages.py

@@ -20,6 +20,7 @@ from ...types import (
     message_add_reaction_params,
     message_update_app_card_params,
     message_list_messages_thread_params,
+    message_update_sticker_placement_params,
 )
 from ..._types import Body, Omit, Query, Headers, NoneType, NotGiven, SequenceNotStr, omit, not_given
 from ..._utils import path_template, maybe_transform, strip_not_given, async_maybe_transform
@@ -39,6 +40,7 @@ from ...types.message_content_param import MessageContentParam
 from ...types.message_create_response import MessageCreateResponse
 from ...types.message_add_reaction_response import MessageAddReactionResponse
 from ...types.message_update_app_card_response import MessageUpdateAppCardResponse
+from ...types.message_update_sticker_placement_response import MessageUpdateStickerPlacementResponse
 
 __all__ = ["MessagesResource", "AsyncMessagesResource"]
 
@@ -478,8 +480,11 @@ class MessagesResource(SyncAPIResource):
         *,
         operation: Literal["add", "remove"],
         type: ReactionType,
+        attachment_id: str | Omit = omit,
         custom_emoji: str | Omit = omit,
         part_index: int | Omit = omit,
+        placement: message_add_reaction_params.Placement | Omit = omit,
+        url: 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,
@@ -501,6 +506,12 @@ class MessagesResource(SyncAPIResource):
         - emphasize ‼️
         - question ❓
         - custom - any emoji (use `custom_emoji` field to specify)
+        - sticker - an image peeled onto the message (use `url` or `attachment_id`)
+
+        **Stickers** are iMessage-only and cannot be removed — iMessage has no unpeel
+        operation, so `operation: "remove"` with `type: "sticker"` is rejected.
+        Position, size and rotation are optional via `placement`, and can be changed
+        afterwards with `PATCH /v3/messages/{messageId}/reactions/{reactionId}`.
 
         Args:
           operation: Whether to add or remove the reaction
@@ -510,11 +521,33 @@ class MessagesResource(SyncAPIResource):
               emoji in the custom_emoji field. Sticker reactions have type "sticker" with
               sticker attachment details in the sticker field.
 
+          attachment_id: Reference to a sticker image pre-uploaded via `POST /v3/attachments`. Only valid
+              when type is "sticker".
+
+              Either `url` or `attachment_id` must be provided when type is "sticker", but not
+              both.
+
           custom_emoji: Custom emoji string. Required when type is "custom".
 
           part_index: Optional index of the message part to react to. If not provided, reacts to the
               entire message (part 0).
 
+          placement: Optional position, size and rotation of a sticker on the target bubble. Only
+              valid when type is "sticker".
+
+              Every field is independent and optional — omit the object entirely, or any field
+              within it, to keep the default (centred, default size, unrotated).
+
+          url: Linq attachment URL of the sticker image — the `download_url` returned by
+              `POST /v3/attachments`. Only valid when type is "sticker".
+
+              Unlike a media part, this does **not** accept an arbitrary host: reactions have
+              no download step, so the image must already be stored. To send a sticker from
+              elsewhere, upload it with `POST /v3/attachments` first and pass `attachment_id`.
+
+              Either `url` or `attachment_id` must be provided when type is "sticker", but not
+              both.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -531,8 +564,11 @@ class MessagesResource(SyncAPIResource):
                 {
                     "operation": operation,
                     "type": type,
+                    "attachment_id": attachment_id,
                     "custom_emoji": custom_emoji,
                     "part_index": part_index,
+                    "placement": placement,
+                    "url": url,
                 },
                 message_add_reaction_params.MessageAddReactionParams,
             ),
@@ -710,6 +746,67 @@ class MessagesResource(SyncAPIResource):
             cast_to=MessageUpdateAppCardResponse,
         )
 
+    def update_sticker_placement(
+        self,
+        reaction_id: str,
+        *,
+        message_id: str,
+        placement: message_update_sticker_placement_params.Placement,
+        # 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,
+    ) -> MessageUpdateStickerPlacementResponse:
+        """
+        Move, resize or rotate a sticker that has already been peeled onto a message.
+        The change is sent to every device in the conversation, exactly as dragging the
+        sticker by hand would.
+
+        Only stickers can be repositioned — a tapback has no placement, so a non-sticker
+        `reactionId` is rejected. Any field omitted from `placement` keeps its current
+        value.
+
+        `reactionId` is the `id` from the reaction on the message, or from the
+        `reaction.added` webhook. Stickers stack, so this id is what distinguishes one
+        sticker from another on the same message.
+
+        Stickers peeled before this endpoint existed cannot be moved: addressing one
+        requires an identifier that was not recorded at the time, and it returns 404.
+
+        Args:
+          placement: Optional position, size and rotation of a sticker on the target bubble. Only
+              valid when type is "sticker".
+
+              Every field is independent and optional — omit the object entirely, or any field
+              within it, to keep the default (centred, default size, unrotated).
+
+          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 message_id:
+            raise ValueError(f"Expected a non-empty value for `message_id` but received {message_id!r}")
+        if not reaction_id:
+            raise ValueError(f"Expected a non-empty value for `reaction_id` but received {reaction_id!r}")
+        return self._patch(
+            path_template(
+                "/v3/messages/{message_id}/reactions/{reaction_id}", message_id=message_id, reaction_id=reaction_id
+            ),
+            body=maybe_transform(
+                {"placement": placement}, message_update_sticker_placement_params.MessageUpdateStickerPlacementParams
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=MessageUpdateStickerPlacementResponse,
+        )
+
 
 class AsyncMessagesResource(AsyncAPIResource):
     """Messages are individual communications within a chat thread.
@@ -1146,8 +1243,11 @@ class AsyncMessagesResource(AsyncAPIResource):
         *,
         operation: Literal["add", "remove"],
         type: ReactionType,
+        attachment_id: str | Omit = omit,
         custom_emoji: str | Omit = omit,
         part_index: int | Omit = omit,
+        placement: message_add_reaction_params.Placement | Omit = omit,
+        url: 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,
@@ -1169,6 +1269,12 @@ class AsyncMessagesResource(AsyncAPIResource):
         - emphasize ‼️
         - question ❓
         - custom - any emoji (use `custom_emoji` field to specify)
+        - sticker - an image peeled onto the message (use `url` or `attachment_id`)
+
+        **Stickers** are iMessage-only and cannot be removed — iMessage has no unpeel
+        operation, so `operation: "remove"` with `type: "sticker"` is rejected.
+        Position, size and rotation are optional via `placement`, and can be changed
+        afterwards with `PATCH /v3/messages/{messageId}/reactions/{reactionId}`.
 
         Args:
           operation: Whether to add or remove the reaction
@@ -1178,11 +1284,33 @@ class AsyncMessagesResource(AsyncAPIResource):
               emoji in the custom_emoji field. Sticker reactions have type "sticker" with
               sticker attachment details in the sticker field.
 
+          attachment_id: Reference to a sticker image pre-uploaded via `POST /v3/attachments`. Only valid
+              when type is "sticker".
+
+              Either `url` or `attachment_id` must be provided when type is "sticker", but not
+              both.
+
           custom_emoji: Custom emoji string. Required when type is "custom".
 
           part_index: Optional index of the message part to react to. If not provided, reacts to the
               entire message (part 0).
 
+          placement: Optional position, size and rotation of a sticker on the target bubble. Only
+              valid when type is "sticker".
+
+              Every field is independent and optional — omit the object entirely, or any field
+              within it, to keep the default (centred, default size, unrotated).
+
+          url: Linq attachment URL of the sticker image — the `download_url` returned by
+              `POST /v3/attachments`. Only valid when type is "sticker".
+
+              Unlike a media part, this does **not** accept an arbitrary host: reactions have
+              no download step, so the image must already be stored. To send a sticker from
+              elsewhere, upload it with `POST /v3/attachments` first and pass `attachment_id`.
+
+              Either `url` or `attachment_id` must be provided when type is "sticker", but not
+              both.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -1199,8 +1327,11 @@ class AsyncMessagesResource(AsyncAPIResource):
                 {
                     "operation": operation,
                     "type": type,
+                    "attachment_id": attachment_id,
                     "custom_emoji": custom_emoji,
                     "part_index": part_index,
+                    "placement": placement,
+                    "url": url,
                 },
                 message_add_reaction_params.MessageAddReactionParams,
             ),
@@ -1378,6 +1509,67 @@ class AsyncMessagesResource(AsyncAPIResource):
             cast_to=MessageUpdateAppCardResponse,
         )
 
+    async def update_sticker_placement(
+        self,
+        reaction_id: str,
+        *,
+        message_id: str,
+        placement: message_update_sticker_placement_params.Placement,
+        # 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,
+    ) -> MessageUpdateStickerPlacementResponse:
+        """
+        Move, resize or rotate a sticker that has already been peeled onto a message.
+        The change is sent to every device in the conversation, exactly as dragging the
+        sticker by hand would.
+
+        Only stickers can be repositioned — a tapback has no placement, so a non-sticker
+        `reactionId` is rejected. Any field omitted from `placement` keeps its current
+        value.
+
+        `reactionId` is the `id` from the reaction on the message, or from the
+        `reaction.added` webhook. Stickers stack, so this id is what distinguishes one
+        sticker from another on the same message.
+
+        Stickers peeled before this endpoint existed cannot be moved: addressing one
+        requires an identifier that was not recorded at the time, and it returns 404.
+
+        Args:
+          placement: Optional position, size and rotation of a sticker on the target bubble. Only
+              valid when type is "sticker".
+
+              Every field is independent and optional — omit the object entirely, or any field
+              within it, to keep the default (centred, default size, unrotated).
+
+          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 message_id:
+            raise ValueError(f"Expected a non-empty value for `message_id` but received {message_id!r}")
+        if not reaction_id:
+            raise ValueError(f"Expected a non-empty value for `reaction_id` but received {reaction_id!r}")
+        return await self._patch(
+            path_template(
+                "/v3/messages/{message_id}/reactions/{reaction_id}", message_id=message_id, reaction_id=reaction_id
+            ),
+            body=await async_maybe_transform(
+                {"placement": placement}, message_update_sticker_placement_params.MessageUpdateStickerPlacementParams
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=MessageUpdateStickerPlacementResponse,
+        )
+
 
 class MessagesResourceWithRawResponse:
     def __init__(self, messages: MessagesResource) -> None:
@@ -1404,6 +1596,9 @@ class MessagesResourceWithRawResponse:
         self.update_app_card = to_raw_response_wrapper(
             messages.update_app_card,
         )
+        self.update_sticker_placement = to_raw_response_wrapper(
+            messages.update_sticker_placement,
+        )
 
     @cached_property
     def poll(self) -> PollResourceWithRawResponse:
@@ -1507,6 +1702,9 @@ class AsyncMessagesResourceWithRawResponse:
         self.update_app_card = async_to_raw_response_wrapper(
             messages.update_app_card,
         )
+        self.update_sticker_placement = async_to_raw_response_wrapper(
+            messages.update_sticker_placement,
+        )
 
     @cached_property
     def poll(self) -> AsyncPollResourceWithRawResponse:
@@ -1610,6 +1808,9 @@ class MessagesResourceWithStreamingResponse:
         self.update_app_card = to_streamed_response_wrapper(
             messages.update_app_card,
         )
+        self.update_sticker_placement = to_streamed_response_wrapper(
+            messages.update_sticker_placement,
+        )
 
     @cached_property
     def poll(self) -> PollResourceWithStreamingResponse:
@@ -1713,6 +1914,9 @@ class AsyncMessagesResourceWithStreamingResponse:
         self.update_app_card = async_to_streamed_response_wrapper(
             messages.update_app_card,
         )
+        self.update_sticker_placement = async_to_streamed_response_wrapper(
+            messages.update_sticker_placement,
+        )
 
     @cached_property
     def poll(self) -> AsyncPollResourceWithStreamingResponse:

{linq_python-0.43.0 → linq_python-0.45.0}/src/linq/types/__init__.py

@@ -136,6 +136,12 @@ from .location_sharing_started_webhook_event import (
 from .location_sharing_stopped_webhook_event import (
     LocationSharingStoppedWebhookEvent as LocationSharingStoppedWebhookEvent,
 )
+from .message_update_sticker_placement_params import (
+    MessageUpdateStickerPlacementParams as MessageUpdateStickerPlacementParams,
+)
+from .message_update_sticker_placement_response import (
+    MessageUpdateStickerPlacementResponse as MessageUpdateStickerPlacementResponse,
+)
 from .phone_number_status_updated_webhook_event import (
     PhoneNumberStatusUpdatedWebhookEvent as PhoneNumberStatusUpdatedWebhookEvent,
 )

{linq_python-0.43.0 → linq_python-0.45.0}/src/linq/types/media_part_param.py

@@ -20,6 +20,25 @@ class MediaPartParam(TypedDict, total=False):
     Either `url` or `attachment_id` must be provided, but not both.
     """
 
+    sticker: bool
+    """Send this image as a **sticker** rather than a photo.
+
+    The recipient can peel it off and place it on any message in the conversation,
+    and it renders without a bubble.
+
+    An opaque photo is cut out automatically — the subject is lifted from its
+    background, the same way "Add Sticker" does on iOS. An image that already has
+    transparency is sent as-is. If no subject can be found, the image sends as an
+    ordinary photo.
+
+    **iMessage only.** On SMS/RCS the flag is ignored and the image sends as a
+    photo.
+
+    Stickers can be combined with a `text` part in the same message; the text
+    arrives as its own bubble. To place a sticker _onto_ an existing message
+    instead, use `POST /v3/messages/{messageId}/reactions` with `type: "sticker"`.
+    """
+
     url: str
     """Any publicly accessible HTTPS URL to the media file.
 

linq_python-0.45.0/src/linq/types/message_add_reaction_params.py

@@ -0,0 +1,101 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Literal, Required, TypedDict
+
+from .shared.reaction_type import ReactionType
+
+__all__ = ["MessageAddReactionParams", "Placement"]
+
+
+class MessageAddReactionParams(TypedDict, total=False):
+    operation: Required[Literal["add", "remove"]]
+    """Whether to add or remove the reaction"""
+
+    type: Required[ReactionType]
+    """Type of reaction.
+
+    Standard iMessage tapbacks are love, like, dislike, laugh, emphasize, question.
+    Custom emoji reactions have type "custom" with the actual emoji in the
+    custom_emoji field. Sticker reactions have type "sticker" with sticker
+    attachment details in the sticker field.
+    """
+
+    attachment_id: str
+    """
+    Reference to a sticker image pre-uploaded via `POST /v3/attachments`. Only valid
+    when type is "sticker".
+
+    Either `url` or `attachment_id` must be provided when type is "sticker", but not
+    both.
+    """
+
+    custom_emoji: str
+    """Custom emoji string. Required when type is "custom"."""
+
+    part_index: int
+    """
+    Optional index of the message part to react to. If not provided, reacts to the
+    entire message (part 0).
+    """
+
+    placement: Placement
+    """Optional position, size and rotation of a sticker on the target bubble.
+
+    Only valid when type is "sticker".
+
+    Every field is independent and optional — omit the object entirely, or any field
+    within it, to keep the default (centred, default size, unrotated).
+    """
+
+    url: str
+    """
+    Linq attachment URL of the sticker image — the `download_url` returned by
+    `POST /v3/attachments`. Only valid when type is "sticker".
+
+    Unlike a media part, this does **not** accept an arbitrary host: reactions have
+    no download step, so the image must already be stored. To send a sticker from
+    elsewhere, upload it with `POST /v3/attachments` first and pass `attachment_id`.
+
+    Either `url` or `attachment_id` must be provided when type is "sticker", but not
+    both.
+    """
+
+
+class Placement(TypedDict, total=False):
+    """Optional position, size and rotation of a sticker on the target
+    bubble.
+
+    Only valid when type is "sticker".
+
+    Every field is independent and optional — omit the object entirely,
+    or any field within it, to keep the default (centred, default size,
+    unrotated).
+    """
+
+    rotation: float
+    """Clockwise rotation in degrees."""
+
+    scale: float
+    """Size relative to the default, where 1 matches the size a sticker gets natively.
+
+    Values outside 0.5–1.5 are clamped rather than rejected. The upper bound keeps a
+    sticker within the size range iMessage itself displays: its own limit is larger,
+    but that allowance assumes the transparent padding Apple's stickers carry, which
+    a full-bleed image does not have.
+
+    Scale is linear, so 1.5 is a little over twice the area.
+    """
+
+    x: float
+    """Horizontal position on the target bubble, from -1 (far left) to 1 (far right).
+
+    0 is centred.
+    """
+
+    y: float
+    """Vertical position on the target bubble, from -1 (top) to 1 (bottom).
+
+    0 is centred.
+    """

{linq_python-0.43.0 → linq_python-0.45.0}/src/linq/types/message_event_v2.py

@@ -272,3 +272,11 @@ class MessageEventV2(BaseModel):
 
     sent_at: Optional[datetime] = None
     """When the message was sent. Null if not yet sent."""
+
+    zero_retention: Optional[bool] = None
+    """True when this message was sent on a zero-day-retention line.
+
+    `parts` is always empty in that case — Linq never persists this message's
+    content, so there is nothing to include here, not even a count or type of what
+    was sent.
+    """

linq_python-0.45.0/src/linq/types/message_update_sticker_placement_params.py

@@ -0,0 +1,60 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Required, Annotated, TypedDict
+
+from .._utils import PropertyInfo
+
+__all__ = ["MessageUpdateStickerPlacementParams", "Placement"]
+
+
+class MessageUpdateStickerPlacementParams(TypedDict, total=False):
+    message_id: Required[Annotated[str, PropertyInfo(alias="messageId")]]
+
+    placement: Required[Placement]
+    """Optional position, size and rotation of a sticker on the target bubble.
+
+    Only valid when type is "sticker".
+
+    Every field is independent and optional — omit the object entirely, or any field
+    within it, to keep the default (centred, default size, unrotated).
+    """
+
+
+class Placement(TypedDict, total=False):
+    """Optional position, size and rotation of a sticker on the target
+    bubble.
+
+    Only valid when type is "sticker".
+
+    Every field is independent and optional — omit the object entirely,
+    or any field within it, to keep the default (centred, default size,
+    unrotated).
+    """
+
+    rotation: float
+    """Clockwise rotation in degrees."""
+
+    scale: float
+    """Size relative to the default, where 1 matches the size a sticker gets natively.
+
+    Values outside 0.5–1.5 are clamped rather than rejected. The upper bound keeps a
+    sticker within the size range iMessage itself displays: its own limit is larger,
+    but that allowance assumes the transparent padding Apple's stickers carry, which
+    a full-bleed image does not have.
+
+    Scale is linear, so 1.5 is a little over twice the area.
+    """
+
+    x: float
+    """Horizontal position on the target bubble, from -1 (far left) to 1 (far right).
+
+    0 is centred.
+    """
+
+    y: float
+    """Vertical position on the target bubble, from -1 (top) to 1 (bottom).
+
+    0 is centred.
+    """

linq_python-0.45.0/src/linq/types/message_update_sticker_placement_response.py

@@ -0,0 +1,15 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from .._models import BaseModel
+
+__all__ = ["MessageUpdateStickerPlacementResponse"]
+
+
+class MessageUpdateStickerPlacementResponse(BaseModel):
+    status: Optional[str] = None
+
+    success: Optional[bool] = None
+
+    trace_id: Optional[str] = None

{linq_python-0.43.0 → linq_python-0.45.0}/src/linq/types/reaction_event_base.py

@@ -75,6 +75,14 @@ class ReactionEventBase(BaseModel):
     reacted_at: Optional[datetime] = None
     """When the reaction was added or removed"""
 
+    reaction_id: Optional[str] = None
+    """Identifier for this reaction.
+
+    Pass it to `PATCH /v3/messages/{messageId}/reactions/{reactionId}` to move a
+    sticker. Stickers stack, so this is what distinguishes one sticker from another
+    on the same message.
+    """
+
     service: Optional[ServiceType] = None
     """Messaging service type"""
 

{linq_python-0.43.0 → linq_python-0.45.0}/src/linq/types/shared/reaction.py

@@ -46,6 +46,17 @@ class Reaction(BaseModel):
     attachment details in the sticker field.
     """
 
+    id: Optional[str] = None
+    """Identifier for this reaction.
+
+    Pass it to `PATCH /v3/messages/{messageId}/reactions/{reactionId}` to move a
+    sticker.
+
+    Stickers placed before this API shipped can be read but not moved: the
+    device-side reference needed to reposition them was never recorded, so `PATCH`
+    returns 404 for those.
+    """
+
     custom_emoji: Optional[str] = None
     """Custom emoji if type is "custom", null otherwise"""