docs update & extension of Update api