feat(suspension/REST): Provide some docs update updating the suspension state

related to CAM-1462