moved convenience functions into API, sorry @derek