more api spec work