fix endpoint in Readme, clean up spec