api cleanup and documentation updates