improve api reference