added new function to be implemented to the api