update API contract on knn