make $trigger_id optional - update documentation in comments