readme update and changes to the api