chore(REST): add docs about REST API extensions

related to CAM-2190, CAM-2191, CAM-2195