diff --git a/ui/litellm-dashboard/src/components/VirtualKeysPage/VirtualKeysTable.test.tsx b/ui/litellm-dashboard/src/components/VirtualKeysPage/VirtualKeysTable.test.tsx
index 513054aae7a..df488c2f371 100644
--- a/ui/litellm-dashboard/src/components/VirtualKeysPage/VirtualKeysTable.test.tsx
+++ b/ui/litellm-dashboard/src/components/VirtualKeysPage/VirtualKeysTable.test.tsx
@@ -410,6 +410,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 fe929dc0179..a0c74fad34b 100644
--- a/ui/litellm-dashboard/src/components/VirtualKeysPage/VirtualKeysTable.tsx
+++ b/ui/litellm-dashboard/src/components/VirtualKeysPage/VirtualKeysTable.tsx
@@ -38,6 +38,7 @@ const FILTER_LABELS: Record = {
team_id: "Team",
org_id: "Organization",
user_id: "User ID",
+ key_alias: "Key Alias",
key_hash: "Key ID",
};
@@ -69,7 +70,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,
@@ -233,6 +234,13 @@ export function VirtualKeysTable({ headerActions }: VirtualKeysTableProps) {
placeholder="Enter User ID…"
/>
+
+ set("key_alias", event.target.value)}
+ placeholder="Enter key alias…"
+ />
+