added new api functions