runloop_api_client 1.22.0__tar.gz → 1.23.0__tar.gz

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

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

{runloop_api_client-1.22.0 → runloop_api_client-1.23.0}/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 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)
+
+### Build System
+
+* **stainless:** map /v1/accounts/me to accounts.me in the SDK ([#9569](https://github.com/runloopai/api-client-python/issues/9569)) ([3f9cbe1](https://github.com/runloopai/api-client-python/commit/3f9cbe1e92c2eb9c1696f52cb11419bcafde6bd9))
+
 ## 1.22.0 (2026-05-27)
 
 Full Changelog: [v1.21.0...v1.22.0](https://github.com/runloopai/api-client-python/compare/v1.21.0...v1.22.0)

{runloop_api_client-1.22.0 → runloop_api_client-1.23.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: runloop_api_client
-Version: 1.22.0
+Version: 1.23.0
 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.0 → runloop_api_client-1.23.0}/api.md

@@ -17,6 +17,18 @@ from runloop_api_client.types import (
 )
 ```
 
+# Accounts
+
+Types:
+
+```python
+from runloop_api_client.types import AccountView
+```
+
+Methods:
+
+- <code title="get /v1/accounts/me">client.accounts.<a href="./src/runloop_api_client/resources/accounts.py">me</a>() -> <a href="./src/runloop_api_client/types/account_view.py">AccountView</a></code>
+
 # Benchmarks
 
 Types:

{runloop_api_client-1.22.0 → runloop_api_client-1.23.0}/pyproject.toml

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

{runloop_api_client-1.22.0 → runloop_api_client-1.23.0}/src/runloop_api_client/_client.py

@@ -42,6 +42,7 @@ if TYPE_CHECKING:
         apikeys,
         objects,
         secrets,
+        accounts,
         devboxes,
         scenarios,
         benchmarks,
@@ -58,6 +59,7 @@ if TYPE_CHECKING:
     from .resources.apikeys import ApikeysResource, AsyncApikeysResource
     from .resources.objects import ObjectsResource, AsyncObjectsResource
     from .resources.secrets import SecretsResource, AsyncSecretsResource
+    from .resources.accounts import AccountsResource, AsyncAccountsResource
     from .resources.benchmarks import BenchmarksResource, AsyncBenchmarksResource
     from .resources.blueprints import BlueprintsResource, AsyncBlueprintsResource
     from .resources.axons.axons import AxonsResource, AsyncAxonsResource
@@ -144,6 +146,12 @@ class Runloop(SyncAPIClient):
 
         self._idempotency_header = "x-request-id"
 
+    @cached_property
+    def accounts(self) -> AccountsResource:
+        from .resources.accounts import AccountsResource
+
+        return AccountsResource(self)
+
     @cached_property
     def benchmarks(self) -> BenchmarksResource:
         from .resources.benchmarks import BenchmarksResource
@@ -432,6 +440,12 @@ class AsyncRunloop(AsyncAPIClient):
 
         self._idempotency_header = "x-request-id"
 
+    @cached_property
+    def accounts(self) -> AsyncAccountsResource:
+        from .resources.accounts import AsyncAccountsResource
+
+        return AsyncAccountsResource(self)
+
     @cached_property
     def benchmarks(self) -> AsyncBenchmarksResource:
         from .resources.benchmarks import AsyncBenchmarksResource
@@ -655,6 +669,12 @@ class RunloopWithRawResponse:
     def __init__(self, client: Runloop) -> None:
         self._client = client
 
+    @cached_property
+    def accounts(self) -> accounts.AccountsResourceWithRawResponse:
+        from .resources.accounts import AccountsResourceWithRawResponse
+
+        return AccountsResourceWithRawResponse(self._client.accounts)
+
     @cached_property
     def benchmarks(self) -> benchmarks.BenchmarksResourceWithRawResponse:
         from .resources.benchmarks import BenchmarksResourceWithRawResponse
@@ -758,6 +778,12 @@ class AsyncRunloopWithRawResponse:
     def __init__(self, client: AsyncRunloop) -> None:
         self._client = client
 
+    @cached_property
+    def accounts(self) -> accounts.AsyncAccountsResourceWithRawResponse:
+        from .resources.accounts import AsyncAccountsResourceWithRawResponse
+
+        return AsyncAccountsResourceWithRawResponse(self._client.accounts)
+
     @cached_property
     def benchmarks(self) -> benchmarks.AsyncBenchmarksResourceWithRawResponse:
         from .resources.benchmarks import AsyncBenchmarksResourceWithRawResponse
@@ -861,6 +887,12 @@ class RunloopWithStreamedResponse:
     def __init__(self, client: Runloop) -> None:
         self._client = client
 
+    @cached_property
+    def accounts(self) -> accounts.AccountsResourceWithStreamingResponse:
+        from .resources.accounts import AccountsResourceWithStreamingResponse
+
+        return AccountsResourceWithStreamingResponse(self._client.accounts)
+
     @cached_property
     def benchmarks(self) -> benchmarks.BenchmarksResourceWithStreamingResponse:
         from .resources.benchmarks import BenchmarksResourceWithStreamingResponse
@@ -964,6 +996,12 @@ class AsyncRunloopWithStreamedResponse:
     def __init__(self, client: AsyncRunloop) -> None:
         self._client = client
 
+    @cached_property
+    def accounts(self) -> accounts.AsyncAccountsResourceWithStreamingResponse:
+        from .resources.accounts import AsyncAccountsResourceWithStreamingResponse
+
+        return AsyncAccountsResourceWithStreamingResponse(self._client.accounts)
+
     @cached_property
     def benchmarks(self) -> benchmarks.AsyncBenchmarksResourceWithStreamingResponse:
         from .resources.benchmarks import AsyncBenchmarksResourceWithStreamingResponse

{runloop_api_client-1.22.0 → runloop_api_client-1.23.0}/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.0"  # x-release-please-version
+__version__ = "1.23.0"  # x-release-please-version

{runloop_api_client-1.22.0 → runloop_api_client-1.23.0}/src/runloop_api_client/resources/__init__.py

@@ -48,6 +48,14 @@ from .secrets import (
     SecretsResourceWithStreamingResponse,
     AsyncSecretsResourceWithStreamingResponse,
 )
+from .accounts import (
+    AccountsResource,
+    AsyncAccountsResource,
+    AccountsResourceWithRawResponse,
+    AsyncAccountsResourceWithRawResponse,
+    AccountsResourceWithStreamingResponse,
+    AsyncAccountsResourceWithStreamingResponse,
+)
 from .devboxes import (
     DevboxesResource,
     AsyncDevboxesResource,
@@ -130,6 +138,12 @@ from .network_policies import (
 )
 
 __all__ = [
+    "AccountsResource",
+    "AsyncAccountsResource",
+    "AccountsResourceWithRawResponse",
+    "AsyncAccountsResourceWithRawResponse",
+    "AccountsResourceWithStreamingResponse",
+    "AsyncAccountsResourceWithStreamingResponse",
     "BenchmarksResource",
     "AsyncBenchmarksResource",
     "BenchmarksResourceWithRawResponse",

runloop_api_client-1.23.0/src/runloop_api_client/resources/accounts.py

@@ -0,0 +1,141 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+import httpx
+
+from .._types import Body, Query, Headers, NotGiven, not_given
+from .._compat import cached_property
+from .._resource import SyncAPIResource, AsyncAPIResource
+from .._response import (
+    to_raw_response_wrapper,
+    to_streamed_response_wrapper,
+    async_to_raw_response_wrapper,
+    async_to_streamed_response_wrapper,
+)
+from .._base_client import make_request_options
+from ..types.account_view import AccountView
+
+__all__ = ["AccountsResource", "AsyncAccountsResource"]
+
+
+class AccountsResource(SyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> AccountsResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/runloopai/api-client-python#accessing-raw-response-data-eg-headers
+        """
+        return AccountsResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AccountsResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/runloopai/api-client-python#with_streaming_response
+        """
+        return AccountsResourceWithStreamingResponse(self)
+
+    def me(
+        self,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> AccountView:
+        """
+        Returns the account the API key or session is authenticated against, including
+        id, name, tier, and billing summary.
+        """
+        return self._get(
+            "/v1/accounts/me",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=AccountView,
+        )
+
+
+class AsyncAccountsResource(AsyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> AsyncAccountsResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/runloopai/api-client-python#accessing-raw-response-data-eg-headers
+        """
+        return AsyncAccountsResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AsyncAccountsResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/runloopai/api-client-python#with_streaming_response
+        """
+        return AsyncAccountsResourceWithStreamingResponse(self)
+
+    async def me(
+        self,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> AccountView:
+        """
+        Returns the account the API key or session is authenticated against, including
+        id, name, tier, and billing summary.
+        """
+        return await self._get(
+            "/v1/accounts/me",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=AccountView,
+        )
+
+
+class AccountsResourceWithRawResponse:
+    def __init__(self, accounts: AccountsResource) -> None:
+        self._accounts = accounts
+
+        self.me = to_raw_response_wrapper(
+            accounts.me,
+        )
+
+
+class AsyncAccountsResourceWithRawResponse:
+    def __init__(self, accounts: AsyncAccountsResource) -> None:
+        self._accounts = accounts
+
+        self.me = async_to_raw_response_wrapper(
+            accounts.me,
+        )
+
+
+class AccountsResourceWithStreamingResponse:
+    def __init__(self, accounts: AccountsResource) -> None:
+        self._accounts = accounts
+
+        self.me = to_streamed_response_wrapper(
+            accounts.me,
+        )
+
+
+class AsyncAccountsResourceWithStreamingResponse:
+    def __init__(self, accounts: AsyncAccountsResource) -> None:
+        self._accounts = accounts
+
+        self.me = async_to_streamed_response_wrapper(
+            accounts.me,
+        )

{runloop_api_client-1.22.0 → runloop_api_client-1.23.0}/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.0 → runloop_api_client-1.23.0}/src/runloop_api_client/types/__init__.py

@@ -22,6 +22,7 @@ from .devbox_view import DevboxView as DevboxView
 from .object_view import ObjectView as ObjectView
 from .secret_view import SecretView as SecretView
 from .tunnel_view import TunnelView as TunnelView
+from .account_view import AccountView as AccountView
 from .input_context import InputContext as InputContext
 from .scenario_view import ScenarioView as ScenarioView
 from .axon_list_view import AxonListView as AxonListView

runloop_api_client-1.23.0/src/runloop_api_client/types/account_view.py

@@ -0,0 +1,97 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from typing_extensions import Literal
+
+from .._models import BaseModel
+
+__all__ = ["AccountView", "Billing", "BillingAws", "BillingStripe"]
+
+
+class BillingAws(BaseModel):
+    """AWS Marketplace billing information."""
+
+    customer_identifier: Optional[str] = None
+    """The AWS account ID used for Marketplace billing (12-digit)."""
+
+    license_arn: Optional[str] = None
+    """The AWS Marketplace license ARN."""
+
+    subscription_status: Optional[str] = None
+    """The AWS Marketplace subscription status."""
+
+
+class BillingStripe(BaseModel):
+    """Stripe billing information."""
+
+    active_subscription: Optional[str] = None
+    """The active Stripe subscription ID."""
+
+    customer_id: Optional[str] = None
+    """The Stripe customer ID."""
+
+
+class Billing(BaseModel):
+    """The account billing information."""
+
+    account_billing_type: Literal["STRIPE", "AWS_MARKETPLACE", "STRIPE_PROJECTS", "UNRECOGNIZED"]
+    """The account billing type."""
+
+    aws: Optional[BillingAws] = None
+    """AWS Marketplace billing information."""
+
+    stripe: Optional[BillingStripe] = None
+    """Stripe billing information."""
+
+    stripe_customer_id: Optional[str] = None
+    """Deprecated: use stripe.customer_id."""
+
+
+class AccountView(BaseModel):
+    """Account information."""
+
+    id: str
+    """The account ID."""
+
+    account_status: Literal[
+        "ACCOUNT_STATUS_INVALID",
+        "ACCOUNT_STATUS_ONBOARDING",
+        "ACCOUNT_STATUS_ENABLED",
+        "ACCOUNT_STATUS_DISABLED_BY_ADMIN",
+        "ACCOUNT_STATUS_DISABLED_QUOTA_REACHED",
+        "ACCOUNT_STATUS_TRIAL_CANCELLED",
+        "ACCOUNT_STATUS_STRIPE_PENDING_RESOURCES",
+        "UNRECOGNIZED",
+    ]
+    """The account status."""
+
+    billing: Billing
+    """The account billing information."""
+
+    created_at: str
+    """The account creation timestamp."""
+
+    name: str
+    """The account name."""
+
+    tier: Literal[
+        "ACCOUNT_TIER_INVALID",
+        "ACCOUNT_TIER_BASIC",
+        "ACCOUNT_TIER_PRO",
+        "ACCOUNT_TIER_ENTERPRISE",
+        "ACCOUNT_TIER_TRIAL",
+        "UNRECOGNIZED",
+    ]
+    """The account tier."""
+
+    account_billing_type: Optional[Literal["STRIPE", "AWS_MARKETPLACE", "STRIPE_PROJECTS", "UNRECOGNIZED"]] = None
+    """Deprecated: use billing.account_billing_type."""
+
+    active_subscription: Optional[str] = None
+    """Deprecated: use billing.stripe.active_subscription."""
+
+    external_billing_account_id: Optional[str] = None
+    """Deprecated: use billing.aws.customer_identifier."""
+
+    stripe_customer_id: Optional[str] = None
+    """Deprecated: use billing.stripe.customer_id."""

{runloop_api_client-1.22.0 → runloop_api_client-1.23.0}/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.0 → runloop_api_client-1.23.0}/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.0 → runloop_api_client-1.23.0}/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.0 → runloop_api_client-1.23.0}/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}.
     """