[JENKINS-75865] Document requirement of explicit pollSCM step when using git-plugin notifyCommit API

The git-plugin exposes a notifyCommit endpoint which can be used to trigger Jenkins jobs from external systems when commits are pushed to a git repository. This requires the pollSCM trigger to be setup on the job.

I can't find the ability to setup the poll SCM trigger on the organization folder. The option exists on the grandchild job (the workflow job of the multi-branch pipeline job) but is unselected and read only.

After spending time digging through code and documentation I found I can explicitly setup the trigger in the declarative Jenkinsfile pipeline:

triggers {

    pollSCM("")

}

This could be documented somewhere and perhaps added to the UI.

---
Originally reported by mrichar2, imported from: Document requirement of explicit pollSCM step when using git-plugin notifyCommit API

• status: Open
  
• priority: Minor
  
• component(s): cloudbees-folder-plugin
  
• resolution: Unresolved
  
• votes: 0
  
• watchers: 1
  
• imported: 20251211-141027
  

Raw content of original issue

The git-plugin exposes a notifyCommit endpoint which can be used to trigger Jenkins jobs from external systems when commits are pushed to a git repository. This requires the pollSCM trigger to be setup on the job.


I can't find the ability to setup the poll SCM trigger on the organization folder. The option exists on the grandchild job (the workflow job of the multi-branch pipeline job) but is unselected and read only.


After spending time digging through code and documentation I found I can explicitly setup the trigger in the declarative Jenkinsfile pipeline:




triggers {

    pollSCM("")

}





This could be documented somewhere and perhaps added to the UI.