api update and documentation