feat: Add API-backed API key management endpoints

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 117
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-2d1337eec44e036b9c896b7db4691f0a12edfa79d3f28b611818bcedf62d44ee.yml
-openapi_spec_hash: 30110dbbe733b16e40a6d0aa41d0c8c4
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-3a1db7f11a92b28681929255ada59d2317ee4db98b5ff5aa6ce142a0664058b3.yml
+openapi_spec_hash: b3064eaa589ae2a84993686ad1a3ee43
 config_hash: ede72e4ae65cc5a6d6927938b3455c46

src/kernel/resources/api_keys.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 from typing import Optional
+from typing_extensions import Literal
 
 import httpx
 
@@ -171,6 +172,9 @@ def list(
         *,
         limit: int | Omit = omit,
         offset: int | Omit = omit,
+        query: str | Omit = omit,
+        sort_by: Literal["created_at", "name", "expires_at"] | Omit = omit,
+        sort_direction: Literal["asc", "desc"] | Omit = omit,
         # 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,
@@ -187,6 +191,13 @@ def list(
 
           offset: Number of results to skip
 
+          query: Case-insensitive substring match against API key name, creator, and project. API
+              key identifiers and masked keys match by exact value or prefix.
+
+          sort_by: Field to sort API keys by.
+
+          sort_direction: Sort direction for API keys.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -207,6 +218,9 @@ def list(
                     {
                         "limit": limit,
                         "offset": offset,
+                        "query": query,
+                        "sort_by": sort_by,
+                        "sort_direction": sort_direction,
                     },
                     api_key_list_params.APIKeyListParams,
                 ),
@@ -395,6 +409,9 @@ def list(
         *,
         limit: int | Omit = omit,
         offset: int | Omit = omit,
+        query: str | Omit = omit,
+        sort_by: Literal["created_at", "name", "expires_at"] | Omit = omit,
+        sort_direction: Literal["asc", "desc"] | Omit = omit,
         # 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,
@@ -411,6 +428,13 @@ def list(
 
           offset: Number of results to skip
 
+          query: Case-insensitive substring match against API key name, creator, and project. API
+              key identifiers and masked keys match by exact value or prefix.
+
+          sort_by: Field to sort API keys by.
+
+          sort_direction: Sort direction for API keys.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -431,6 +455,9 @@ def list(
                     {
                         "limit": limit,
                         "offset": offset,
+                        "query": query,
+                        "sort_by": sort_by,
+                        "sort_direction": sort_direction,
                     },
                     api_key_list_params.APIKeyListParams,
                 ),

src/kernel/types/api_key_list_params.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing_extensions import TypedDict
+from typing_extensions import Literal, TypedDict
 
 __all__ = ["APIKeyListParams"]
 
@@ -13,3 +13,15 @@ class APIKeyListParams(TypedDict, total=False):
 
     offset: int
     """Number of results to skip"""
+
+    query: str
+    """Case-insensitive substring match against API key name, creator, and project.
+
+    API key identifiers and masked keys match by exact value or prefix.
+    """
+
+    sort_by: Literal["created_at", "name", "expires_at"]
+    """Field to sort API keys by."""
+
+    sort_direction: Literal["asc", "desc"]
+    """Sort direction for API keys."""

tests/api_resources/test_api_keys.py

@@ -162,6 +162,9 @@ def test_method_list_with_all_params(self, client: Kernel) -> None:
         api_key = client.api_keys.list(
             limit=100,
             offset=0,
+            query="query",
+            sort_by="created_at",
+            sort_direction="asc",
         )
         assert_matches_type(SyncOffsetPagination[APIKey], api_key, path=["response"])
 
@@ -379,6 +382,9 @@ async def test_method_list_with_all_params(self, async_client: AsyncKernel) -> N
         api_key = await async_client.api_keys.list(
             limit=100,
             offset=0,
+            query="query",
+            sort_by="created_at",
+            sort_direction="asc",
         )
         assert_matches_type(AsyncOffsetPagination[APIKey], api_key, path=["response"])