linq-python 0.51.1__tar.gz → 0.52.0__tar.gz

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

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

{linq_python-0.51.1 → linq_python-0.52.0}/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.52.0](https://github.com/linq-team/linq-python/compare/v0.51.2...v0.52.0) (2026-09-10)
+
+
+### Features
+
+* add emoji sticker support alongside url and attachment_id ([824aba6](https://github.com/linq-team/linq-python/commit/824aba6a0b71e7eae3ef71f3650a78eb5238c0e8))
+
+## [0.51.2](https://github.com/linq-team/linq-python/compare/v0.51.1...v0.51.2) (2026-09-10)
+
+
+### Documentation
+
+* clarify message service transport semantics ([df61742](https://github.com/linq-team/linq-python/commit/df617427fe0e82877283121f09b015dc356a772a))
+
 ## [0.51.1](https://github.com/linq-team/linq-python/compare/v0.51.0...v0.51.1) (2026-09-09)
 
 

{linq_python-0.51.1 → linq_python-0.52.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: linq-python
-Version: 0.51.1
+Version: 0.52.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.51.1 → linq_python-0.52.0}/pyproject.toml

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

{linq_python-0.51.1 → linq_python-0.52.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.51.1"  # x-release-please-version
+__version__ = "0.52.0"  # x-release-please-version

{linq_python-0.51.1 → linq_python-0.52.0}/src/linq/resources/messages/messages.py

@@ -482,6 +482,7 @@ class MessagesResource(SyncAPIResource):
         type: ReactionType,
         attachment_id: str | Omit = omit,
         custom_emoji: str | Omit = omit,
+        emoji: str | Omit = omit,
         part_index: int | Omit = omit,
         placement: message_add_reaction_params.Placement | Omit = omit,
         url: str | Omit = omit,
@@ -505,8 +506,14 @@ class MessagesResource(SyncAPIResource):
         - laugh 😂
         - emphasize ‼️
         - question ❓
-        - custom - any emoji (use `custom_emoji` field to specify)
-        - sticker - an image peeled onto the message (use `url` or `attachment_id`)
+        - custom - any emoji as a tapback (use `custom_emoji` field to specify)
+        - sticker - an emoji or image peeled onto the message (use `emoji`, `url` or
+          `attachment_id`)
+
+        **`custom` and `sticker` are different products.** A `custom` reaction is a
+        tapback: the emoji sits in a small bubble on the corner of the message. A
+        `sticker` is peeled onto the bubble itself, and can be dragged, resized and
+        rotated. Both accept an emoji; they do not look alike.
 
         **Stickers** are iMessage-only and cannot be removed — iMessage has no unpeel
         operation, so `operation: "remove"` with `type: "sticker"` is rejected.
@@ -524,11 +531,24 @@ class MessagesResource(SyncAPIResource):
           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.
+              Exactly one of `emoji`, `url` or `attachment_id` is required when type is
+              "sticker".
 
           custom_emoji: Custom emoji string. Required when type is "custom".
 
+              This is a **tapback** — the emoji sits in the tapback bubble on the corner of
+              the message. To peel an emoji onto the message as a draggable sticker instead,
+              use type "sticker" with `emoji`.
+
+          emoji: A single emoji to peel onto the message as a sticker. Only valid when type is
+              "sticker", and it is rendered on the device so it matches the glyph a person
+              would peel by hand.
+
+              Exactly one of `emoji`, `url` or `attachment_id` is required when type is
+              "sticker".
+
+              Not to be confused with `custom_emoji`, which produces a tapback.
+
           part_index: Optional index of the message part to react to. If not provided, reacts to the
               entire message (part 0).
 
@@ -545,8 +565,8 @@ class MessagesResource(SyncAPIResource):
               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.
+              Exactly one of `emoji`, `url` or `attachment_id` is required when type is
+              "sticker".
 
           extra_headers: Send extra headers
 
@@ -566,6 +586,7 @@ class MessagesResource(SyncAPIResource):
                     "type": type,
                     "attachment_id": attachment_id,
                     "custom_emoji": custom_emoji,
+                    "emoji": emoji,
                     "part_index": part_index,
                     "placement": placement,
                     "url": url,
@@ -1249,6 +1270,7 @@ class AsyncMessagesResource(AsyncAPIResource):
         type: ReactionType,
         attachment_id: str | Omit = omit,
         custom_emoji: str | Omit = omit,
+        emoji: str | Omit = omit,
         part_index: int | Omit = omit,
         placement: message_add_reaction_params.Placement | Omit = omit,
         url: str | Omit = omit,
@@ -1272,8 +1294,14 @@ class AsyncMessagesResource(AsyncAPIResource):
         - laugh 😂
         - emphasize ‼️
         - question ❓
-        - custom - any emoji (use `custom_emoji` field to specify)
-        - sticker - an image peeled onto the message (use `url` or `attachment_id`)
+        - custom - any emoji as a tapback (use `custom_emoji` field to specify)
+        - sticker - an emoji or image peeled onto the message (use `emoji`, `url` or
+          `attachment_id`)
+
+        **`custom` and `sticker` are different products.** A `custom` reaction is a
+        tapback: the emoji sits in a small bubble on the corner of the message. A
+        `sticker` is peeled onto the bubble itself, and can be dragged, resized and
+        rotated. Both accept an emoji; they do not look alike.
 
         **Stickers** are iMessage-only and cannot be removed — iMessage has no unpeel
         operation, so `operation: "remove"` with `type: "sticker"` is rejected.
@@ -1291,11 +1319,24 @@ class AsyncMessagesResource(AsyncAPIResource):
           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.
+              Exactly one of `emoji`, `url` or `attachment_id` is required when type is
+              "sticker".
 
           custom_emoji: Custom emoji string. Required when type is "custom".
 
+              This is a **tapback** — the emoji sits in the tapback bubble on the corner of
+              the message. To peel an emoji onto the message as a draggable sticker instead,
+              use type "sticker" with `emoji`.
+
+          emoji: A single emoji to peel onto the message as a sticker. Only valid when type is
+              "sticker", and it is rendered on the device so it matches the glyph a person
+              would peel by hand.
+
+              Exactly one of `emoji`, `url` or `attachment_id` is required when type is
+              "sticker".
+
+              Not to be confused with `custom_emoji`, which produces a tapback.
+
           part_index: Optional index of the message part to react to. If not provided, reacts to the
               entire message (part 0).
 
@@ -1312,8 +1353,8 @@ class AsyncMessagesResource(AsyncAPIResource):
               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.
+              Exactly one of `emoji`, `url` or `attachment_id` is required when type is
+              "sticker".
 
           extra_headers: Send extra headers
 
@@ -1333,6 +1374,7 @@ class AsyncMessagesResource(AsyncAPIResource):
                     "type": type,
                     "attachment_id": attachment_id,
                     "custom_emoji": custom_emoji,
+                    "emoji": emoji,
                     "part_index": part_index,
                     "placement": placement,
                     "url": url,

{linq_python-0.51.1 → linq_python-0.52.0}/src/linq/types/chat.py

@@ -111,4 +111,9 @@ class Chat(BaseModel):
     """
 
     service: Optional[ServiceType] = None
-    """Messaging service type"""
+    """Messaging service type.
+
+    Where this names the transport a message used, it is per-message: a chat's own
+    `service` can differ from a message in it, and Apple can downgrade an individual
+    message.
+    """

{linq_python-0.51.1 → linq_python-0.52.0}/src/linq/types/chat_create_response.py

@@ -97,7 +97,12 @@ class Chat(BaseModel):
     """A message that was sent (used in CreateChat and SendMessage responses)"""
 
     service: ServiceType
-    """Messaging service type"""
+    """Messaging service type.
+
+    Where this names the transport a message used, it is per-message: a chat's own
+    `service` can differ from a message in it, and Apple can downgrade an individual
+    message.
+    """
 
 
 class ChatCreateResponse(BaseModel):

{linq_python-0.51.1 → linq_python-0.52.0}/src/linq/types/chat_created_webhook_event.py

@@ -105,7 +105,12 @@ class Data(BaseModel):
     """When the chat was last updated"""
 
     service: Optional[ServiceType] = None
-    """Messaging service type"""
+    """Messaging service type.
+
+    Where this names the transport a message used, it is per-message: a chat's own
+    `service` can differ from a message in it, and Apple can downgrade an individual
+    message.
+    """
 
 
 class ChatCreatedWebhookEvent(BaseModel):

{linq_python-0.51.1 → linq_python-0.52.0}/src/linq/types/chat_send_voicememo_response.py

@@ -26,7 +26,12 @@ class VoiceMemoChat(BaseModel):
     """Whether this is a group chat"""
 
     service: ServiceType
-    """Messaging service type"""
+    """Messaging service type.
+
+    Where this names the transport a message used, it is per-message: a chat's own
+    `service` can differ from a message in it, and Apple can downgrade an individual
+    message.
+    """
 
 
 class VoiceMemoVoiceMemo(BaseModel):
@@ -70,7 +75,12 @@ class VoiceMemo(BaseModel):
     voice_memo: VoiceMemoVoiceMemo
 
     service: Optional[ServiceType] = None
-    """Messaging service type"""
+    """Messaging service type.
+
+    Where this names the transport a message used, it is per-message: a chat's own
+    `service` can differ from a message in it, and Apple can downgrade an individual
+    message.
+    """
 
 
 class ChatSendVoicememoResponse(BaseModel):

{linq_python-0.51.1 → linq_python-0.52.0}/src/linq/types/chats/sent_message.py

@@ -195,10 +195,20 @@ class SentMessage(BaseModel):
     """The sender of this message as a full handle object"""
 
     preferred_service: Optional[ServiceType] = None
-    """Messaging service type"""
+    """Messaging service type.
+
+    Where this names the transport a message used, it is per-message: a chat's own
+    `service` can differ from a message in it, and Apple can downgrade an individual
+    message.
+    """
 
     reply_to: Optional[ReplyTo] = None
     """Indicates this message is a threaded reply to another message"""
 
     service: Optional[ServiceType] = None
-    """Messaging service type"""
+    """Messaging service type.
+
+    Where this names the transport a message used, it is per-message: a chat's own
+    `service` can differ from a message in it, and Apple can downgrade an individual
+    message.
+    """

{linq_python-0.51.1 → linq_python-0.52.0}/src/linq/types/message.py

@@ -210,7 +210,12 @@ class Message(BaseModel):
     """Message parts in order (text, media, and link)"""
 
     preferred_service: Optional[ServiceType] = None
-    """Messaging service type"""
+    """Messaging service type.
+
+    Where this names the transport a message used, it is per-message: a chat's own
+    `service` can differ from a message in it, and Apple can downgrade an individual
+    message.
+    """
 
     read_at: Optional[datetime] = None
     """When the message was read"""
@@ -232,4 +237,9 @@ class Message(BaseModel):
     """When the message was sent"""
 
     service: Optional[ServiceType] = None
-    """Messaging service type"""
+    """Messaging service type.
+
+    Where this names the transport a message used, it is per-message: a chat's own
+    `service` can differ from a message in it, and Apple can downgrade an individual
+    message.
+    """

{linq_python-0.51.1 → linq_python-0.52.0}/src/linq/types/message_add_reaction_params.py

@@ -27,12 +27,29 @@ class MessageAddReactionParams(TypedDict, total=False):
     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.
+    Exactly one of `emoji`, `url` or `attachment_id` is required when type is
+    "sticker".
     """
 
     custom_emoji: str
-    """Custom emoji string. Required when type is "custom"."""
+    """Custom emoji string. Required when type is "custom".
+
+    This is a **tapback** — the emoji sits in the tapback bubble on the corner of
+    the message. To peel an emoji onto the message as a draggable sticker instead,
+    use type "sticker" with `emoji`.
+    """
+
+    emoji: str
+    """A single emoji to peel onto the message as a sticker.
+
+    Only valid when type is "sticker", and it is rendered on the device so it
+    matches the glyph a person would peel by hand.
+
+    Exactly one of `emoji`, `url` or `attachment_id` is required when type is
+    "sticker".
+
+    Not to be confused with `custom_emoji`, which produces a tapback.
+    """
 
     part_index: int
     """
@@ -58,8 +75,8 @@ class MessageAddReactionParams(TypedDict, total=False):
     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.
+    Exactly one of `emoji`, `url` or `attachment_id` is required when type is
+    "sticker".
     """
 
 

{linq_python-0.51.1 → linq_python-0.52.0}/src/linq/types/message_content_param.py

@@ -307,7 +307,12 @@ class MessageContentParam(TypedDict, total=False):
     """
 
     preferred_service: ServiceType
-    """Messaging service type"""
+    """Messaging service type.
+
+    Where this names the transport a message used, it is per-message: a chat's own
+    `service` can differ from a message in it, and Apple can downgrade an individual
+    message.
+    """
 
     reply_to: ReplyToParam
     """Reply to another message to create a threaded conversation"""

{linq_python-0.51.1 → linq_python-0.52.0}/src/linq/types/message_create_response.py

@@ -58,7 +58,12 @@ class MessageCreateResponse(BaseModel):
     """A message that was sent (used in CreateChat and SendMessage responses)"""
 
     service: ServiceType
-    """Messaging service type"""
+    """Messaging service type.
+
+    Where this names the transport a message used, it is per-message: a chat's own
+    `service` can differ from a message in it, and Apple can downgrade an individual
+    message.
+    """
 
     previous_chat_id: Optional[str] = None
     """

{linq_python-0.51.1 → linq_python-0.52.0}/src/linq/types/message_event_v2.py

@@ -236,7 +236,12 @@ class MessageEventV2(BaseModel):
     """The handle that sent this message"""
 
     service: ServiceType
-    """Messaging service type"""
+    """Messaging service type.
+
+    Where this names the transport a message used, it is per-message: a chat's own
+    `service` can differ from a message in it, and Apple can downgrade an individual
+    message.
+    """
 
     delivered_at: Optional[datetime] = None
     """When the message was delivered. Null if not yet delivered."""

{linq_python-0.51.1 → linq_python-0.52.0}/src/linq/types/message_failed_webhook_event.py

@@ -54,7 +54,12 @@ class Data(BaseModel):
     """Human-readable description of the failure"""
 
     service: Optional[ServiceType] = None
-    """Messaging service type"""
+    """Messaging service type.
+
+    Where this names the transport a message used, it is per-message: a chat's own
+    `service` can differ from a message in it, and Apple can downgrade an individual
+    message.
+    """
 
 
 class MessageFailedWebhookEvent(BaseModel):

{linq_python-0.51.1 → linq_python-0.52.0}/src/linq/types/reaction_event_base.py

@@ -84,7 +84,12 @@ class ReactionEventBase(BaseModel):
     """
 
     service: Optional[ServiceType] = None
-    """Messaging service type"""
+    """Messaging service type.
+
+    Where this names the transport a message used, it is per-message: a chat's own
+    `service` can differ from a message in it, and Apple can downgrade an individual
+    message.
+    """
 
     sticker: Optional[Sticker] = None
     """Sticker attachment details when reaction_type is "sticker".

{linq_python-0.51.1 → linq_python-0.52.0}/src/linq/types/shared/chat_handle.py

@@ -21,7 +21,12 @@ class ChatHandle(BaseModel):
     """When this participant joined the chat"""
 
     service: ServiceType
-    """Messaging service type"""
+    """Messaging service type.
+
+    Where this names the transport a message used, it is per-message: a chat's own
+    `service` can differ from a message in it, and Apple can downgrade an individual
+    message.
+    """
 
     is_me: Optional[bool] = None
     """Whether this handle belongs to the sender (your phone number)"""

{linq_python-0.51.1 → linq_python-0.52.0}/tests/api_resources/test_messages.py

@@ -269,6 +269,7 @@ class TestMessages:
             type="love",
             attachment_id="550e8400-e29b-41d4-a716-446655440000",
             custom_emoji="custom_emoji",
+            emoji="🎉",
             part_index=1,
             placement={
                 "rotation": 15,
@@ -773,6 +774,7 @@ class TestAsyncMessages:
             type="love",
             attachment_id="550e8400-e29b-41d4-a716-446655440000",
             custom_emoji="custom_emoji",
+            emoji="🎉",
             part_index=1,
             placement={
                 "rotation": 15,

{linq_python-0.51.1 → linq_python-0.52.0}/uv.lock

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

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

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