refactor(api): align API key audit surface with browser sibling (KERNEL-1350)

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 120
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-1f10598afa01d76d22b0ed63685248f482f74c9353cffe1d3e4a3d38da7716cf.yml
-openapi_spec_hash: 8936f458bfa681b709e459ca1cc76fb5
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-e8afdbeac9332cf79200c2eb873e532104fd0a7472b08e63cde6c857a87cf0c3.yml
+openapi_spec_hash: 2525caf30dffbdd83c83948201f11a52
 config_hash: 03c7e57f268c750e2415831662e95969

src/resources/api-keys.ts

@@ -154,13 +154,6 @@ export interface APIKey {
    * project name is unavailable.
    */
   project_name: string | null;
-
-  /**
-   * Derived lifecycle status of the API key. `active` means usable. `expired` means
-   * past its expires_at. `deleted` means it was deleted (soft-deleted) and can no
-   * longer authenticate. Deleted takes precedence over expired.
-   */
-  status: 'active' | 'expired' | 'deleted';
 }
 
 export namespace APIKey {
@@ -226,8 +219,8 @@ export interface APIKeyUpdateParams {
 
 export interface APIKeyListParams extends OffsetPaginationParams {
   /**
-   * When true, include deleted (soft-deleted) API keys in the results for audit
-   * purposes. Defaults to false, which returns only live keys.
+   * Deprecated: use status=all instead. When true, include deleted (soft-deleted)
+   * API keys in the results for audit purposes.
    */
   include_deleted?: boolean;
 
@@ -246,6 +239,13 @@ 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 {

tests/api-resources/api-keys.test.ts

@@ -90,6 +90,7 @@ describe('resource apiKeys', () => {
           query: 'query',
           sort_by: 'created_at',
           sort_direction: 'asc',
+          status: 'active',
         },
         { path: '/_stainless_unknown_path' },
       ),