updates to api design in readme