docs: clarify transcript background field requirements and examples

src/linq/resources/chats/background.py

@@ -131,10 +131,13 @@ def set(
               `group_chat_icon` works. A URL we cannot fetch, or one that isn't an image, is
               rejected with a `400` (`5007`/`5006`) rather than failing later on the device.
 
-          shades: Color with `variant: custom`: the two gradient stops as hex, top then bottom.
-              Ignored for named color variants (they carry their own two colors).
+              Example: `https://cdn.linqapp.com/u/bg.jpg`.
 
-          style: Dynamic: the animated style.
+          shades: Color with `variant: custom`: the two gradient stops as hex, top then bottom —
+              e.g. `["#F2C4E1", "#F5A623"]`. Ignored for named color variants (they carry
+              their own two colors).
+
+          style: Dynamic: the animated style — `sky`, `water`, or `aurora`.
 
           variant: Color: a named swatch — `mango`, `ice`, `plum`, `deep_sea`, `green_apple`,
               `cherry`, `bubblegum`, `tangerine`, `magenta`, `lime`, `silver`, `carbon`,
@@ -286,10 +289,13 @@ async def set(
               `group_chat_icon` works. A URL we cannot fetch, or one that isn't an image, is
               rejected with a `400` (`5007`/`5006`) rather than failing later on the device.
 
-          shades: Color with `variant: custom`: the two gradient stops as hex, top then bottom.
-              Ignored for named color variants (they carry their own two colors).
+              Example: `https://cdn.linqapp.com/u/bg.jpg`.
+
+          shades: Color with `variant: custom`: the two gradient stops as hex, top then bottom —
+              e.g. `["#F2C4E1", "#F5A623"]`. Ignored for named color variants (they carry
+              their own two colors).
 
-          style: Dynamic: the animated style.
+          style: Dynamic: the animated style — `sky`, `water`, or `aurora`.
 
           variant: Color: a named swatch — `mango`, `ice`, `plum`, `deep_sea`, `green_apple`,
               `cherry`, `bubblegum`, `tangerine`, `magenta`, `lime`, `silver`, `carbon`,

src/linq/types/chats/background_set_params.py

@@ -21,16 +21,19 @@ class BackgroundSetParams(TypedDict, total=False):
     is accepted — the same way `group_chat_icon` works. A URL we cannot fetch, or
     one that isn't an image, is rejected with a `400` (`5007`/`5006`) rather than
     failing later on the device.
+
+    Example: `https://cdn.linqapp.com/u/bg.jpg`.
     """
 
     shades: SequenceNotStr[str]
     """
-    Color with `variant: custom`: the two gradient stops as hex, top then bottom.
-    Ignored for named color variants (they carry their own two colors).
+    Color with `variant: custom`: the two gradient stops as hex, top then bottom —
+    e.g. `["#F2C4E1", "#F5A623"]`. Ignored for named color variants (they carry
+    their own two colors).
     """
 
     style: Literal["sky", "water", "aurora"]
-    """Dynamic: the animated style."""
+    """Dynamic: the animated style — `sky`, `water`, or `aurora`."""
 
     variant: str
     """

tests/api_resources/chats/test_background.py

@@ -72,8 +72,8 @@ def test_method_set_with_all_params(self, client: LinqAPIV3) -> None:
         background = client.chats.background.set(
             chat_id="550e8400-e29b-41d4-a716-446655440000",
             type="color",
-            image_url="https://cdn.linqapp.com/u/bg.jpg",
-            shades=["#F2C4E1", "#F5A623"],
+            image_url="https://example.com",
+            shades=["string", "string"],
             style="sky",
             variant="mango",
         )
@@ -179,8 +179,8 @@ async def test_method_set_with_all_params(self, async_client: AsyncLinqAPIV3) ->
         background = await async_client.chats.background.set(
             chat_id="550e8400-e29b-41d4-a716-446655440000",
             type="color",
-            image_url="https://cdn.linqapp.com/u/bg.jpg",
-            shades=["#F2C4E1", "#F5A623"],
+            image_url="https://example.com",
+            shades=["string", "string"],
             style="sky",
             variant="mango",
         )