improved endpoint documentation