runloopai · sid-rl · Nov 20, 2025 · Nov 20, 2025 · Nov 20, 2025 · Nov 20, 2025
diff --git a/docs/api/index.rst b/docs/api/index.rst
diff --git a/docs/conf.py b/docs/conf.py
@@ -15,7 +15,6 @@
 project = "Runloop Python SDK"
 copyright = "2025, Runloop"
 author = "Runloop"
-release = "0.68.0"
 
 # -- General configuration ---------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
@@ -40,18 +39,9 @@
 
 # -- Extension configuration -------------------------------------------------
 
-# Napoleon settings
-napoleon_google_docstring = False
-napoleon_numpy_docstring = False
-napoleon_use_param = True
-napoleon_use_rtype = True
-napoleon_use_ivar = True
-
 # Autodoc settings
 autodoc_default_options = {
     "members": None,
-    "undoc-members": None,
-    "show-inheritance": None,
 }
 
 autodoc_typehints = "description"
@@ -60,5 +50,4 @@
 # Intersphinx mapping
 intersphinx_mapping = {
     "python": ("https://docs.python.org/3", None),
-    "httpx": ("https://www.python-httpx.org", None),
 }
diff --git a/docs/index.rst b/docs/index.rst
@@ -9,7 +9,7 @@ and asynchronous variants to match your runtime requirements.
    :maxdepth: 2
    :caption: Contents:
 
-   api/index
+   sdk/index
 
 Installation
 ------------
@@ -42,16 +42,16 @@ Asynchronous Example
 
 .. code-block:: python
 
+   import asyncio
    from runloop_api_client import AsyncRunloopSDK
 
    async def main():
        runloop = AsyncRunloopSDK()
 
-       async with runloop.devbox.create(name="my-devbox") as devbox:
+       async with await runloop.devbox.create(name="my-devbox") as devbox:
            result = await devbox.cmd.exec(command="echo 'Hello from Runloop!'")
            print(await result.stdout())
 
-   import asyncio
    asyncio.run(main())
 
 Indices and tables

