more api refinements