rest interface documented