@onkernel/sdk 0.66.0 → 0.68.0

package/src/resources/api-keys.ts

@@ -34,8 +34,12 @@ export class APIKeys extends APIResource {
    * const apiKey = await client.apiKeys.retrieve('id');
    * ```
    */
-  retrieve(id: string, options?: RequestOptions): APIPromise<APIKey> {
-    return this._client.get(path`/org/api_keys/${id}`, options);
+  retrieve(
+    id: string,
+    query: APIKeyRetrieveParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<APIKey> {
+    return this._client.get(path`/org/api_keys/${id}`, { query, ...options });
   }
 
   /**
@@ -84,6 +88,24 @@ export class APIKeys extends APIResource {
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
   }
+
+  /**
+   * Rotate an API key. Issues a new key that copies the name and project of the
+   * rotated key, and schedules the rotated key to expire after a grace period so
+   * in-flight callers can swap over. The new plaintext key is returned once.
+   *
+   * @example
+   * ```ts
+   * const createdAPIKey = await client.apiKeys.rotate('id');
+   * ```
+   */
+  rotate(
+    id: string,
+    body: APIKeyRotateParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<CreatedAPIKey> {
+    return this._client.post(path`/org/api_keys/${id}/rotate`, { body, ...options });
+  }
 }
 
 export type APIKeysOffsetPagination = OffsetPagination<APIKey>;
@@ -101,6 +123,12 @@ export interface APIKey {
 
   created_by: APIKey.CreatedBy;
 
+  /**
+   * When the API key was deleted (soft-deleted). Null for keys that have not been
+   * deleted.
+   */
+  deleted_at: string | null;
+
   /**
    * When the API key expires
    */
@@ -174,6 +202,14 @@ export interface APIKeyCreateParams {
   project_id?: string | null;
 }
 
+export interface APIKeyRetrieveParams {
+  /**
+   * When true, return the API key even if it has been deleted (soft-deleted), for
+   * audit purposes. Defaults to false, which returns 404 for a deleted key.
+   */
+  include_deleted?: boolean;
+}
+
 export interface APIKeyUpdateParams {
   /**
    * New API key name
@@ -182,6 +218,12 @@ export interface APIKeyUpdateParams {
 }
 
 export interface APIKeyListParams extends OffsetPaginationParams {
+  /**
+   * Deprecated: use status=all instead. When true, include deleted (soft-deleted)
+   * API keys in the results for audit purposes.
+   */
+  include_deleted?: boolean;
+
   /**
    * Case-insensitive substring match against API key name, creator, and project. API
    * key identifiers and masked keys match by exact value or prefix.
@@ -197,6 +239,27 @@ export interface APIKeyListParams extends OffsetPaginationParams {
    * Sort direction for API keys.
    */
   sort_direction?: 'asc' | 'desc';
+
+  /**
+   * Filter API keys by status. "active" returns keys that are not deleted (default;
+   * expired-but-not-deleted keys are still included), "deleted" returns only
+   * soft-deleted keys, "all" returns both.
+   */
+  status?: 'active' | 'deleted' | 'all';
+}
+
+export interface APIKeyRotateParams {
+  /**
+   * Lifetime in days for the new key, up to 3650. Omit to reuse the rotated key's
+   * original lifetime, or never-expires if it had none.
+   */
+  days_to_expire?: number | null;
+
+  /**
+   * Grace period in days before the rotated key expires. Use 0 to expire it
+   * immediately. Omit for the default grace period of 7 days.
+   */
+  expire_in_days?: number | null;
 }
 
 export declare namespace APIKeys {
@@ -205,7 +268,9 @@ export declare namespace APIKeys {
     type CreatedAPIKey as CreatedAPIKey,
     type APIKeysOffsetPagination as APIKeysOffsetPagination,
     type APIKeyCreateParams as APIKeyCreateParams,
+    type APIKeyRetrieveParams as APIKeyRetrieveParams,
     type APIKeyUpdateParams as APIKeyUpdateParams,
     type APIKeyListParams as APIKeyListParams,
+    type APIKeyRotateParams as APIKeyRotateParams,
   };
 }

package/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 {
     /**

package/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;
 

package/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;
 

package/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

package/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

package/src/resources/index.ts

@@ -6,8 +6,10 @@ export {
   type APIKey,
   type CreatedAPIKey,
   type APIKeyCreateParams,
+  type APIKeyRetrieveParams,
   type APIKeyUpdateParams,
   type APIKeyListParams,
+  type APIKeyRotateParams,
   type APIKeysOffsetPagination,
 } from './api-keys';
 export {

package/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 = {},

package/src/version.ts

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

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.66.0";
+export declare const VERSION = "0.68.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.66.0";
+export declare const VERSION = "0.68.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.66.0'; // x-release-please-version
+exports.VERSION = '0.68.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.66.0'; // x-release-please-version
+export const VERSION = '0.68.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map