conform to other REST apis