updates to the api documentatio