feat(api): add filter by key support to list-customers operation (#3694)

Author: gergely-kurucz-konghq

api/spec/src/v3/customers/operations.tsp

@@ -13,6 +13,18 @@ using TypeSpec.OpenAPI;
 
 namespace Customers;
 
+/**
+ * Filter options for listing customers.
+ */
+@friendlyName("ListCustomersParamsFilter")
+model ListCustomersParamsFilter {
+  /**
+   * Filter customers by key.
+   * Case-insensitive partial match.
+   */
+  key?: Shared.ExternalResourceKey;
+}
+
 /**
  * Query params for listing customers.
  */
@@ -32,6 +44,14 @@ model ListCustomersParams {
    */
   @query(#{ name: "sort" })
   sort?: Common.SortQuery;
+
+  /**
+   * Filter customers returned in the response.
+   *
+   * To filter customers by key add the following query param: filter[key]=my-db-id
+   */
+  @query(#{ style: "deepObject", explode: true })
+  filter?: ListCustomersParamsFilter;
 }
 
 interface CustomersOperations {