some api improvements
updates