release: 0.67.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.66.0"
+  ".": "0.67.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 119
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-e66c3f8aedccc39104386a3ec619f3fdcef7e8b00d9e5aa82e414a1b387351c2.yml
-openapi_spec_hash: afeddf18ebc3da1521b3e6f6739411fa
-config_hash: 80eef1b592110714ea55cd26c470fabb
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-51549f813f3002e18c6ca8d850cc0c7932828d511c151e0412c73b6798d19e30.yml
+openapi_spec_hash: ee77b293c4bda91c1a32cfdd12b8739e
+config_hash: 57567e00b41af47cef1b78e51b747aa0

CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.67.0 (2026-06-11)
+
+Full Changelog: [v0.66.0...v0.67.0](https://github.com/kernel/kernel-node-sdk/compare/v0.66.0...v0.67.0)
+
+### Features
+
+* Add project_id SDK client option mapped to X-Kernel-Project-Id ([2de4df2](https://github.com/kernel/kernel-node-sdk/commit/2de4df21f6d2d2dd570bed37c4da34b2df34cf83))
+
+
+### Documentation
+
+* **api:** correct project-scoping descriptions in OpenAPI spec ([5320bde](https://github.com/kernel/kernel-node-sdk/commit/5320bdeec70aa344ccdf2c7f601574c655a8eac1))
+
 ## 0.66.0 (2026-06-10)
 
 Full Changelog: [v0.65.0...v0.66.0](https://github.com/kernel/kernel-node-sdk/compare/v0.65.0...v0.66.0)

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onkernel/sdk",
-  "version": "0.66.0",
+  "version": "0.67.0",
   "description": "The official TypeScript library for the Kernel API",
   "author": "Kernel <>",
   "types": "dist/index.d.ts",

src/client.ts

@@ -175,6 +175,8 @@ export interface ClientOptions {
    */
   apiKey?: string | undefined;
 
+  projectID?: string | null | undefined;
+
   /**
    * Specifies the environment to use for the API.
    *
@@ -258,6 +260,7 @@ export interface ClientOptions {
  */
 export class Kernel {
   apiKey: string;
+  projectID: string | null;
 
   baseURL: string;
   maxRetries: number;
@@ -277,6 +280,7 @@ export class Kernel {
    * API Client for interfacing with the Kernel API.
    *
    * @param {string | undefined} [opts.apiKey=process.env['KERNEL_API_KEY'] ?? undefined]
+   * @param {string | null | undefined} [opts.projectID]
    * @param {Environment} [opts.environment=production] - Specifies the environment URL to use for the API.
    * @param {string} [opts.baseURL=process.env['KERNEL_BASE_URL'] ?? https://api.onkernel.com/] - Override the default base URL for the API.
    * @param {number} [opts.timeout=1 minute] - The maximum amount of time (in milliseconds) the client will wait for a response before timing out.
@@ -289,6 +293,7 @@ export class Kernel {
   constructor({
     baseURL = readEnv('KERNEL_BASE_URL'),
     apiKey = readEnv('KERNEL_API_KEY'),
+    projectID = null,
     ...opts
   }: ClientOptions = {}) {
     // Check for Bun runtime in a way that avoids type errors if Bun is not defined
@@ -311,6 +316,7 @@ export class Kernel {
 
     const options: ClientOptions = {
       apiKey,
+      projectID,
       ...opts,
       baseURL,
       environment: opts.environment ?? 'production',
@@ -358,6 +364,7 @@ export class Kernel {
     this._options = options;
 
     this.apiKey = apiKey;
+    this.projectID = projectID;
   }
 
   /**
@@ -375,6 +382,7 @@ export class Kernel {
       fetch: this.rawFetch,
       fetchOptions: this.fetchOptions,
       apiKey: this.apiKey,
+      projectID: this.projectID,
       ...options,
     });
     client.browserRouteCache = this.browserRouteCache;
@@ -851,6 +859,7 @@ export class Kernel {
         'X-Stainless-Retry-Count': String(retryCount),
         ...(options.timeout ? { 'X-Stainless-Timeout': String(Math.trunc(options.timeout / 1000)) } : {}),
         ...getPlatformHeaders(),
+        'X-Kernel-Project-Id': this.projectID,
       },
       await this.authHeaders(options),
       this._options.defaultHeaders,

src/resources/auth/connections.ts

@@ -699,8 +699,8 @@ export interface ManagedAuthCreateRequest {
   login_url?: string;
 
   /**
-   * Proxy selection. Provide either id or name. The proxy must belong to the
-   * caller's org.
+   * Proxy selection. Provide either id or name. The proxy must be in the same
+   * project as the resource referencing it.
    */
   proxy?: ManagedAuthCreateRequest.Proxy;
 
@@ -748,8 +748,8 @@ export namespace ManagedAuthCreateRequest {
   }
 
   /**
-   * Proxy selection. Provide either id or name. The proxy must belong to the
-   * caller's org.
+   * Proxy selection. Provide either id or name. The proxy must be in the same
+   * project as the resource referencing it.
    */
   export interface Proxy {
     /**
@@ -812,8 +812,8 @@ export interface ManagedAuthUpdateRequest {
   login_url?: string;
 
   /**
-   * Proxy selection. Provide either id or name. The proxy must belong to the
-   * caller's org.
+   * Proxy selection. Provide either id or name. The proxy must be in the same
+   * project as the resource referencing it.
    */
   proxy?: ManagedAuthUpdateRequest.Proxy;
 
@@ -859,8 +859,8 @@ export namespace ManagedAuthUpdateRequest {
   }
 
   /**
-   * Proxy selection. Provide either id or name. The proxy must belong to the
-   * caller's org.
+   * Proxy selection. Provide either id or name. The proxy must be in the same
+   * project as the resource referencing it.
    */
   export interface Proxy {
     /**
@@ -1215,8 +1215,8 @@ export interface ConnectionCreateParams {
   login_url?: string;
 
   /**
-   * Proxy selection. Provide either id or name. The proxy must belong to the
-   * caller's org.
+   * Proxy selection. Provide either id or name. The proxy must be in the same
+   * project as the resource referencing it.
    */
   proxy?: ConnectionCreateParams.Proxy;
 
@@ -1264,8 +1264,8 @@ export namespace ConnectionCreateParams {
   }
 
   /**
-   * Proxy selection. Provide either id or name. The proxy must belong to the
-   * caller's org.
+   * Proxy selection. Provide either id or name. The proxy must be in the same
+   * project as the resource referencing it.
    */
   export interface Proxy {
     /**
@@ -1325,8 +1325,8 @@ export interface ConnectionUpdateParams {
   login_url?: string;
 
   /**
-   * Proxy selection. Provide either id or name. The proxy must belong to the
-   * caller's org.
+   * Proxy selection. Provide either id or name. The proxy must be in the same
+   * project as the resource referencing it.
    */
   proxy?: ConnectionUpdateParams.Proxy;
 
@@ -1372,8 +1372,8 @@ export namespace ConnectionUpdateParams {
   }
 
   /**
-   * Proxy selection. Provide either id or name. The proxy must belong to the
-   * caller's org.
+   * Proxy selection. Provide either id or name. The proxy must be in the same
+   * project as the resource referencing it.
    */
   export interface Proxy {
     /**
@@ -1402,8 +1402,8 @@ export interface ConnectionListParams extends OffsetPaginationParams {
 
 export interface ConnectionLoginParams {
   /**
-   * Proxy selection. Provide either id or name. The proxy must belong to the
-   * caller's org.
+   * Proxy selection. Provide either id or name. The proxy must be in the same
+   * project as the resource referencing it.
    */
   proxy?: ConnectionLoginParams.Proxy;
 
@@ -1416,8 +1416,8 @@ export interface ConnectionLoginParams {
 
 export namespace ConnectionLoginParams {
   /**
-   * Proxy selection. Provide either id or name. The proxy must belong to the
-   * caller's org.
+   * Proxy selection. Provide either id or name. The proxy must be in the same
+   * project as the resource referencing it.
    */
   export interface Proxy {
     /**

src/resources/browser-pools.ts

@@ -57,7 +57,7 @@ export class BrowserPools extends APIResource {
   }
 
   /**
-   * List browser pools owned by the caller's organization.
+   * List browser pools in the resolved project.
    *
    * @example
    * ```ts
@@ -241,8 +241,8 @@ export namespace BrowserPool {
     profile?: Shared.BrowserProfile;
 
     /**
-     * Optional proxy to associate to the browser session. Must reference a proxy
-     * belonging to the caller's org.
+     * Optional proxy to associate to the browser session. Must reference a proxy in
+     * the same project as the browser session.
      */
     proxy_id?: string;
 
@@ -467,8 +467,8 @@ export interface BrowserPoolCreateParams {
   profile?: Shared.BrowserProfile;
 
   /**
-   * Optional proxy to associate to the browser session. Must reference a proxy
-   * belonging to the caller's org.
+   * Optional proxy to associate to the browser session. Must reference a proxy in
+   * the same project as the browser session.
    */
   proxy_id?: string;
 
@@ -559,8 +559,8 @@ export interface BrowserPoolUpdateParams {
   profile?: Shared.BrowserProfile;
 
   /**
-   * Optional proxy to associate to the browser session. Must reference a proxy
-   * belonging to the caller's org.
+   * Optional proxy to associate to the browser session. Must reference a proxy in
+   * the same project as the browser session.
    */
   proxy_id?: string;
 

src/resources/browsers/browsers.ts

@@ -941,8 +941,8 @@ export interface BrowserCreateParams {
   profile?: Shared.BrowserProfile;
 
   /**
-   * Optional proxy to associate to the browser session. Must reference a proxy
-   * belonging to the caller's org.
+   * Optional proxy to associate to the browser session. Must reference a proxy in
+   * the same project as the browser session.
    */
   proxy_id?: string;
 

src/resources/credentials.ts

@@ -60,8 +60,7 @@ export class Credentials extends APIResource {
   }
 
   /**
-   * List credentials owned by the caller's organization. Credential values are not
-   * returned.
+   * List credentials in the resolved project. Credential values are not returned.
    *
    * @example
    * ```ts

src/resources/extensions.ts

@@ -14,7 +14,7 @@ import { path } from '../internal/utils/path';
  */
 export class Extensions extends APIResource {
   /**
-   * List extensions owned by the caller's organization.
+   * List extensions in the resolved project.
    *
    * @example
    * ```ts

src/resources/proxies.ts

@@ -12,21 +12,21 @@ import { path } from '../internal/utils/path';
  */
 export class Proxies extends APIResource {
   /**
-   * Create a new proxy configuration for the caller's organization.
+   * Create a new proxy configuration in the resolved project.
    */
   create(body: ProxyCreateParams, options?: RequestOptions): APIPromise<ProxyCreateResponse> {
     return this._client.post('/proxies', { body, ...options });
   }
 
   /**
-   * Retrieve a proxy belonging to the caller's organization by ID.
+   * Retrieve a proxy in the resolved project by ID.
    */
   retrieve(id: string, options?: RequestOptions): APIPromise<ProxyRetrieveResponse> {
     return this._client.get(path`/proxies/${id}`, options);
   }
 
   /**
-   * List proxies owned by the caller's organization.
+   * List proxies in the resolved project.
    */
   list(
     query: ProxyListParams | null | undefined = {},

src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.66.0'; // x-release-please-version
+export const VERSION = '0.67.0'; // x-release-please-version