add API's for two new functions