this needs to be public
doc fix
added a new API