fix(rest): correct incosistencies in docs

closes CAM-845