update the api descriptions