diff --git a/src/apify_client/_resource_clients/log.py b/src/apify_client/_resource_clients/log.py
index f8f8cdd5..21127aa4 100644
--- a/src/apify_client/_resource_clients/log.py
+++ b/src/apify_client/_resource_clients/log.py
@@ -69,6 +69,10 @@ def get_as_bytes(self, *, raw: bool = False, timeout: Timeout = 'long') -> bytes
 
         https://docs.apify.com/api/v2#/reference/logs/log/get-log
 
+        404s collapse to `None` only when this client targets a specific log by ID (e.g.
+        `client.log(run_id).get_as_bytes()`). For chained clients without a `resource_id` (e.g.
+        `run.log().get_as_bytes()`), a 404 is ambiguous and propagates.
+
         Args:
             raw: If true, the log will include formatting. For example, coloring character sequences.
             timeout: Timeout for the API HTTP request.
@@ -97,6 +101,9 @@ def stream(self, *, raw: bool = False, timeout: Timeout = 'long') -> Iterator[Ht
 
         https://docs.apify.com/api/v2#/reference/logs/log/get-log
 
+        404s collapse to `None` only when this client targets a specific log by ID (e.g. `client.log(run_id).stream()`).
+        For chained clients without a `resource_id` (e.g. `run.log().stream()`), a 404 is ambiguous and propagates.
+
         Args:
             raw: If true, the log will include formatting. For example, coloring character sequences.
             timeout: Timeout for the API HTTP request.
@@ -177,6 +184,10 @@ async def get_as_bytes(self, *, raw: bool = False, timeout: Timeout = 'long') ->
 
         https://docs.apify.com/api/v2#/reference/logs/log/get-log
 
+        404s collapse to `None` only when this client targets a specific log by ID (e.g.
+        `client.log(run_id).get_as_bytes()`). For chained clients without a `resource_id` (e.g.
+        `run.log().get_as_bytes()`), a 404 is ambiguous and propagates.
+
         Args:
             raw: If true, the log will include formatting. For example, coloring character sequences.
             timeout: Timeout for the API HTTP request.
@@ -205,6 +216,9 @@ async def stream(self, *, raw: bool = False, timeout: Timeout = 'long') -> Async
 
         https://docs.apify.com/api/v2#/reference/logs/log/get-log
 
+        404s collapse to `None` only when this client targets a specific log by ID (e.g. `client.log(run_id).stream()`).
+        For chained clients without a `resource_id` (e.g. `run.log().stream()`), a 404 is ambiguous and propagates.
+
         Args:
             raw: If true, the log will include formatting. For example, coloring character sequences.
             timeout: Timeout for the API HTTP request.