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

[jenkins-infra-bot]

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.

[anushkasingh-commits]

Hi! I would like to work on this issue.
I’m happy to update the documentation to clarify the requirement for the explicit "pollSCM" trigger when using the "notifyCommit" API.

Please let me know if there are specific places in the docs where you’d prefer this to be added.