updates to API in README