diff --git a/docs/sdk/async/blueprint.rst b/docs/sdk/async/blueprint.rst
@@ -0,0 +1,8 @@
+Blueprint
+=========
+
+The ``AsyncBlueprint`` class provides asynchronous methods for managing devbox blueprints.
+
+.. automodule:: runloop_api_client.sdk.async_blueprint
+   :members:
+
diff --git a/docs/sdk/async/devbox.rst b/docs/sdk/async/devbox.rst
@@ -0,0 +1,8 @@
+Devbox
+======
+
+The ``AsyncDevbox`` class provides asynchronous methods for managing and interacting with a devbox instance.
+
+.. automodule:: runloop_api_client.sdk.async_devbox
+   :members:
+
diff --git a/docs/sdk/async/execution.rst b/docs/sdk/async/execution.rst
@@ -0,0 +1,8 @@
+Execution
+=========
+
+The ``AsyncExecution`` class represents an asynchronous command execution in progress.
+
+.. automodule:: runloop_api_client.sdk.async_execution
+   :members:
+
diff --git a/docs/sdk/async/execution_result.rst b/docs/sdk/async/execution_result.rst
@@ -0,0 +1,8 @@
+Execution Result
+================
+
+The ``AsyncExecutionResult`` class represents the result of a completed command execution.
+
+.. automodule:: runloop_api_client.sdk.async_execution_result
+   :members:
+
diff --git a/docs/sdk/async/index.rst b/docs/sdk/async/index.rst
@@ -0,0 +1,29 @@
+Asynchronous SDK
+================
+
+The asynchronous SDK provides a non-blocking interface for managing devboxes, blueprints, snapshots, and storage objects. Use this variant when working with async/await Python code.
+
+Core Module
+-----------
+
+The core asynchronous SDK module provides async operation classes.
+
+.. autoclass:: runloop_api_client.sdk.async_.AsyncRunloopSDK
+
+.. automodule:: runloop_api_client.sdk.async_
+
+Resource Modules
+----------------
+
+Asynchronous resource classes for working with devboxes, blueprints, snapshots, and more.
+
+.. toctree::
+   :maxdepth: 1
+
+   devbox
+   execution
+   execution_result
+   blueprint
+   snapshot
+   storage_object
+
diff --git a/docs/sdk/async/snapshot.rst b/docs/sdk/async/snapshot.rst
@@ -0,0 +1,8 @@
+Snapshot
+========
+
+The ``AsyncSnapshot`` class provides asynchronous methods for managing devbox snapshots.
+
+.. automodule:: runloop_api_client.sdk.async_snapshot
+   :members:
+
diff --git a/docs/sdk/async/storage_object.rst b/docs/sdk/async/storage_object.rst
@@ -0,0 +1,8 @@
+Storage Object
+==============
+
+The ``AsyncStorageObject`` class provides asynchronous methods for managing storage objects.
+
+.. automodule:: runloop_api_client.sdk.async_storage_object
+   :members:
+
diff --git a/docs/sdk/index.rst b/docs/sdk/index.rst
@@ -0,0 +1,14 @@
+SDK Reference
+=============
+
+This section contains detailed documentation for the Runloop SDK.
+
+The Runloop SDK provides both synchronous and asynchronous interfaces for managing devboxes, blueprints, snapshots, and storage objects. Choose the variant that matches your application's runtime requirements.
+
+.. toctree::
+   :maxdepth: 2
+   :caption: SDK Documentation
+
+   sync/index
+   async/index
+   types
diff --git a/docs/sdk/sync/blueprint.rst b/docs/sdk/sync/blueprint.rst
@@ -0,0 +1,8 @@
+Blueprint
+=========
+
+The ``Blueprint`` class provides synchronous methods for managing devbox blueprints.
+
+.. automodule:: runloop_api_client.sdk.blueprint
+   :members:
+
diff --git a/docs/sdk/sync/devbox.rst b/docs/sdk/sync/devbox.rst
@@ -0,0 +1,8 @@
+Devbox
+======
+
+The ``Devbox`` class provides synchronous methods for managing and interacting with a devbox instance.
+
+.. automodule:: runloop_api_client.sdk.devbox
+   :members:
+
diff --git a/docs/sdk/sync/execution.rst b/docs/sdk/sync/execution.rst
@@ -0,0 +1,8 @@
+Execution
+=========
+
+The ``Execution`` class represents an asynchronous command execution in progress.
+
+.. automodule:: runloop_api_client.sdk.execution
+   :members:
+
diff --git a/docs/sdk/sync/execution_result.rst b/docs/sdk/sync/execution_result.rst
@@ -0,0 +1,8 @@
+Execution Result
+================
+
+The ``ExecutionResult`` class represents the result of a completed command execution.
+
+.. automodule:: runloop_api_client.sdk.execution_result
+   :members:
+
diff --git a/docs/sdk/sync/index.rst b/docs/sdk/sync/index.rst
@@ -0,0 +1,29 @@
+Synchronous SDK
+===============
+
+The synchronous SDK provides a blocking interface for managing devboxes, blueprints, snapshots, and storage objects. Use this variant when working in synchronous Python code.
+
+Core Module
+-----------
+
+The core synchronous SDK module provides the main entry point and operation classes.
+
+.. autoclass:: runloop_api_client.sdk.sync.RunloopSDK
+
+.. automodule:: runloop_api_client.sdk.sync
+
+Resource Modules
+----------------
+
+Synchronous resource classes for working with devboxes, blueprints, snapshots, and more.
+
+.. toctree::
+   :maxdepth: 1
+
+   devbox
+   execution
+   execution_result
+   blueprint
+   snapshot
+   storage_object
+
diff --git a/docs/sdk/sync/snapshot.rst b/docs/sdk/sync/snapshot.rst
@@ -0,0 +1,8 @@
+Snapshot
+========
+
+The ``Snapshot`` class provides synchronous methods for managing devbox snapshots.
+
+.. automodule:: runloop_api_client.sdk.snapshot
+   :members:
+
diff --git a/docs/sdk/sync/storage_object.rst b/docs/sdk/sync/storage_object.rst
@@ -0,0 +1,8 @@
+Storage Object
+==============
+
+The ``StorageObject`` class provides synchronous methods for managing storage objects.
+
+.. automodule:: runloop_api_client.sdk.storage_object
+   :members:
+