runloop_api_client 1.22.1__tar.gz → 1.23.1__tar.gz

runloop_api_client-1.23.1/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "1.23.1"
+}

{runloop_api_client-1.22.1 → runloop_api_client-1.23.1}/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 1.23.1 (2026-06-09)
+
+Full Changelog: [v1.23.0...v1.23.1](https://github.com/runloopai/api-client-python/compare/v1.23.0...v1.23.1)
+
+### Features
+
+* **devbox:** add provisioning_tier (flex) to LaunchParameters (alpha) ([#808](https://github.com/runloopai/api-client-python/issues/808)) ([cb59e8b](https://github.com/runloopai/api-client-python/commit/cb59e8bcb4578a8abc8c31902a80ec491949310b))
+
+## 1.23.0 (2026-06-05)
+
+Full Changelog: [v1.22.1...v1.23.0](https://github.com/runloopai/api-client-python/compare/v1.22.1...v1.23.0)
+
+### Features
+
+* **devbox:** add SCHEDULED status to the data model ([#9654](https://github.com/runloopai/api-client-python/issues/9654)) ([8f45663](https://github.com/runloopai/api-client-python/commit/8f456631f96a56612ae9b438e9b6d2dc8d69095f))
+* **portal:** support tunnel authorization header ([#9597](https://github.com/runloopai/api-client-python/issues/9597)) ([8ca990e](https://github.com/runloopai/api-client-python/commit/8ca990e360f072adfdb9f789e37dbd2bb08e8f77))
+
 ## 1.22.1 (2026-06-01)
 
 Full Changelog: [v1.22.0...v1.22.1](https://github.com/runloopai/api-client-python/compare/v1.22.0...v1.22.1)

{runloop_api_client-1.22.1 → runloop_api_client-1.23.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: runloop_api_client
-Version: 1.22.1
+Version: 1.23.1
 Summary: The official Python library for the runloop API
 Project-URL: Homepage, https://github.com/runloopai/api-client-python
 Project-URL: Repository, https://github.com/runloopai/api-client-python

{runloop_api_client-1.22.1 → runloop_api_client-1.23.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "runloop_api_client"
-version = "1.22.1"
+version = "1.23.1"
 description = "The official Python library for the runloop API"
 dynamic = ["readme"]
 license = "MIT"

{runloop_api_client-1.22.1 → runloop_api_client-1.23.1}/src/runloop_api_client/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "runloop_api_client"
-__version__ = "1.22.1"  # x-release-please-version
+__version__ = "1.23.1"  # x-release-please-version

{runloop_api_client-1.22.1 → runloop_api_client-1.23.1}/src/runloop_api_client/resources/devboxes/devboxes.py

@@ -532,7 +532,15 @@ class DevboxesResource(SyncAPIResource):
         limit: int | Omit = omit,
         starting_after: str | Omit = omit,
         status: Literal[
-            "provisioning", "initializing", "running", "suspending", "suspended", "resuming", "failure", "shutdown"
+            "scheduled",
+            "provisioning",
+            "initializing",
+            "running",
+            "suspending",
+            "suspended",
+            "resuming",
+            "failure",
+            "shutdown",
         ]
         | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -600,8 +608,8 @@ class DevboxesResource(SyncAPIResource):
         Devbox.
 
         This tunnel is not persisted on the Devbox and is generated fresh on
-        each request. The returned auth_token must be passed as a Bearer token in the
-        Authorization header.
+        each request. The returned auth_token should be passed as a Bearer token in the
+        X-Runloop-Tunnel-Authorization header.
 
         Args:
           extra_headers: Send extra headers
@@ -2195,7 +2203,15 @@ class AsyncDevboxesResource(AsyncAPIResource):
         limit: int | Omit = omit,
         starting_after: str | Omit = omit,
         status: Literal[
-            "provisioning", "initializing", "running", "suspending", "suspended", "resuming", "failure", "shutdown"
+            "scheduled",
+            "provisioning",
+            "initializing",
+            "running",
+            "suspending",
+            "suspended",
+            "resuming",
+            "failure",
+            "shutdown",
         ]
         | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -2263,8 +2279,8 @@ class AsyncDevboxesResource(AsyncAPIResource):
         Devbox.
 
         This tunnel is not persisted on the Devbox and is generated fresh on
-        each request. The returned auth_token must be passed as a Bearer token in the
-        Authorization header.
+        each request. The returned auth_token should be passed as a Bearer token in the
+        X-Runloop-Tunnel-Authorization header.
 
         Args:
           extra_headers: Send extra headers

{runloop_api_client-1.22.1 → runloop_api_client-1.23.1}/src/runloop_api_client/types/devbox_list_params.py

@@ -21,6 +21,14 @@ class DevboxListParams(TypedDict, total=False):
     """Load the next page of data starting after the item with the given ID."""
 
     status: Literal[
-        "provisioning", "initializing", "running", "suspending", "suspended", "resuming", "failure", "shutdown"
+        "scheduled",
+        "provisioning",
+        "initializing",
+        "running",
+        "suspending",
+        "suspended",
+        "resuming",
+        "failure",
+        "shutdown",
     ]
     """Filter by status"""

{runloop_api_client-1.22.1 → runloop_api_client-1.23.1}/src/runloop_api_client/types/devbox_view.py

@@ -12,19 +12,30 @@ __all__ = ["DevboxView", "StateTransition", "GatewaySpecs", "McpSpecs"]
 
 class StateTransition(BaseModel):
     status: Optional[
-        Literal["provisioning", "initializing", "running", "suspending", "suspended", "resuming", "failure", "shutdown"]
+        Literal[
+            "scheduled",
+            "provisioning",
+            "initializing",
+            "running",
+            "suspending",
+            "suspended",
+            "resuming",
+            "failure",
+            "shutdown",
+        ]
     ] = None
     """The status of the Devbox.
 
-    provisioning: Runloop is allocating and booting the necessary infrastructure
-    resources. initializing: Runloop defined boot scripts are running to enable the
-    environment for interaction. running: The Devbox is ready for interaction.
-    suspending: The Devbox disk is being snapshotted as part of suspension.
-    suspended: The Devbox disk is saved and no more active compute is being used for
-    the Devbox. resuming: The Devbox disk is being loaded as part of booting a
-    suspended Devbox. failure: The Devbox failed as part of booting or running user
-    requested actions. shutdown: The Devbox was successfully shutdown and no more
-    active compute is being used.
+    scheduled: The Devbox is scheduled to run but infrastructure allocation has not
+    started yet. provisioning: Runloop is allocating and booting the necessary
+    infrastructure resources. initializing: Runloop defined boot scripts are running
+    to enable the environment for interaction. running: The Devbox is ready for
+    interaction. suspending: The Devbox disk is being snapshotted as part of
+    suspension. suspended: The Devbox disk is saved and no more active compute is
+    being used for the Devbox. resuming: The Devbox disk is being loaded as part of
+    booting a suspended Devbox. failure: The Devbox failed as part of booting or
+    running user requested actions. shutdown: The Devbox was successfully shutdown
+    and no more active compute is being used.
     """
 
     transition_time_ms: Optional[object] = None
@@ -78,7 +89,15 @@ class DevboxView(BaseModel):
     """A list of state transitions in order with durations"""
 
     status: Literal[
-        "provisioning", "initializing", "running", "suspending", "suspended", "resuming", "failure", "shutdown"
+        "scheduled",
+        "provisioning",
+        "initializing",
+        "running",
+        "suspending",
+        "suspended",
+        "resuming",
+        "failure",
+        "shutdown",
     ]
     """The current status of the Devbox."""
 
@@ -146,5 +165,6 @@ class DevboxView(BaseModel):
     services running inside a Devbox without requiring direct network access. Each
     tunnel is uniquely identified by an encrypted tunnel_key and can be configured
     for either open (public) or authenticated access. Usage:
-    https://{port}-{tunnel_key}.tunnel.runloop.ai
+    https://{port}-{tunnel_key}.tunnel.runloop.ai. Authenticated tunnels should pass
+    auth_token as X-Runloop-Tunnel-Authorization: Bearer {auth_token}.
     """

{runloop_api_client-1.22.1 → runloop_api_client-1.23.1}/src/runloop_api_client/types/pty_tunnel_view.py

@@ -8,11 +8,15 @@ __all__ = ["PtyTunnelView"]
 class PtyTunnelView(BaseModel):
     """An ephemeral PTY tunnel providing authenticated terminal access to a Devbox.
 
-    These tunnels are not stored on the Devbox and are generated fresh on each request. Usage: https://{port}-{tunnel_key}.tunnel.runloop.ai with Authorization: Bearer {auth_token}
+    These tunnels are not stored on the Devbox and are generated fresh on each request. Usage: https://{port}-{tunnel_key}.tunnel.runloop.ai with X-Runloop-Tunnel-Authorization: Bearer {auth_token}.
     """
 
     auth_token: str
-    """Bearer token for tunnel authentication. Always required for PTY tunnels."""
+    """Bearer token for tunnel authentication.
+
+    Always required for PTY tunnels. Pass as X-Runloop-Tunnel-Authorization: Bearer
+    {auth_token}.
+    """
 
     tunnel_key: str
     """The encrypted tunnel key used to construct the tunnel URL.

{runloop_api_client-1.22.1 → runloop_api_client-1.23.1}/src/runloop_api_client/types/shared/launch_parameters.py

@@ -74,6 +74,12 @@ class LaunchParameters(BaseModel):
     will inherit this policy unless explicitly overridden.
     """
 
+    provisioning_tier: Optional[Literal["standard", "flex"]] = None
+    """(Optional, Alpha) standard is default and flex is lazily provisioned and may be pre-empted.
+
+    This is an alpha feature and its behavior may change without notice.
+    """
+
     required_services: Optional[List[str]] = None
     """A list of ContainerizedService names to be started when a Devbox is created.
 

{runloop_api_client-1.22.1 → runloop_api_client-1.23.1}/src/runloop_api_client/types/shared_params/launch_parameters.py

@@ -76,6 +76,12 @@ class LaunchParameters(TypedDict, total=False):
     will inherit this policy unless explicitly overridden.
     """
 
+    provisioning_tier: Optional[Literal["standard", "flex"]]
+    """(Optional, Alpha) standard is default and flex is lazily provisioned and may be pre-empted.
+
+    This is an alpha feature and its behavior may change without notice.
+    """
+
     required_services: Optional[SequenceNotStr[str]]
     """A list of ContainerizedService names to be started when a Devbox is created.
 

{runloop_api_client-1.22.1 → runloop_api_client-1.23.1}/src/runloop_api_client/types/tunnel_view.py

@@ -12,7 +12,7 @@ class TunnelView(BaseModel):
     """A V2 tunnel provides secure HTTP access to services running on a Devbox.
 
     Tunnels allow external clients to reach web servers, APIs, or other HTTP services running inside a Devbox without requiring direct network access. Each tunnel is uniquely identified by an encrypted tunnel_key and can be configured for either open (public) or authenticated access.
-    Usage: https://{port}-{tunnel_key}.tunnel.runloop.ai
+    Usage: https://{port}-{tunnel_key}.tunnel.runloop.ai. Authenticated tunnels should pass auth_token as X-Runloop-Tunnel-Authorization: Bearer {auth_token}.
     """
 
     auth_mode: Literal["open", "authenticated"]
@@ -42,5 +42,6 @@ class TunnelView(BaseModel):
     auth_token: Optional[str] = None
     """Bearer token for tunnel authentication.
 
-    Only present when auth_mode is 'authenticated'.
+    Only present when auth_mode is 'authenticated'. Pass as
+    X-Runloop-Tunnel-Authorization: Bearer {auth_token}.
     """

{runloop_api_client-1.22.1 → runloop_api_client-1.23.1}/tests/api_resources/test_devboxes.py

@@ -250,7 +250,7 @@ class TestDevboxes:
             include_total_count=True,
             limit=0,
             starting_after="starting_after",
-            status="provisioning",
+            status="scheduled",
         )
         assert_matches_type(SyncDevboxesCursorIDPage[DevboxView], devbox, path=["response"])
 
@@ -1919,7 +1919,7 @@ class TestAsyncDevboxes:
             include_total_count=True,
             limit=0,
             starting_after="starting_after",
-            status="provisioning",
+            status="scheduled",
         )
         assert_matches_type(AsyncDevboxesCursorIDPage[DevboxView], devbox, path=["response"])
 

runloop_api_client-1.22.1/.release-please-manifest.json

@@ -1,3 +0,0 @@
-{
-  ".": "1.22.1"
-}