SOC-3417 REST API documentation - Quick improvements