minor updates to new api functions