updated API functions documentation