refactored api documentation