update readme with new api spec