REST API doc improved