updates to the api documentation