diff --git a/ui/litellm-dashboard/src/components/VirtualKeysPage/VirtualKeysTable.test.tsx b/ui/litellm-dashboard/src/components/VirtualKeysPage/VirtualKeysTable.test.tsx
index d09ccbf8826..bd431974197 100644
--- a/ui/litellm-dashboard/src/components/VirtualKeysPage/VirtualKeysTable.test.tsx
+++ b/ui/litellm-dashboard/src/components/VirtualKeysPage/VirtualKeysTable.test.tsx
@@ -505,6 +505,24 @@ describe("server-side filtering – the LIT-4080 regression guard", () => {
});
});
+ it("threads an applied Key Alias filter into the useKeys query as selectedKeyAlias", async () => {
+ renderWithProviders();
+
+ openFilters();
+
+ const aliasInput = await screen.findByPlaceholderText(/Enter key alias/);
+ fireEvent.change(aliasInput, { target: { value: "claude-code-mub" } });
+ fireEvent.click(screen.getByTestId("filter-drawer-apply"));
+
+ await waitFor(() => {
+ expect(mockUseKeys).toHaveBeenLastCalledWith(
+ 1,
+ 50,
+ expect.objectContaining({ selectedKeyAlias: "claude-code-mub" }),
+ );
+ });
+ });
+
it("does not send filter params to useKeys when no filter is active", () => {
renderWithProviders();
diff --git a/ui/litellm-dashboard/src/components/VirtualKeysPage/VirtualKeysTable.tsx b/ui/litellm-dashboard/src/components/VirtualKeysPage/VirtualKeysTable.tsx
index 7dd25ca1fd0..d917272ed52 100644
--- a/ui/litellm-dashboard/src/components/VirtualKeysPage/VirtualKeysTable.tsx
+++ b/ui/litellm-dashboard/src/components/VirtualKeysPage/VirtualKeysTable.tsx
@@ -40,6 +40,7 @@ const FILTER_LABELS: Record = {
team_id: "Team",
org_id: "Organization",
user_id: "User ID",
+ key_alias: "Key Alias",
key_hash: "Key ID",
};
@@ -71,7 +72,7 @@ export function VirtualKeysTable({ headerActions }: VirtualKeysTableProps) {
const keyListOptions = {
teamID: getFilterValue("team_id"),
organizationID: getFilterValue("org_id"),
- selectedKeyAlias: searchQuery.trim() || undefined,
+ selectedKeyAlias: getFilterValue("key_alias") || searchQuery.trim() || undefined,
userID: getFilterValue("user_id"),
keyHash: getFilterValue("key_hash"),
sortBy,
@@ -258,6 +259,13 @@ export function VirtualKeysTable({ headerActions }: VirtualKeysTableProps) {
placeholder="Enter User ID…"
/>
+
+ set("key_alias", event.target.value)}
+ placeholder="Enter key alias…"
+ />
+