small changes to top level api