diff --git a/sdk/api-reference/openhands.sdk.llm.mdx b/sdk/api-reference/openhands.sdk.llm.mdx
index 4e6f8a90..59d4150f 100644
--- a/sdk/api-reference/openhands.sdk.llm.mdx
+++ b/sdk/api-reference/openhands.sdk.llm.mdx
@@ -4,6 +4,17 @@ description: API reference for openhands.sdk.llm module
 ---
 
 
+## Import shortcuts
+
+`TokenUsage` is part of the public LLM metrics surface and can be imported from either `openhands.sdk.llm` or the top-level `openhands.sdk` package.
+
+```python
+from openhands.sdk.llm import TokenUsage
+# or
+from openhands.sdk import TokenUsage
+```
+
+
 ### class CredentialStore
 
 Bases: `object`
diff --git a/sdk/api-reference/openhands.sdk.utils.mdx b/sdk/api-reference/openhands.sdk.utils.mdx
index 237164e0..bdafd521 100644
--- a/sdk/api-reference/openhands.sdk.utils.mdx
+++ b/sdk/api-reference/openhands.sdk.utils.mdx
@@ -6,6 +6,21 @@ description: API reference for openhands.sdk.utils module
 
 Utility functions for the OpenHands SDK.
 
+
+## Import shortcuts
+
+`page_iterator` is publicly exported from `openhands.sdk.utils` and from the top-level `openhands.sdk` package.
+
+```python
+from openhands.sdk.utils import page_iterator
+# or
+from openhands.sdk import page_iterator
+```
+
+### page_iterator()
+
+Iterate over items from paginated search results.
+
 ### deprecated()
 
 Return a decorator that deprecates a callable with explicit metadata.
diff --git a/sdk/api-reference/openhands.sdk.workspace.mdx b/sdk/api-reference/openhands.sdk.workspace.mdx
index 48066655..c77230e7 100644
--- a/sdk/api-reference/openhands.sdk.workspace.mdx
+++ b/sdk/api-reference/openhands.sdk.workspace.mdx
@@ -4,6 +4,17 @@ description: API reference for openhands.sdk.workspace module
 ---
 
 
+## Import shortcuts
+
+`AsyncRemoteWorkspace` is publicly exported from `openhands.sdk.workspace.remote`, `openhands.sdk.workspace`, and the top-level `openhands.sdk` package.
+
+```python
+from openhands.sdk.workspace import AsyncRemoteWorkspace
+# or
+from openhands.sdk import AsyncRemoteWorkspace
+```
+
+
 ### class BaseWorkspace
 
 Bases: `DiscriminatedUnionMixin`, `ABC`