add api specs for valid value calls