release: 1.23.0 (#795)

stainless-app[bot] · web-flow · commit 86718439f0e2 · 2026-06-08T17:26:54.000Z
Co-authored-by: stainless-app[bot] &lt;142633134+stainless-app[bot]@users.noreply.github.com&gt;
diff --git a/.release-please-manifest.json b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "1.22.1"
+  ".": "1.23.0"
 }
diff --git a/.stats.yml b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 120
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/runloop-ai/runloop-96b0ac0a148db6fde2e8363ea2dcfaa63f2dc23cf35c30c5fcfffbefc222e5d1.yml
-openapi_spec_hash: 01b9dbab4b732e4b83952debd108e404
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/runloop-ai/runloop-22ab4a80734e5e3792b7287a1281280d52eff936be4d805011521a1b64e1998d.yml
+openapi_spec_hash: d109d3b797016fe7657935d55549cc31
 config_hash: ed1fdd7c9f0a25647e16b602bad4ff2e
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,15 @@
 # Changelog
 
+## 1.23.0 (2026-06-05)
+
+Full Changelog: [v1.22.1...v1.23.0](https://github.com/runloopai/api-client-ts/compare/v1.22.1...v1.23.0)
+
+### Features
+
+* **devbox:** add SCHEDULED status to the data model ([#9654](https://github.com/runloopai/api-client-ts/issues/9654)) ([398e350](https://github.com/runloopai/api-client-ts/commit/398e350d12074fb6f3244b505df8a774922b114e))
+* opt-in HTTP/2 multiplexing transport via undici 7 (Node &gt;= 20.18.1) ([#791](https://github.com/runloopai/api-client-ts/issues/791)) ([4cafa17](https://github.com/runloopai/api-client-ts/commit/4cafa17b21d71eeaf8091784a8bf8e9fc40f786b))
+* **portal:** support tunnel authorization header ([#9597](https://github.com/runloopai/api-client-ts/issues/9597)) ([ed324c5](https://github.com/runloopai/api-client-ts/commit/ed324c59c596640896bda199fa2740ce53da06ac))
+
 ## 1.22.1 (2026-06-01)
 
 Full Changelog: [v1.22.0...v1.22.1](https://github.com/runloopai/api-client-ts/compare/v1.22.0...v1.22.1)
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@runloop/api-client",
-  "version": "1.22.1",
+  "version": "1.23.0",
   "description": "The official TypeScript library for the Runloop API",
   "author": "Runloop <support@runloop.ai>",
   "types": "dist/sdk.d.ts",
diff --git a/packages/mcp-server/manifest.json b/packages/mcp-server/manifest.json
@@ -1,7 +1,7 @@
 {
   "dxt_version": "0.2",
   "name": "@runloop/api-client-mcp",
-  "version": "1.22.1",
+  "version": "1.23.0",
   "description": "The official MCP Server for the Runloop API",
   "author": {
     "name": "Runloop",
diff --git a/packages/mcp-server/package.json b/packages/mcp-server/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@runloop/api-client-mcp",
-  "version": "1.22.1",
+  "version": "1.23.0",
   "description": "The official MCP Server for the Runloop API",
   "author": "Runloop <support@runloop.ai>",
   "types": "dist/index.d.ts",
diff --git a/packages/mcp-server/src/server.ts b/packages/mcp-server/src/server.ts
@@ -16,7 +16,7 @@ export const newMcpServer = async (stainlessApiKey: string | undefined) =>
   new McpServer(
     {
       name: 'runloop_api_client_api',
-      version: '1.22.1',
+      version: '1.23.0',
     },
     {
       instructions: await getInstructions(stainlessApiKey),
diff --git a/src/resources/devboxes/devboxes.ts b/src/resources/devboxes/devboxes.ts
@@ -169,8 +169,8 @@ export class Devboxes extends APIResource {
   /**
    * Create an ephemeral authenticated tunnel for terminal access to a running
    * 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.
    */
   createPtyTunnel(id: string, options?: Core.RequestOptions): Core.APIPromise<PtyTunnelView> {
     return this._client.post(`/v1/devboxes/${id}/create_pty_tunnel`, options);
@@ -851,6 +851,7 @@ export interface DevboxView {
    * The current status of the Devbox.
    */
   status:
+    | 'scheduled'
     | 'provisioning'
     | 'initializing'
     | 'running'
@@ -929,7 +930,8 @@ export interface DevboxView {
    * 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}.
    */
   tunnel?: TunnelView | null;
 }
@@ -939,17 +941,19 @@ export namespace DevboxView {
     /**
      * 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.
      */
     status?:
+      | 'scheduled'
       | 'provisioning'
       | 'initializing'
       | 'running'
@@ -994,11 +998,12 @@ export namespace DevboxView {
  * 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}
+ * X-Runloop-Tunnel-Authorization: Bearer {auth_token}.
  */
 export interface PtyTunnelView {
   /**
-   * 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}.
    */
   auth_token: string;
 
@@ -1015,7 +1020,8 @@ export interface PtyTunnelView {
  * 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}.
  */
 export interface TunnelView {
   /**
@@ -1048,7 +1054,7 @@ export interface TunnelView {
 
   /**
    * Bearer token for tunnel authentication. Only present when auth_mode is
-   * 'authenticated'.
+   * 'authenticated'. Pass as X-Runloop-Tunnel-Authorization: Bearer {auth_token}.
    */
   auth_token?: string | null;
 }
@@ -1278,6 +1284,7 @@ export interface DevboxListParams extends DevboxesCursorIDPageParams {
    * Filter by status
    */
   status?:
+    | 'scheduled'
     | 'provisioning'
     | 'initializing'
     | 'running'
diff --git a/src/version.ts b/src/version.ts
@@ -1 +1 @@
-export const VERSION = '1.22.1'; // x-release-please-version
+export const VERSION = '1.23.0'; // x-release-please-version
diff --git a/tests/api-resources/devboxes/devboxes.test.ts b/tests/api-resources/devboxes/devboxes.test.ts
@@ -167,7 +167,7 @@ describe('resource devboxes', () => {
           include_total_count: true,
           limit: 0,
           starting_after: 'starting_after',
-          status: 'provisioning',
+          status: 'scheduled',
         },
         { path: '/_stainless_unknown_path' },
       ),

Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,3 @@`
`1`	`1`	`{`
`2`		`- ".": "1.22.1"`
	`2`	`+ ".": "1.23.0"`
`3`	`3`	`}`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@runloop/api-client",`
`3`		`- "version": "1.22.1",`
	`3`	`+ "version": "1.23.0",`
`4`	`4`	`"description": "The official TypeScript library for the Runloop API",`
`5`	`5`	`"author": "Runloop <support@runloop.ai>",`
`6`	`6`	`"types": "dist/sdk.d.ts",`
Original file line number	Diff line number	Diff line change
`@@ -1,7 +1,7 @@`
`1`	`1`	`{`
`2`	`2`	`"dxt_version": "0.2",`
`3`	`3`	`"name": "@runloop/api-client-mcp",`
`4`		`- "version": "1.22.1",`
	`4`	`+ "version": "1.23.0",`
`5`	`5`	`"description": "The official MCP Server for the Runloop API",`
`6`	`6`	`"author": {`
`7`	`7`	`"name": "Runloop",`
Original file line number	Diff line number	Diff line change
`@@ -16,7 +16,7 @@ export const newMcpServer = async (stainlessApiKey: string \| undefined) =>`
`16`	`16`	`new McpServer(`
`17`	`17`	`{`
`18`	`18`	`name: 'runloop_api_client_api',`
`19`		`- version: '1.22.1',`
	`19`	`+ version: '1.23.0',`
`20`	`20`	`},`
`21`	`21`	`{`
`22`	`22`	`instructions: await getInstructions(stainlessApiKey),`
Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-export const VERSION = '1.22.1'; // x-release-please-version`
	`1`	`+export const VERSION = '1.23.0'; // x-release-please-version`