update to new api
usage improvements. new api.
new helper methods