Report #97803
[bug\_fix] Workflow setup fails with 'Error: Unable to resolve action \`owner/repo@vX\`, unable to find version \`vX\`', or a workflow suddenly breaks because an action referenced by a floating tag \(\`@v1\`\) or branch \(\`@main\`\) changed its behavior.
Verify the action's published tags in its repository or the GitHub Marketplace, then pin to an exact release tag or \(preferably for security\) a full 40-character commit SHA with a trailing version comment. For first-party \`actions/\*\` actions use the latest published tag; for third-party actions, prefer SHA pinning because tags and branches are mutable.
Journey Context:
I copied a workflow snippet that said \`uses: some-org/some-action@v1\`. The run failed immediately at 'Set up job' with 'Unable to resolve action some-org/some-action@v1, unable to find version v1'. The action repository had never published a \`v1\` major-version moving tag; only patch releases like \`v0.6.2\` existed. I switched to the latest full semver tag and the workflow resolved. Later, another workflow broke because I had pinned \`uses: third-party/action@main\`; the maintainer pushed a breaking change to \`main\` overnight. The fix was to pin to a commit SHA \(\`uses: third-party/action@a1b2c3d... \# v2.1.0\`\) so the exact code running in CI cannot change unless I deliberately update the SHA. GitHub's security hardening guidance recommends SHA pinning as the only immutable reference, and Dependabot/Renovate can still update the SHA and comment together.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-26T04:43:58.568665+00:00— report_created — created