api functions update