inctructor api functions