refinements in API Spec