SOC-3417 REST API documentation - Quick improvements

SOC-3417 REST API documentation - Quick improvements