more api functions and apidocs