feat: api: sort API keys by last_used_at

Stainless-Generated-From: e3aff28049cbaf7e91e7e6c055ab46224e111eb6

Author: kernel-internal[bot]

src/kernel/resources/api_keys.py

@@ -219,7 +219,7 @@ def list(
         name: str | Omit = omit,
         offset: int | Omit = omit,
         query: str | Omit = omit,
-        sort_by: Literal["created_at", "name", "expires_at"] | Omit = omit,
+        sort_by: Literal["created_at", "name", "expires_at", "last_used_at"] | Omit = omit,
         sort_direction: Literal["asc", "desc"] | Omit = omit,
         status: Literal["active", "deleted", "all"] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -249,7 +249,8 @@ def list(
           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_by: Field to sort API keys by. Keys with no expiry or no recorded use sort last for
+              expires_at and last_used_at in either direction.
 
           sort_direction: Sort direction for API keys.
 
@@ -578,7 +579,7 @@ def list(
         name: str | Omit = omit,
         offset: int | Omit = omit,
         query: str | Omit = omit,
-        sort_by: Literal["created_at", "name", "expires_at"] | Omit = omit,
+        sort_by: Literal["created_at", "name", "expires_at", "last_used_at"] | Omit = omit,
         sort_direction: Literal["asc", "desc"] | Omit = omit,
         status: Literal["active", "deleted", "all"] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -608,7 +609,8 @@ def list(
           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_by: Field to sort API keys by. Keys with no expiry or no recorded use sort last for
+              expires_at and last_used_at in either direction.
 
           sort_direction: Sort direction for API keys.
 

src/kernel/types/api_key_list_params.py

@@ -36,8 +36,12 @@ class APIKeyListParams(TypedDict, total=False):
     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_by: Literal["created_at", "name", "expires_at", "last_used_at"]
+    """Field to sort API keys by.
+
+    Keys with no expiry or no recorded use sort last for expires_at and last_used_at
+    in either direction.
+    """
 
     sort_direction: Literal["asc", "desc"]
     """Sort direction for API keys."""