diff --git a/src/linq/resources/chats/background.py b/src/linq/resources/chats/background.py
index c5c4846..0c7a2a7 100644
--- a/src/linq/resources/chats/background.py
+++ b/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`,
diff --git a/src/linq/types/chats/background_set_params.py b/src/linq/types/chats/background_set_params.py
index abdea8b..232acf0 100644
--- a/src/linq/types/chats/background_set_params.py
+++ b/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
     """
diff --git a/tests/api_resources/chats/test_background.py b/tests/api_resources/chats/test_background.py
index ec5ea6c..8752376 100644
--- a/tests/api_resources/chats/test_background.py
+++ b/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",
         )
diff --git a/uv.lock b/uv.lock
index 754704a..0d4c607 100644
--- a/uv.lock
+++ b/uv.lock
@@ -518,7 +518,7 @@ wheels = [
 
 [[package]]
 name = "linq-python"
-version = "0.30.1"
+version = "0.30.2"
 source = { editable = "." }
 dependencies = [
     { name = "anyio" },