refactored endpoint description