chore(rest): update docs according to new exception handling

contributes to CAM-733, CAM-694