updates to api - new functions added, documentation updated