updated API documentation about pause/resume